Spring Boot添加UID到POST请求体后写入Apache Derby遇NULL错误

可能的原因及修复步骤 #

• 实体类ID字段注解配置错误
  用JPA/Hibernate的话，检查实体类的@Id字段注解：

  • 若手动赋值UID，别用@GeneratedValue(strategy = GenerationType.IDENTITY)这类强制数据库自增的策略——Derby的IDENTITY列会直接忽略手动设置的值，自行生成ID，最终导致数据库接收到的ID为NULL（如果字段未设置默认值）。
  • 正确配置：手动管理ID时，仅保留@Id注解，删除@GeneratedValue；若需兼容手动赋值与自动生成，可使用@GeneratedValue(strategy = GenerationType.AUTO)，但要确保Derby的表结构允许手动插入ID值。
  • 示例代码：

    @Id
    private String uid; // 手动赋值，无需@GeneratedValue
    

• 字段与数据库列映射不匹配
  检查实体类ID字段与数据库表列的对应关系：

  • 若字段名和列名不一致，需添加@Column(name = "你的列名")注解，确保框架能正确识别字段对应的数据库列，避免因映射错误导致值未传入。

• 持久化前ID被意外覆盖
  查看Service层之后的代码，确认是否有拦截器、AOP切面在持久化前修改了对象的ID值；或是调用repository.save()之前，ID被意外重置。可以在调用save方法前再次打印对象ID，确认值是否存在。

更可靠的UID添加方案 #

使用JPA的@PrePersist注解，在对象被持久化到数据库前自动生成并设置UID，无需在构造函数或Service层手动处理，更可靠且解耦：

1. 在实体类中添加标记@PrePersist的方法：

   @Entity
   public class Bounty {
       @Id
       private String uid;
       // 其他字段...
   
       @PrePersist
       public void generateUid() {
           if (this.uid == null) {
               this.uid = UUID.randomUUID().toString();
           }
       }
   }
   

2. 这样每次调用repository.save()时，若对象UID为NULL，会自动生成UUID作为唯一ID，避免手动赋值的遗漏或覆盖问题。

额外检查点 #

• 确认Derby数据库表的ID列不允许NULL值，且未设置强制自增（若采用手动赋值方式）；
• 查看日志中的完整SQL语句，确认插入操作时ID字段及对应值是否被正确包含在INSERT语句中。

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