使用Gradle构建SpringBoot数据库API时查询遇MySQL语法错误求助

从你给出的错误信息来看，核心问题是Hibernate生成的SQL找不到对应的数据库列——日志里的com.mysql.jdbc.exceptions.jdbc4.MySQLSyntaxErrorException: Unknown column 'city0_.country_code' in 'field list'已经很明确：Hibernate在查询city表时，试图获取country_code列，但你的数据库表中要么没有这个列，要么实体类和表的映射关系出了问题。

下面是具体的排查和解决步骤：

• 检查实体类与数据库表的字段映射
  先看你的City实体类（从错误里的city0_推断实体类是City），对应country_code的字段有没有正确配置：

  • 如果数据库表的列名是country_code，实体类里的字段如果是驼峰式的countryCode，需要确保@Column注解指定了正确的列名，比如：

    @Entity
    @Table(name = "city")
    public class City {
        // 其他字段...
        @Column(name = "country_code") // 这里必须和数据库列名完全一致
        private String countryCode;
        
        // getter、setter方法...
    }
    

  • 如果你没加@Column注解，要检查Spring Boot的命名策略配置。默认情况下Spring Boot会把驼峰式字段转成下划线列名，但如果配置被修改过，可能导致映射错误。可以在application.properties里明确配置：

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

    这个配置会自动将实体类的驼峰字段转换为数据库的下划线列名。

• 确认数据库表的实际结构
  直接登录你的MySQL数据库，执行DESCRIBE city;命令，查看city表的列名：

  • 可能是你创建表时拼写错误，比如写成了countrycode或者countryCd；
  • 也有可能你连错了数据库实例，查询的表不是你预期的那个。

• 开启SQL日志查看实际执行语句（可选但高效）
  在application.properties里添加以下配置，让Hibernate打印出生成的SQL语句：

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

  这样你就能在IDEA的日志里看到完整的查询SQL，直接对比数据库表结构，就能快速定位字段不匹配的问题。

• 检查数据库连接配置
  最后确认一下application.properties里的数据库连接信息是否正确：

  spring.datasource.url=jdbc:mysql://localhost:3306/your_database_name?useSSL=false&serverTimezone=UTC
  spring.datasource.username=your_username
  spring.datasource.password=your_password
  

  确保连接的是正确的数据库，避免因为连错库导致表结构不一致。

总的来说，这个问题就是实体类和数据库表的字段映射不匹配导致的，按照上面的步骤一步步排查，很快就能解决。

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