PostgreSQL的jarowinkler函数在pgAdmin可用但Spring JDBC调用报错

排查与解决步骤 #

1. 确认函数的Schema搜索路径 #

pg_similarity扩展可能安装在非默认Schema下，pgAdmin的会话可能已包含该Schema的搜索路径，但Spring JDBC的连接会话未配置：

• 直接在调用时指定Schema前缀，例如：SELECT pg_similarity.jarowinkler('text1', 'text2')（替换为实际安装的Schema名）；
• 或在JDBC连接URL中添加搜索路径配置：jdbc:postgresql://host:port/dbname?currentSchema=public,pg_similarity；
• 也可在连接初始化时执行SQL：SET search_path TO public, pg_similarity;

2. 检查JDBC连接用户的权限 #

确保Spring JDBC使用的数据库用户拥有函数访问权限：

-- 授予Schema使用权限
GRANT USAGE ON SCHEMA pg_similarity TO your_jdbc_username;
-- 授予函数执行权限
GRANT EXECUTE ON FUNCTION jarowinkler(text, text) TO your_jdbc_username;

3. 匹配函数参数类型 #

确认调用时传入的参数类型与jarowinkler(text, text)的签名完全匹配，必要时显式转换类型：

String sql = "SELECT jarowinkler(CAST(? AS text), CAST(? AS text))";
Double similarity = jdbcTemplate.queryForObject(sql, Double.class, "input1", "input2");

4. 验证扩展的安装状态 #

确认Spring JDBC连接的目标数据库中已正确安装pg_similarity：

SELECT extname FROM pg_extension WHERE extname = 'pg_similarity';

若查询无结果，需使用超级用户执行：CREATE EXTENSION pg_similarity;

5. 尝试升级JDBC驱动 #

虽然当前驱动版本兼容PostgreSQL 14，但可尝试升级至最新兼容版本（如42.5.x系列），避免驱动对函数解析的潜在问题。

内容的提问来源于stack exchange，提问作者SME