使用@Entity创建数据库表失败，Postman报500内部服务器错误

问题现象 #

通过Postman提交数据时返回500 Internal Server Error，后台报错：

could not extract ResultSet
Table 'microservices1.user' doesn't exist
o.h.engine.jdbc.spi.SqlExceptionHelper : SQL Error: 1146, SQLState: 42S02

本质是Hibernate找不到目标表，且@Entity注解未触发自动建表逻辑。

修复步骤 #

• 检查Spring Boot数据库配置
  核心是确认Hibernate自动建表开关是否开启，在application.properties或application.yml中配置：
  示例properties配置：

  # 关键配置：开启自动建表，update会保留现有数据并创建新表/更新表结构
  spring.jpa.hibernate.ddl-auto=update
  spring.jpa.show-sql=true
  # 数据库连接信息，替换为你的实际配置
  spring.datasource.url=jdbc:mysql://localhost:3306/microservices1?useSSL=false&serverTimezone=UTC
  spring.datasource.username=root
  spring.datasource.password=123456
  spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
  

  示例yml配置：

  spring:
    jpa:
      hibernate:
        ddl-auto: update
      show-sql: true
    datasource:
      url: jdbc:mysql://localhost:3306/microservices1?useSSL=false&serverTimezone=UTC
      username: root
      password: 123456
      driver-class-name: com.mysql.cj.jdbc.Driver
  

  如果ddl-auto设为none或未配置，Hibernate不会自动建表，这是最常见的诱因。

• 确认数据库已创建
  Hibernate只会自动建表，不会创建数据库。先手动登录MySQL执行CREATE DATABASE microservices1;确保数据库存在。

• 校验实体类与扫描范围
  确保User实体类正确标注@Entity注解，且实体类所在包被Spring Boot扫描：

  import jakarta.persistence.Entity;
  import jakarta.persistence.Id;
  import jakarta.persistence.GeneratedValue;
  import jakarta.persistence.GenerationType;
  
  @Entity
  public class User {
      @Id
      @GeneratedValue(strategy = GenerationType.IDENTITY)
      private Long id;
      private String username;
      // 补充字段、getter/setter方法
  }
  

  若实体类不在启动类的子包下，需在启动类添加@EntityScan("你的实体类包路径")指定扫描范围。

• 检查数据库用户权限
  确保数据库用户拥有microservices1数据库的CREATE权限，避免权限不足导致建表失败。

验证 #

重启应用，查看控制台是否输出Hibernate建表的SQL语句，再用Postman提交请求，确认500错误是否解决。

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