Spring Boot仓库@Query绑定数值参数调用Oracle函数报错

问题场景 #

硬编码参数调用Oracle SQL Macro函数可正常运行：

@Query(value = "SELECT * FROM RECHUMANO.M_PERSONAS_LIQUIDACION_DOMINIO_ROL_USUARIO(559, 97, 49, '%GILBER%') WHERE 1=1", nativeQuery = true)
List<Object[]> callFunction();

但改用动态参数绑定后，数值参数触发报错，字符串参数可正常工作：

@Query(value = "SELECT * FROM RECHUMANO.M_PERSONAS_LIQUIDACION_DOMINIO_ROL_USUARIO(?1, ?2, ?3, ?4) WHERE 1=1", nativeQuery = true)
List<MyEntity> callFunction(int param1, int param2, int param3, String param4);

服务层调用代码：

repository.callFunction(559, 97, 49, "%GILBER%");

涉及的Oracle SQL Macro函数定义片段：

CREATE OR REPLACE FUNCTION RECHUMANO.M_PERSONAS_LIQUIDACION_DOMINIO_ROL_USUARIO (
    PID_LIQUIDACION NUMBER DEFAULT 559,
    PID_USUARIO NUMBER,
    PID_ROL NUMBER,
    PSUGGESTION VARCHAR2
) RETURN CLOB SQL_MACRO AS

    V_CONTROL_TOTAL NUMBER;
    V_TIPO_NOMINA NUMBER;

BEGIN
    -- 函数内部逻辑省略

可能原因及解决方案 #

1. 显式强制参数类型转换 #

SQL Macro对参数类型敏感度较高，Spring Data默认的int参数绑定可能未正确转换为Oracle的NUMBER类型，可通过CAST转换或命名参数解决：

@Query(value = "SELECT * FROM RECHUMANO.M_PERSONAS_LIQUIDACION_DOMINIO_ROL_USUARIO(CAST(:param1 AS NUMBER), CAST(:param2 AS NUMBER), CAST(:param3 AS NUMBER), :param4) WHERE 1=1", nativeQuery = true)
List<MyEntity> callFunction(
    @Param("param1") int param1,
    @Param("param2") int param2,
    @Param("param3") int param3,
    @Param("param4") String param4
);

2. 用EntityManager手动指定参数类型 #

绕过Spring Data的自动绑定机制，直接通过EntityManager显式指定Oracle参数类型，避免转换异常：

@Service
public class YourService {
    @Autowired
    private EntityManager em;

    @SuppressWarnings("unchecked")
    public List<MyEntity> callFunction(int param1, int param2, int param3, String param4) {
        String sql = "SELECT * FROM RECHUMANO.M_PERSONAS_LIQUIDACION_DOMINIO_ROL_USUARIO(?1, ?2, ?3, ?4)";
        Query query = em.createNativeQuery(sql, MyEntity.class);
        // 显式指定数值参数类型为Oracle NUMBER
        query.setParameter(1, param1, OracleTypes.NUMBER);
        query.setParameter(2, param2, OracleTypes.NUMBER);
        query.setParameter(3, param3, OracleTypes.NUMBER);
        query.setParameter(4, param4);
        return query.getResultList();
    }
}

注意：需导入oracle.jdbc.OracleTypes依赖。

3. 检查返回实体类映射 #

从List<Object[]>改为List<MyEntity>后，若实体类字段与函数返回的列名、类型不匹配也会触发报错：

• 确保实体类字段名与函数返回结果列名一致，可通过@Column(name = "COLUMN_NAME")指定映射关系
• 验证字段类型与Oracle返回类型匹配（如Number对应Integer/Long，Varchar对应String等）

4. 测试参数传递时机兼容性 #

SQL Macro在SQL编译阶段展开，动态参数绑定可能存在时机冲突，可临时将数值参数转为字符串传入（仅测试用，生产环境禁止直接拼接避免SQL注入）：

@Query(value = "SELECT * FROM RECHUMANO.M_PERSONAS_LIQUIDACION_DOMINIO_ROL_USUARIO(:param1, :param2, :param3, :param4) WHERE 1=1", nativeQuery = true)
List<MyEntity> callFunction(
    @Param("param1") String param1,
    @Param("param2") String param2,
    @Param("param3") String param3,
    @Param("param4") String param4
);

调用时传入字符串形式的数值：repository.callFunction("559", "97", "49", "%GILBER%");

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