SpringBoot创建User实体类时提示‘Table users已存在’错误排查

问题描述 #

已在MySQL中创建数据库及对应表，完成SpringBoot与数据库的连接后，创建了与表字段匹配的User实体类，启动应用时出现错误：

Error executing DDL...[Table 'users' already exists]

配置与代码 #

application.properties配置 #

spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver

# Hibernate specific properties
spring.jpa.database-platform=org.hibernate.dialect.MySQL8Dialect
spring.jpa.hibernate.ddl-auto=update

User实体类代码 #

import jakarta.persistence.*;
@Entity
@Table(name = "Users")
public class User {
    @Id
    @GeneratedValue(strategy = GenerationType.AUTO)
    private Integer id;

    private String firstName;
    private String lastName;
    private String password;
    private Float rating;

    // getters and setters
}

MySQL中Users表创建语句 #

CREATE TABLE Users (
    User_ID INT AUTO_INCREMENT,
    First_Name VARCHAR(100),
    Last_Name VARCHAR(100),
    Password VARCHAR(255), -- storing hashed password
    Rating FLOAT,
    PRIMARY KEY (User_ID)
);

错误原因分析 #

1. 表名大小写不匹配
   MySQL的表名大小写敏感性依赖于操作系统和lower_case_table_names配置：

• Windows系统默认lower_case_table_names=1，表名不区分大小写，Hibernate生成DDL时会将@Table(name = "Users")转换为小写的users，但数据库中实际存在的是大写的Users，此时Hibernate会认为users表不存在，尝试创建时触发“已存在”报错。
• Linux系统默认lower_case_table_names=2，表名区分大小写，若Hibernate生成的表名与数据库实际表名大小写不一致，同样会识别为不同表，导致创建冲突。

2. 实体类与数据库字段映射不匹配
   实体类中的字段命名与数据库表字段存在差异：

• 实体类主键为id，但数据库主键是User_ID；
• 实体类的firstName、lastName等字段，Hibernate默认命名策略会转换为first_name、last_name，但数据库中对应的是First_Name、Last_Name。
  这种映射不匹配会让Hibernate认为当前Users表的结构与实体类不匹配，进而尝试创建新的users表（默认类名小写），最终触发报错。

解决方案 #

1. 统一表名大小写

   • 若使用Windows系统，可将@Table(name = "Users")改为@Table(name = "users")，确保与Hibernate生成的表名一致；
   • 若使用Linux系统，确保@Table(name = "Users")的大小写与数据库表名完全一致，同时检查MySQL的lower_case_table_names配置避免自动转换。

2. 修正字段映射
   为实体类字段添加@Column注解，显式指定对应的数据库列名：

import jakarta.persistence.*;
@Entity
@Table(name = "Users")
public class User {
    @Id
    @GeneratedValue(strategy = GenerationType.AUTO)
    @Column(name = "User_ID")
    private Integer id;

    @Column(name = "First_Name")
    private String firstName;

    @Column(name = "Last_Name")
    private String lastName;

    @Column(name = "Password")
    private String password;

    @Column(name = "Rating")
    private Float rating;

    // getters and setters
}

3. 可选：调整Hibernate命名策略
   若不想逐个字段添加@Column，可在application.properties中配置Hibernate的命名策略，使其匹配数据库的大写下划线命名：

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

该配置会让Hibernate严格使用实体类和@Table、@Column中指定的名称，不做自动转换。

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