Java+Hibernate插入自定义对象ID作为数据库主键报空值问题解决

使用Java自定义JPA实体执行数据库插入操作时，触发非空约束报错：

Cannot insert the value NULL into column 'orphan_id', table '****'; column does not allow nulls. INSERT fails.
Cannot insert the value NULL into column 'abcd_id', table 'xxxxx'; column does not allow nulls. INSERT fails.
已确认实体中abcId字段赋值不为空，相关代码如下：

实体类定义 #

@AllArgsConstructor
@NoArgsConstructor
@ToString
@Builder
@Entity
@Table(name = "abcd")
public class Abcd{
    @Id
    private String abcId;

    private String abcGroup;

    private String abcState;
}

Repository层定义 #

@Repository
public interface AbcdRepository extends CrudRepository<Abcd, String> {

}

Service层通过Builder模式构建实体对象后，调用AbcdRepository.save(abcd)方法执行保存，仍持续抛出上述非空错误。

• 核心原因是JPA字段与数据库列的映射关系不匹配：当前实体主键字段为abcId，在Spring Data JPA默认的SpringPhysicalNamingStrategy命名策略下，驼峰命名会自动转换为下划线格式，即该字段默认映射到数据库的abc_id列。但报错信息显示目标表的主键列名为abcd_id，映射错位导致JPA生成插入SQL时，未给实际存在的abcd_id主键列传值，触发非空约束。
• 首次报错提到的orphan_id空值问题同理：实体类中未定义映射到orphan_id列的属性，JPA插入时不会为该字段传值，只要表结构中该字段设置了非空约束就会直接报错。
• 已校验Lombok注解组合：@Builder、@NoArgsConstructor、@AllArgsConstructor同时存在时，不会影响JPA的实体实例化和属性赋值逻辑，排除注解冲突问题。

• 方案一：显式指定字段列映射（推荐，侵入性最低）
  给实体主键字段添加@Column注解，明确指定对应的数据库列名，同时标记字段非空，和表结构约束对齐：

  @Id
  @Column(name = "abcd_id", nullable = false)
  private String abcId;
  

  如果表中orphan_id为非空字段，同步在实体类中补充对应属性，添加@Column(name = "orphan_id", nullable = false)注解，插入前确保该字段赋值不为空即可。
• 方案二：调整表结构对齐默认映射规则
  如果业务上确认主键字段名应为abc_id，直接修改数据库表结构，将abcd表的主键列名从abcd_id改为abc_id，同时删除多余的orphan_id非空字段、或补充该字段的默认值，即可匹配JPA默认的映射逻辑，无需修改代码。
• 方案三：全局修改JPA命名策略
  如果项目中所有表字段均采用和实体字段完全一致的驼峰命名，不需要自动转下划线，可以在配置文件中修改JPA物理命名策略，关闭自动驼峰转下划线逻辑，yml配置示例如下：

  spring:
    jpa:
      hibernate:
        naming:
          physical-strategy: org.hibernate.boot.model.naming.PhysicalNamingStrategyStandardImpl
  

  注意该配置为全局生效，修改后需要确认项目中其他实体的字段和数据库列名完全匹配，避免引发新的映射错误。

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