Spring Boot注册功能报错：user表id字段违反非空约束

问题根源 #

提交注册表单后插入user表时，id字段为null，违反了PostgreSQL的非空约束。以下是针对性的排查和解决步骤：

1. 修正User实体类的ID生成策略 #

这是最常见的问题，必须为@Id字段配置自动生成规则，匹配数据库表的自增方式：

• 如果数据库表用SERIAL/BIGSERIAL自增：

@Entity
@Table(name = "user")
public class User {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    // 其他字段：username、password等
}

• 如果用PostgreSQL序列：

@Entity
@Table(name = "user")
public class User {
    @Id
    @GeneratedValue(strategy = GenerationType.SEQUENCE, generator = "user_id_seq")
    @SequenceGenerator(name = "user_id_seq", sequenceName = "user_id_seq", allocationSize = 1)
    private Long id;
    // 其他字段...
}

注意：不要手动给id赋值为null，也不要省略@GeneratedValue注解。

2. 确认PostgreSQL表结构正确性 #

检查user表的id字段是否配置为自增主键：
正确的建表语句示例：

CREATE TABLE "user" (
    id BIGSERIAL PRIMARY KEY, -- BIGSERIAL对应Java的Long类型，SERIAL对应Integer
    username VARCHAR(50) NOT NULL UNIQUE,
    password VARCHAR(100) NOT NULL,
    -- 其他字段...
);

如果表的id只是普通非空主键但没有自增逻辑，要么修改表添加自增，要么在代码中手动生成唯一ID（如UUID）后赋值。

3. 检查Repository与Controller的保存逻辑 #

确保保存用户时没有手动设置id为null：

// Controller层正确示例
@PostMapping("/register")
public String handleRegistration(@ModelAttribute User user) {
    // 仅设置业务字段，不要操作id
    user.setPassword(passwordEncoder.encode(user.getPassword()));
    userRepository.save(user);
    return "redirect:/login";
}

如果代码中存在user.setId(null)，直接删除该行。

4. 验证Spring Boot配置 #

确保JPA方言正确识别PostgreSQL，避免生成错误的插入SQL：

spring.datasource.url=jdbc:postgresql://localhost:5432/your_db
spring.datasource.username=db_user
spring.datasource.password=db_pass
spring.jpa.hibernate.ddl-auto=validate
spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.PostgreSQLDialect

提示：ddl-auto设为validate可以验证实体类与表结构是否匹配，方便排查字段不一致问题。

5. 前端表单排查 #

确保前端表单没有传递id参数，比如不要包含<input name="id" />这类输入框，避免将null值绑定到User对象的id字段。

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