Spring Boot JPA连接SQL Server 2022报无效列名错误排查求助

1. 核对实体类与数据库列的映射关系 #

• 确认实体类中对应字段的@Column注解是否精准匹配数据库列名：
  • 比如对应数据库id_news列的实体字段，必须明确标注@Column(name = "id_news")；如果实体字段是驼峰命名（如idNews），而未指定列名，JPA默认命名策略可能会自动转换为下划线格式，但如果数据库列名规则和转换结果不匹配，就会报错。
  • 同理ExpiryDate列，实体类字段需通过@Column(name = "ExpiryDate")明确绑定，避免JPA自动生成的列名与数据库实际列名（混合大小写）不匹配。
• 检查JPA命名策略配置，在application.properties或application.yml中：

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

  该策略会严格遵循@Column指定的列名，不会自动转换格式，适合数据库列名非下划线规则的场景。

2. 排查SQL Server列名大小写敏感性 #

• SQL Server默认不区分大小写，但如果数据库采用区分大小写的排序规则（如SQL_Latin1_General_CP1_CS_AS），则JDBC生成的SQL列名必须与数据库列名大小写完全一致。
• 你在SSMS中执行SQL时工具会自动兼容大小写，但JDBC驱动发送的请求会严格匹配，一旦大小写不符就触发报错。解决方式：要么修改实体类@Column的列名与数据库完全一致，要么调整数据库排序规则为不区分大小写（操作前需备份数据）。

3. 检查JDBC连接参数 #

• 确认JDBC URL是否包含影响列名解析的参数，比如sendStringParametersAsUnicode、useUnicode等，这些参数可能干扰驱动对列名的识别。
• 确保URL中指定了正确的数据库名，避免连接到其他同名但表结构不同的库，示例：

  jdbc:sqlserver://localhost:1433;databaseName=你的数据库名;trustServerCertificate=true;
  

4. 开启Hibernate SQL生成日志验证 #

• 开启日志确认生成的SQL与Profiler捕获内容完全一致，避免存在隐藏差异：

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

  日志会输出完整的SQL语句，可对比是否存在特殊字符或格式差异。

5. 检查数据库列名是否含隐藏字符 #

• 部分情况下数据库列名可能包含空格、不可见字符（如换行、制表符），导致视觉上与JDBC生成的列名一致，但实际不匹配。
• 在SSMS中执行sp_columns News，查看列名的实际存储值，与JDBC生成的列名逐一比对。

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