Spring Boot集成Postgres保存数据报错：保存后标识符不能为空

问题根源分析 #

1. 列名映射不匹配：Postgres数据库表主键列是ownerid（小写），而Java实体类字段如果是ownerId（驼峰），默认情况下Hibernate会将其映射为owner_id（下划线分隔），导致插入时找不到正确的自增列，从而传入null值违反非空约束。
2. 主键生成策略适配问题：Postgres的SERIAL类型本质是基于序列（sequence）实现的自增，GenerationType.IDENTITY在部分Hibernate版本或方言下对Postgres的支持不够友好，需要调整为序列策略或确保方言配置正确。
3. 基本类型与包装类型的区别：最初使用long（基本类型）时，因为默认值是0，而数据库期望自增生成主键，JPA无法将0转换为数据库生成的自增值，导致报错“After saving the identifier must not be null!”；改为Long（包装类型）后，允许null值，符合数据库自增列的插入逻辑，但列名映射问题导致仍然传入null。

具体解决方案 #

1. 修正实体类的主键映射 #

确保实体类字段与数据库列名正确匹配，并配置正确的主键生成策略：

import jakarta.persistence.*; // Spring Boot 3+用该包；Spring Boot 2.x替换为javax.persistence

@Entity
@Table(name = "shopowner") // 明确指定表名，避免名称/大小写匹配问题
public class ShopOwner {
    @Id
    @Column(name = "ownerid", nullable = false, updatable = false) // 绑定数据库列名，禁止主键更新
    @GeneratedValue(strategy = GenerationType.SEQUENCE, generator = "shopowner_ownerid_seq")
    @SequenceGenerator(name = "shopowner_ownerid_seq", sequenceName = "shopowner_ownerid_seq", allocationSize = 1)
    // Postgres的SERIAL会自动生成同名序列，直接引用即可
    private Long ownerId;

    // 必须保留无参构造方法，JPA实例化实体需要
    public ShopOwner() {}

    // 其他字段、带参构造方法（不要包含ownerId）、getter/setter方法
}

2. 验证Repository定义 #

确保Repository的泛型参数与实体类主键类型匹配：

import org.springframework.data.repository.CrudRepository;

public interface ShopOwnerRepository extends CrudRepository<ShopOwner, Long> {
}

3. 调整应用配置 #

在application.properties或application.yml中配置正确的Postgres方言与数据库连接信息：

# application.properties
spring.jpa.database-platform=org.hibernate.dialect.PostgreSQLDialect
spring.jpa.hibernate.ddl-auto=none # 手动建表场景下，禁止Hibernate自动修改表结构
spring.datasource.url=jdbc:postgresql://localhost:5432/你的数据库名
spring.datasource.username=你的数据库用户名
spring.datasource.password=你的数据库密码
spring.datasource.driver-class-name=org.postgresql.Driver

4. 正确调用save方法 #

创建实体对象时不要手动设置ownerId，交由JPA自动处理自增逻辑：

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.context.ApplicationContext;

@SpringBootApplication
public class YourApplication {
    public static void main(String[] args) {
        ApplicationContext context = SpringApplication.run(YourApplication.class, args);
        ShopOwnerRepository repo = context.getBean(ShopOwnerRepository.class);

        ShopOwner owner = new ShopOwner();
        // 设置其他业务字段，例如owner.setShopName("XX便利店");
        repo.save(owner); // 无需设置ownerId
    }
}

5. 检查build.gradle依赖 #

确保Postgres驱动与Spring Data JPA依赖版本匹配：

plugins {
    id 'org.springframework.boot' version '3.2.0' // 替换为你的Spring Boot版本
    id 'io.spring.dependency-management' version '1.1.4'
    id 'java'
}

group = 'com.yourpackage'
version = '0.0.1-SNAPSHOT'

java {
    sourceCompatibility = '17' // 对应你的JDK版本
}

repositories {
    mavenCentral()
}

dependencies {
    implementation 'org.springframework.boot:spring-boot-starter-data-jpa'
    implementation 'org.postgresql:postgresql'
    testImplementation 'org.springframework.boot:spring-boot-starter-test'
}

tasks.named('test') {
    useJUnitPlatform()
}

验证排查步骤 #

如果问题仍存在，添加日志配置查看实际执行的SQL：

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

通过日志确认SQL语句中是否正确引用了ownerid列，以及插入值是否符合预期。

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