Spring Boot3升级后Hibernate6.1.x表名拼接错误致ORA-00942

原因分析 #

Hibernate 6.x对标识符（表名、列名）的引号策略做了调整，当表名包含特殊字符（比如@）时，会自动给整个表名加上双引号。但Oracle中PROD_INST@HUIJK里的@是用来标识数据库链接（DBLink）的，加引号后Oracle会把"PROD_INST@HUIJK"当成完整的表名，而不是PROD_INST表加上HUIJK这个DBLink，所以会报表不存在的错误。

解决方案 #

方案1：修改@Table注解，拆分DBLink到catalog属性 #

Hibernate 6.x支持通过catalog属性指定DBLink，这样生成SQL时会正确拆分表名和DBLink，不会给整个字符串加引号：

@Table(schema = "CUST_CENTER", name = "PROD_INST", catalog = "HUIJK")

这样Hibernate生成的SQL会是CUST_CENTER.PROD_INST@HUIJK，不带多余引号，符合Oracle的语法要求。

方案2：配置全局标识符引号策略，排除DBLink场景 #

在application.properties或application.yml中配置Hibernate的标识符引号策略，让它不对包含@的表名加引号：

# application.properties
hibernate.globally_quoted_identifiers=false
hibernate.identifier.quoting_strategy=org.hibernate.engine.jdbc.env.internal.LegacyOracleQuotingStrategy

或者yaml格式：

# application.yml
hibernate:
  globally_quoted_identifiers: false
  identifier:
    quoting_strategy: org.hibernate.engine.jdbc.env.internal.LegacyOracleQuotingStrategy

LegacyOracleQuotingStrategy是Hibernate针对Oracle的旧版引号策略，会按照Oracle的规则处理特殊字符，不会对包含@的表名整体加引号。

方案3：使用@Formula手动指定表引用（临时应急） #

如果上述方案都不适用，可以在实体类的@Entity注解后，用@Formula指定完整的表引用（不推荐长期使用，仅临时过渡）：

@Entity
@Formula("CUST_CENTER.PROD_INST@HUIJK")
public class ProdInst {
    // 实体字段
}

这种方式会直接使用你指定的字符串作为表名，绕过Hibernate的标识符处理逻辑。

验证方法 #

修改完成后，启动应用查看Hibernate生成的SQL，确认表名部分没有被添加双引号，格式为CUST_CENTER.PROD_INST@HUIJK，此时执行SQL应该能正常访问表。

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