// PostgreSQL 错误参考

PostgreSQL 42846:无法强制转换类型

两种未定义相互转换的类型之间的显式转换,例如 integer 转 uuid 或 boolean 转 date。

SQLSTATE
42846
名称
cannot_coerce
类别
语法错误或访问规则违规
错误信息
cannot cast type integer to uuid

它的意思

PostgreSQL 只在两个类型之间定义了转换(cast)时才进行转换。42846 (cannot_coerce)表示你要求的是带 ::type 或者 CAST 但找不到现成的,因此无论值里是什么,PostgreSQL 都无法转换该值。

这与 22P02 不同——后者存在类型转换,只是该文本值本身无效。通常的解决办法是经由 text 中转,或使用能正确构造目标类型的函数。

常见原因

  • 在不相关类型之间强制转换,例如 integer 到 uuid, boolean 到 date 或者 jsonb 到 integer[].
  • 将复合类型或数组值转换为标量类型。
  • 从允许转换的其他数据库移植的代码。

如何修复它

  1. 当文本形式是目标类型的有效输入时,通过文本进行转换。

    SELECT 42::text::numeric;
    SELECT ('{"n": 7}'::jsonb ->> 'n')::int;
  2. 使用构建目标类型的转换函数。

    SELECT to_timestamp(1700000000);
    SELECT ARRAY(SELECT jsonb_array_elements_text('[1,2,3]'::jsonb)::int);
  3. 列出某个类型实际存在的转换。

    SELECT castsource::regtype, casttarget::regtype, castcontext
    FROM pg_cast WHERE castsource = 'integer'::regtype;

安全地复现它

SELECT 1::uuid;  -- ERROR: cannot cast type integer to uuid

相关错误

更多语法错误或访问规则违例错误

代码和消息文本来自 PostgreSQL 文档,附录 A:PostgreSQL 错误代码。浏览完整的 PostgreSQL 错误列表 或者 搜索每个数据库错误.

// 错误更少,修复更快

在 SQLly 中使用 PostgreSQL

适用于 macOS、Windows 和 Linux 的原生 SQL 客户端,智能感知能理解你的数据库模式,高危语句有防护,错误信息清晰,支持 PostgreSQL 以及你使用的其他数据库。