Spring Data JPA升级至Spring Boot 3后的列名引号问题解析

问题现象

在将项目从Spring Boot 2升级到Spring Boot 3后，开发者遇到了一个关于列名引号的异常问题。具体表现为：当查询包含特殊字符（如$）的列名时，Hibernate生成的SQL语句会为列名添加引号，导致与数据库中的实际列名不匹配。例如，对于名为"ID$"的列，生成的SQL会变成select ... "id$"，而数据库中的实际列名是"ID$"，从而引发"Column not found"错误。

技术背景

这个问题涉及多个技术层面的变更：

1. Hibernate命名策略变更：从Hibernate 6.0.0.Beta2开始，对于包含特殊字符（如$）的列名会自动添加引号，这是为了确保SQL语句的正确性。

2. Spring Boot默认配置变化：Spring Boot 2.6.0开始默认使用CamelCaseToUnderscoresNamingStrategy物理命名策略，会将列名转换为小写形式。

3. 数据库引号处理机制：H2等数据库对引号内的标识符区分大小写，导致带引号的小写列名与数据库中的大写列名不匹配。

解决方案

针对这个问题，开发者可以考虑以下几种解决方案：

1. 修改实体类注解： 在@Column注解中明确指定带引号的列名：

   @Column(name = "\"ID$\"")
   private String id;
   

2. 调整命名策略： 在application.properties中配置使用标准物理命名策略：

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

3. 数据库脚本调整： 修改建表脚本，使用小写列名或统一大小写规范。

最佳实践建议

1. 在升级前评估命名策略的影响，特别是对于包含特殊字符的列名。
2. 考虑统一数据库对象的命名规范，避免使用特殊字符或混合大小写。
3. 对于新项目，建议从一开始就采用一致的命名策略。
4. 在升级过程中，可以使用Hibernate的show-sql选项检查生成的SQL语句是否符合预期。

总结

这个问题展示了框架升级时可能遇到的兼容性问题，特别是当多个组件的默认行为发生变化时。理解Hibernate和Spring Boot的命名策略机制对于解决这类问题至关重要。开发者在升级前应该充分测试数据库访问层，确保命名策略的变化不会影响现有功能。