Spring Boot 3.0升级至3.2后Oracle数据库实体插入失败求助

核心解决方案 #

1. 明确指定Oracle12c+对应的Hibernate方言 #

虽然Spring Boot 3.2文档提示使用OracleDialect，但对于支持自增列的Oracle 12c及以上版本，仍需指定Oracle12cDialect来正确处理IDENTITY主键生成策略。修改配置文件：

spring.jpa.database-platform=org.hibernate.dialect.Oracle12cDialect

注：Hibernate 6.x版本仍保留该方言，并非完全移除，只是Spring Boot的默认推荐有所调整。

2. 验证数据库列的自增配置 #

确保你的USER_CHNG_LOG_KEY列是Oracle 12c+的自增列，DDL定义应类似：

CREATE TABLE S1.T1 (
    USER_CHNG_LOG_KEY NUMBER GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
    -- 其他列定义
);

如果列不是用GENERATED AS IDENTITY定义的，IDENTITY策略会失效，导致Hibernate无法获取自增值，进而引发空指针异常。

3. 强制启用Hibernate新生成器映射（可选） #

如果上述配置仍有问题，添加以下Hibernate属性，确保主键生成逻辑正确适配新版本：

spring.jpa.properties.hibernate.id.new_generator_mappings=true

问题原因分析 #

Spring Boot 3.2对应的Hibernate 6.x对Oracle方言的处理做了调整：

• 通用OracleDialect默认不启用对IDENTITY策略的支持，因为该策略仅在Oracle 12c及以上版本可用
• 老版本的Oracle12cDialect专门适配了12c+的自增列特性，升级后如果直接替换为OracleDialect，Hibernate无法正确识别自增列，导致在获取生成的主键时出现空指针。

已尝试方案的补充说明 #

• 手动设置ID虽然可行，但违背了自增主键的设计初衷，不推荐长期使用
• 仅指定OracleDialect无法触发对自增列的正确处理，这是导致报错的直接原因

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