通过Hibernate执行数据库包报错求助：冒号被识别为参数占位符

我太懂这种头疼了——调用数据库包时，Hibernate总把SQL里的冒号当成参数占位符，哪怕加了双反斜杠转义也没用，确实挺闹心的。下面给你几个经过验证的解决方案，你可以根据自己的场景试试：

方案一：显式设置Hibernate的转义字符 #

Hibernate默认可能没启用反斜杠转义，所以你需要在创建原生查询时手动指定转义字符。注意Java字符串里要写双反斜杠才能表示一个实际的反斜杠：

// 比如调用Oracle包函数的SQL，Java字符串里用\\:转义冒号
String sql = "SELECT my_package\\:my_function() FROM dual";
NativeQuery<?> query = session.createSQLQuery(sql);
// 关键：告诉Hibernate用反斜杠作为转义字符
query.setEscapeCharacter('\\');
List<?> result = query.list();

方案二：改用数据库原生替代语法 #

如果你的数据库支持，换一种不用冒号的写法绕过Hibernate的解析：

• 比如PostgreSQL里的类型转换，把column::varchar换成CAST(column AS varchar)；
• 调用存储过程时，部分数据库支持CALL语句的简化写法，避开冒号冲突。

方案三：用@NamedNativeQuery指定转义字符 #

如果是用注解定义查询，可以直接在注解里配置转义字符，不用每次在代码里重复设置：

@NamedNativeQuery(
    name = "CallPackageFunction",
    // 注解里的SQL只需要单反斜杠转义冒号
    query = "SELECT my_package\:my_function() FROM dual",
    resultClass = YourResultEntity.class,
    escapeCharacter = '\\'
)

方案四：绕过Hibernate，直接用JDBC执行 #

如果以上方法都不生效，那就直接拿到JDBC连接执行原生SQL，完全避开Hibernate的参数解析逻辑：

String sql = "SELECT my_package:my_function() FROM dual"; // 这里直接写原生冒号
// 从Hibernate Session获取JDBC连接
Connection conn = session.doReturningWork(connection -> connection);
PreparedStatement pstmt = conn.prepareStatement(sql);
ResultSet rs = pstmt.executeQuery();
// 处理结果集逻辑...
rs.close();
pstmt.close();

为什么双反斜杠转义没生效？ #

大概率是因为你没显式设置Hibernate的转义字符——默认情况下Hibernate不会把反斜杠当成转义标记，所以即便你加了\\:，它还是会把冒号当成参数占位符。只要加上setEscapeCharacter('\\')这行，转义就能正常工作了。

内容的提问来源于stack exchange，提问作者Gustavo de Freitas