// PostgreSQL 错误参考

PostgreSQL 42883:函数不存在

没有名称和参数类型都匹配的函数或运算符。通常是缺少类型转换、缺少扩展,或函数位于其他模式中。

SQLSTATE
42883
名称
undefined_function
类别
语法错误或访问规则违规
错误信息
function lower(integer) does not exist
LINE 1: SELECT lower(42);
               ^
HINT:  No function matches the given name and argument types. You might need to add explicit type casts.

它的意思

PostgreSQL 根据函数的名称和参数类型选择函数。42883 表示在 search_path 接受你传入的类型,即使有隐式转换。相同的代码也适用于运算符,例如 operator does not exist: integer = text.

自 PostgreSQL 8.3 以来,大多数类型不再隐式转换为文本,因此为旧版本或其他数据库编写的代码常常会遇到这个问题。

常见原因

  • 参数类型不匹配:把整数传给了文本函数,或是在比较 integer = text.
  • 调用未安装在此数据库中的扩展中的函数(uuid_generate_v4(), crypt(), similarity()).
  • 该函数所在的模式并未包含在 search_path.
  • 调用另一个数据库中的函数,例如 MySQL 的 IFNULL 或者 DATE_FORMAT.
  • 来自驱动程序的未知类型参数:一个已绑定的 $1 其类型 PostgreSQL 无法推断。

如何修复它

  1. 将参数转换为函数所期望的类型。

    SELECT lower(42::text);
    SELECT * FROM orders WHERE id = '42'::int;
  2. 在此数据库中安装提供该函数的扩展。

    CREATE EXTENSION IF NOT EXISTS pgcrypto;
    SELECT gen_random_uuid();  -- built in since PostgreSQL 13
  3. 找到该函数及其参数类型,然后以模式限定名调用它。

    SELECT n.nspname, p.proname, pg_get_function_identity_arguments(p.oid)
    FROM pg_proc p JOIN pg_namespace n ON n.oid = p.pronamespace
    WHERE p.proname = 'my_func';
  4. 将其他数据库的函数替换为 PostgreSQL 的函数: IFNULL 变为 COALESCE, DATE_FORMAT 变为 to_char, NOW() 按原样工作。

安全地复现它

SELECT lower(42);  -- ERROR: function lower(integer) does not exist

相关错误

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

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

// 错误更少,修复更快

在 SQLly 中使用 PostgreSQL

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