Spring Data JPA调用Oracle流水线函数返回空/异常问题排查

Oracle数据库定义 #

type T_Sk is record
(
  code Integer,
  dat Date,
  ...
);
type TBL_Sk is table of T_Sk;
function FN_Sk(ADetId in Integer, ATrudoForFac in Integer, ATrudoForCex in Integer) return TBL_Sk pipelined;

数据库中正常查询示例 #

select t.* from table(PK_DISP.FN_Sk(ADetId, ATrudoForFac, ATrudoForCex)) t 

Spring Data JPA实现代码 #

Repository层代码 #

@Query(nativeQuery = true, value = "select * from (PK_DISP.FN_Sk(:detid, :factory, :cexnum))")
List<Spares> findAllByRequest(@Param("detid") int detid, @Param("factory") int factory, @Param("cexnum") int cexnum);

Controller层接口代码 #

@GetMapping("/get")
public List<Spares> getAll2(@RequestParam(value = "detid") int detid,
         @RequestParam(value = "factory") int factory, @RequestParam(value = "cexnum") int cexnum){
    return sparesRepository.findAllByRequest(detid, factory, cexnum);
}

问题现象 #

• 调用接口返回空响应，但直接在数据库执行函数能得到正确数据
• 部分detid参数值会触发SQLException
• 疑问：是否应该用@ResponseHeader替代@RequestParam？

问题排查与解决建议 #

1. 修复原生查询语法错误 #

你当前的查询语句存在语法问题：Oracle调用流水线函数必须用table()包裹，不能额外加括号包裹函数调用。正确的查询语句应该和数据库中的执行示例一致：

select * from table(PK_DISP.FN_Sk(:detid, :factory, :cexnum))

错误的括号包裹会导致SQL解析异常，这是部分参数触发SQLException的直接原因，也可能导致空响应。

2. 校验实体类字段映射 #

确认Spares实体类与Oracle返回的T_Sk记录字段完全匹配：

• 字段名称：注意Oracle默认大小写规则，若数据库字段为大写，实体类需通过@Column(name = "CODE")指定对应名称
• 数据类型：比如dat字段对应Date类型，实体类需用java.util.Date或java.time.LocalDate，确保JPA能正确完成类型转换
• 若函数返回的记录有省略字段...，需保证实体类包含所有返回字段，或通过@SqlResultSetMapping手动定义字段映射规则

3. 检查参数类型与范围 #

Oracle的Integer是32位类型，范围为-2147483648到2147483647，若传入的detid值超出该范围，会触发SQLException。需确认参数值是否符合类型要求。

4. @RequestParam的使用无需替换 #

@ResponseHeader用于设置响应头，和接收请求参数无关，你当前用@RequestParam接收URL参数的方式是正确的，不需要替换。

5. 开启SQL日志定位问题 #

在application.properties中添加配置，开启JPA SQL日志，查看实际执行的SQL语句和参数值，对比数据库手动执行的语句，确认参数是否正确传递：

spring.jpa.show-sql=true
spring.jpa.properties.hibernate.format_sql=true

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