Spring Boot未自动创建user_games表问题咨询

以下是几个大概率的原因及对应解决办法：

• 检查实体类扫描范围
  确认Spring Boot主启动类所在包是否包含org.springframework.cluedo.user。@SpringBootApplication默认只扫描自身包及其子包，若主启动类不在org.springframework.cluedo层级下，需手动添加@EntityScan(basePackages = "org.springframework.cluedo.user")指定实体扫描路径。

• 排查数据库DDL配置
  打开application.properties/yml文件，查看spring.jpa.hibernate.ddl-auto的取值：

  • 若为none：Hibernate完全不处理表结构，不会创建新表；
  • 若为validate：仅校验表结构，表不存在时会报错而非创建；
  • 建议改为update（保留现有数据更新表结构）或create（测试环境用，会清空重建表），重启项目重试。

• 解决SQL关键字冲突
  实体类中的order字段是SQL保留关键字，直接使用会导致Hibernate生成的DDL语句语法错误，表创建失败。两种修改方式：

  1. 对字段名进行转义：

     @Column(name = "`order`") // 用反引号包裹关键字
     private Integer order;
     

  2. 修改字段名称，比如改为playOrder：

     @Column
     private Integer playOrder;
     

• 检查父类BaseEntity的主键配置
  确认BaseEntity中是否正确定义了主键，比如是否添加了@Id和@GeneratedValue注解。若父类无主键，Hibernate不会将UserGame视为合法实体类，也就不会创建对应表。

• 排查枚举类型映射
  实体中的SuspectType枚举需确保JPA映射配置正确。若未添加@Enumerated注解，Hibernate默认按整数存储枚举值，可能因数据库字段类型不匹配导致表创建失败。可显式添加注解：

  @NotNull
  @Enumerated(EnumType.STRING) // 按字符串存储枚举值，更直观易维护
  private SuspectType suspect;
  

• 查看Hibernate日志定位错误
  开启SQL日志查看Hibernate生成的DDL语句，排查语法问题。在application.properties中添加：

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

  重启项目后，控制台会输出所有SQL语句，找到创建user_games表的语句，检查是否存在关键字冲突、字段类型不匹配等错误。

内容的提问来源于stack exchange，提问作者Ismael Barrera García