Spring Boot登录遇SQL语法错误：可保存用户但登录失败

• 核对查询语句与实体/数据库的映射一致性
  不管是JPQL还是原生查询，先确认：

  • JPQL中实体类名、属性名是否和代码完全一致（JPQL对实体类名大小写敏感）；
  • 原生查询中表名、字段名是否和数据库实际结构匹配（注意Spring Data JPA默认会把驼峰属性转下划线字段，比如userName对应user_name）。
    例：如果Repository里写了@Query("select u from User u where u.userName = ?1")，要确认实体类属性是userName而非username，数据库字段是user_name而非username。

• 打印实际执行的SQL语句
  开启SQL日志直接看生成的语句，复制到MySQL客户端执行就能快速定位错误：
  Spring Boot可添加以下配置：

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

  重点看错误提示里near 'xxx'的位置，比如多写的逗号、遗漏的括号、错误的关键字引用。

• 排查关键字冲突
  若表名或字段名使用了MySQL保留关键字（如user、order），必须用反引号包裹：

  • 原生查询：select * from userwherepassword = ?
  • 实体类注解：@Column(name = "password")

• 匹配MySQL版本语法
  不同版本MySQL对语法支持有差异，比如MySQL 8.0新增的窗口函数、CTE语法，若查询用了高版本特性但数据库是低版本，会直接触发语法错误。对照你的MySQL版本手册，检查查询中是否有不兼容的写法。

• 检查Spring Data JPA方法命名规则
  若用方法命名查询（如findByUsernameAndPassword），要确保方法名中的属性名和实体类完全匹配，比如实体类属性是passWord，方法名写成findByPassword会导致JPA生成错误的SQL字段名。

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