Spring Boot 3.1.3+JPA+OJDBC查询Oracle数据返回空响应问题

• 实体类与数据库映射匹配检查

  • 字段名大小写：Oracle默认存储列名为大写，若实体类用驼峰命名（如alias），需通过@Column(name="ALIAS")明确指定对应数据库的大写列名，避免Hibernate自动转换后与实际列名不匹配。
  • 表名与Schema：确认实体类的@Table注解是否指定了正确的Schema和表名，例如@Table(name="EMPLOYEE", schema="ROOT")，Oracle表名默认也是大写，需与数据库中实际表名完全一致。
  • 序列关联验证：若使用emp_seq生成主键，需确保实体类的主键注解正确关联序列，示例：

    @Id
    @GeneratedValue(strategy = GenerationType.SEQUENCE, generator = "emp_seq_generator")
    @SequenceGenerator(name = "emp_seq_generator", sequenceName = "EMP_SEQ", schema = "ROOT", allocationSize = 1)
    private Long id;
    

• 数据库连接配置验证

  • 检查数据源URL是否指定了正确的Schema，例如jdbc:oracle:thin:@//localhost:1521/ORCLPDB1?currentSchema=ROOT；若使用ROOT用户登录，默认Schema应为ROOT，但仍需确认连接用户是否有查询root.employee表的权限。

• Hibernate命名策略检查

  • 若配置了Spring默认的物理命名策略，会将驼峰命名转为下划线小写（如alias转alias），但Oracle列名是大写ALIAS，会导致字段映射失败。可修改配置为严格匹配：

    spring.jpa.hibernate.naming.physical-strategy=org.hibernate.boot.model.naming.PhysicalNamingStrategyStandardImpl
    

• 直接执行日志SQL验证

  • 将日志中的查询语句select e1_0.id,e1_0.alias,e1_0.email,e1_0.name,e1_0.password from root.employee e1_0复制到SQL Developer中，使用与Spring Boot相同的数据库用户执行：
    • 若返回空：说明数据库中该用户视角下无数据，需检查数据归属的Schema或用户权限；
    • 若返回数据：则问题出在实体映射或Hibernate配置上。

• 实体类字段类型匹配检查

  • 确认实体类字段类型与数据库列类型完全匹配，例如数据库id为NUMBER(19)时，实体类需用Long而非Integer；字符串字段需对应VARCHAR2类型，避免因类型不匹配导致无法映射结果。

• Hibernate实体扫描范围检查

  • 确保@SpringBootApplication注解的scanBasePackages包含了Employee实体类所在的包，或实体类位于主启动类的子包下，否则Hibernate无法识别实体，导致查询结果无法映射为实体对象，最终返回空数组。

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