使用JPA新增实体字段后提交表单遇事务终止：ITEM_QTY列不可为NULL

嘿，这个问题我之前做项目时也踩过坑！咱们先把错误核心拎出来：你遇到的TRANSACTION ABORTED本质是底层的SQLIntegrityConstraintViolationException——数据库里的ITEM_QTY列不允许存NULL值，但你的插入操作传了NULL进去。下面是几种常见原因和对应的解决办法：

1. 数据库与实体类的约束不一致 #

你新增实体字段后，大概率是数据库表的ITEM_QTY被设置成了NOT NULL，但实体类要么没给这个字段设默认值，要么没强制要求前端传值。

• 解决思路二选一：
  • 修改数据库表，给字段加默认值（比如数字类型设为0）：

    ALTER TABLE your_table_name MODIFY COLUMN ITEM_QTY INT DEFAULT 0;
    

  • 或者保持数据库的NOT NULL约束，同时在实体类里明确标注非空：

    @Column(name = "ITEM_QTY", nullable = false)
    private Integer itemQty;
    

    然后在前端表单给这个字段加required校验，后端也加非空判断，确保提交时一定有值。

2. 表单数据绑定失败 #

前端表单的字段名和实体类的字段名不匹配，导致框架（比如Spring MVC）没法把表单值正确绑定到实体的itemQty字段，最终插入时传了NULL。

• 解决办法：
  • 检查前端input的name属性，确保和实体类字段名一致（注意驼峰命名，比如实体是itemQty，表单就写name="itemQty"）：

    <input type="number" name="itemQty" required placeholder="请输入数量">
    

  • 如果前端习惯用下划线命名（比如item_qty），可以在实体字段的@Column里加上name="ITEM_QTY"，同时在绑定的时候用@ModelAttribute或者手动映射参数。

3. 代码逻辑遗漏赋值 #

在保存实体之前，有没有漏掉给itemQty赋值？比如业务代码里只处理了其他字段，忘了把表单传来的数量设置到实体对象里。

• 解决办法：
  • 在调用repository.save()或者entityManager.persist()之前，加个非空校验：

    if (yourEntity.getItemQty() == null) {
        throw new IllegalArgumentException("商品数量不能为空，请检查表单输入");
    }
    

    提前拦截NULL值，避免触发数据库层面的约束错误。

4. EclipseLink缓存问题（可选） #

从错误信息看你用的是EclipseLink，有可能是ORM缓存没更新，导致框架不知道你新增了字段。

• 解决办法：
  • 重启应用，或者手动清除EclipseLink的缓存：

    entityManager.getEntityManagerFactory().getCache().evictAll();
    

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