Spring Boot执行SQL报错但SSMS运行正常，求排查原因

1. 实体类与数据库映射不匹配 #

• 列名/表名大小写或引号问题：SQL Server默认不区分大小写，但Hibernate若未开启hibernate.globally_quoted_identifiers=true，当实体类注解名称（如@Column(name = "ArticoloID")）与数据库实际名称（如小写articoloid）存在大小写差异时，可能触发语法错误；若表/列名含特殊字符（如空格），未加引号也会报错。
• 字段类型不匹配：实体类字段类型与数据库列类型不兼容，比如用Integer对应数据库BigInt，或日期类型映射错误（如LocalDate对应datetime未加注解），JDBC驱动处理时会解析失败，尽管SSMS能隐式转换。
• 映射字段遗漏/冗余：SQL查询了实体类未映射的字段，或实体类映射了数据库不存在的字段，会导致Hibernate解析ResultSet时出错。

2. Hibernate SQL解析逻辑问题 #

• 未指定原生SQL标识：如果DAO层用@Query写了原生SQL，但未加nativeQuery = true，Hibernate会将其当作HQL解析，比如HQL不支持SELECT *语法，必然报语法错误。
• 参数绑定错误：占位符顺序或命名参数不匹配，比如@Query(value = "SELECT * FROM Articolo WHERE Codice = ?", nativeQuery = true)但传参顺序错误，或命名参数未加:前缀（如@Param("catId")对应:catId）。
• 方言配置错误：spring.jpa.properties.hibernate.dialect配置有误，比如用MySQL方言连接SQL Server，Hibernate会生成不符合SQL Server规范的SQL，即便你写了原生SQL，方言可能做额外修改。

3. JDBC连接与驱动问题 #

• JDBC URL配置错误：URL中数据库名称、实例名或端口错误，比如jdbc:sqlserver://localhost:1433;databaseName=WrongDB，导致应用连接的数据库与SSMS不一致，自然找不到表。
• 驱动版本不兼容：使用的SQL Server JDBC驱动版本过低，不支持你SQL中用到的新特性（如窗口函数、JSON函数），SSMS能执行但驱动解析失败。

4. DAO层代码排查要点 #

以典型DAO代码为例：

@Repository
public interface ArticoloRepository extends JpaRepository<Articolo, Long> {
    @Query(value = "SELECT a.* FROM Articolo a WHERE a.CategoriaID = :catId", nativeQuery = true)
    List<Articolo> findByCategoriaId(@Param("catId") Long catId);
}

需检查：

• 是否添加nativeQuery = true（原生SQL场景）
• 命名参数:catId是否与@Param("catId")完全对应
• 查询的字段是否全部在Articolo实体类中有对应映射

5. 关键排查步骤 #

• 开启Hibernate日志：在application.properties中添加

  logging.level.org.hibernate.SQL=DEBUG
  logging.level.org.hibernate.type.descriptor.sql.BasicBinder=TRACE
  

  查看应用实际执行的SQL和参数值，与SSMS中运行的SQL对比，确认是否存在差异。
• 核对实体类注解：检查@Table(name = "xxx")、@Column(name = "xxx")是否与数据库表结构完全一致，包括主键@Id的映射。
• 确认方言配置：使用对应SQL Server版本的方言，比如SQL Server 2016+用org.hibernate.dialect.SQLServer2016Dialect。
• 验证JDBC驱动：确保驱动版本与SQL Server版本匹配（如SQL Server 2019推荐用mssql-jdbc 9.4+）。

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