SpringBoot PostMapping无法向PostgreSQL新增数据问题排查

两个报错为连锁触发，核心原因是Hibernate主键生成策略配置与PostgreSQL表结构不匹配：

1. SQLGrammarException: relation "hibernate_sequences" does not exist：Employee实体类主键字段的@GeneratedValue未显式指定生成策略，默认使用GenerationType.AUTO时，Hibernate会尝试读取全局hibernate_sequences表生成主键值，当前数据库中不存在该表，直接导致主键ID生成失败，返回null。
2. ConstraintViolationException：主键生成逻辑失败后，待插入数据的employee_id字段值为null，违反该字段的非空约束，触发插入报错。

GET、PUT、DELETE接口可正常运行，是因为三类接口不需要生成新主键，不会触发主键生成逻辑的配置缺陷，因此问题仅在POST新增接口暴露。

任选一种方案调整即可：

• 方案1：使用PostgreSQL专属序列（生产环境推荐，性能最优）

  1. 连接PostgreSQL执行以下SQL，为employee_id字段创建绑定的专属序列：

  CREATE SEQUENCE employee_employee_id_seq OWNED BY employee.employee_id;
  ALTER TABLE employee ALTER COLUMN employee_id SET DEFAULT nextval('employee_employee_id_seq');
  

  2. 修改Employee实体类的主键注解配置，显式指定序列生成规则：

  @Id
  @GeneratedValue(strategy = GenerationType.SEQUENCE, generator = "employee_id_generator")
  @SequenceGenerator(
          name = "employee_id_generator",
          sequenceName = "employee_employee_id_seq",
          allocationSize = 1
  )
  @Column(name = "employee_id", nullable = false)
  private Long employeeId;
  

  注意allocationSize参数值需与序列的自增步长保持一致，设置为1可避免主键跳号问题。

• 方案2：使用数据库自增主键（配置最简单）

  1. 调整PostgreSQL表结构，将employee_id设置为自增字段：

  ALTER TABLE employee ALTER COLUMN employee_id ADD GENERATED ALWAYS AS IDENTITY;
  

  2. 修改Employee实体类主键注解，指定使用IDENTITY生成策略：

  @Id
  @GeneratedValue(strategy = GenerationType.IDENTITY)
  @Column(name = "employee_id", nullable = false)
  private Long employeeId;
  

  该模式下Hibernate插入数据后会自动读取数据库生成的自增ID，不会尝试查询hibernate_sequences表。

• 方案3：启用Hibernate全局序列表（不推荐，性能较差）
  在application.properties/application.yml中配置Hibernate自动创建缺失的序列表，配置项为：

  spring.jpa.properties.hibernate.hbm2ddl.auto=update
  

  该配置会让Hibernate启动时自动创建hibernate_sequences表，但全局表生成主键的方式并发性能差，仅适合本地测试环境使用。

配置调整完成后重启SpringBoot应用，重新调用POST /employees接口即可正常新增数据。

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