如何正确更新持久化JPA实体？关联更新后JSON返回异常

问题根源分析 #

1. EntityManager一级缓存不一致：添加Product到Category后，JPA缓存里的Category仍是旧对象，查询时直接返回缓存数据，导致products字段为空；重启服务器后缓存清空，才从数据库加载最新数据。
2. 重复键错误原因：若为双向关联，关联关系由Product维护，你已经通过Product持久化完成了外键关联，此时再调用save(category)，JPA会基于缓存里的旧Category对象尝试重复插入关联记录（比如中间表条目），引发主键冲突。

第一步：确认实体关联映射正确性 #

双向一对多关联必须明确维护方，确保映射配置无误：

Category实体（非关联维护方） #

@Entity
public class Category {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    // mappedBy指定由Product的category字段维护关联，级联操作交给维护方
    @OneToMany(mappedBy = "category", cascade = CascadeType.ALL, fetch = FetchType.LAZY)
    private List<Product> products = new ArrayList<>();

    // 封装关联维护逻辑，保证双向引用一致
    public void addProduct(Product product) {
        products.add(product);
        product.setCategory(this); // 必须设置Product的category引用
    }

    // getter/setter省略
}

Product实体（关联维护方） #

@Entity
public class Product {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    @ManyToOne(fetch = FetchType.LAZY)
    @JoinColumn(name = "category_id") // 外键列名，对应Category的id
    private Category category;

    // getter/setter省略
}

第二步：addProduct接口的正确实现 #

核心是仅维护并持久化关联维护方（Product），同时保证缓存一致性：

@Transactional
public void addProductToCategory(Long categoryId, Product newProduct) {
    // 1. 从数据库加载最新的Category，避免使用缓存旧对象
    Category category = entityManager.find(Category.class, categoryId);
    
    // 2. 调用封装方法维护双向关联
    category.addProduct(newProduct);
    
    // 3. 只需要持久化Product，CascadeType.ALL会自动处理关联同步
    entityManager.persist(newProduct);
    
    // 可选：若当前会话需要立即获取更新后的Category，手动刷新缓存
    // entityManager.refresh(category);
}

第三步：解决JSON返回products为空的问题 #

方案1：查询时强制加载关联集合 #

使用JOIN FETCH避免懒加载导致的序列化空值：

public Category getCategoryWithProducts(Long categoryId) {
    return entityManager.createQuery(
        "SELECT c FROM Category c JOIN FETCH c.products WHERE c.id = :id", Category.class
    )
    .setParameter("id", categoryId)
    .getSingleResult();
}

方案2：处理懒加载序列化问题 #

若保持FetchType.LAZY，可在实体上添加注解忽略Hibernate懒加载代理：

@Entity
@JsonIgnoreProperties({"hibernateLazyInitializer", "handler"})
public class Category {
    // ... 其他代码
}

关键注意事项 #

• 绝对不要在通过Product完成关联持久化后，再调用categoryManager.save(category)，这会触发JPA基于旧缓存对象重复插入关联数据，导致主键冲突。
• 双向关联必须同时维护双方的引用，否则会出现数据库与内存对象不一致的情况。
• 事务必须覆盖整个操作流程，确保实体操作的原子性和缓存同步。

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