Spring JPA事务中更新实体时脏检查失效的原因及可行方案

我正在使用Spring 3.3.0结合JPA开发基于JDK 21的Spring Boot Maven项目，遇到了实体更新未持久化的问题，相关代码及现象如下：

实体类代码 #

@Data
@Entity
@EqualsAndHashCode(of = {"id"})
@NoArgsConstructor
@AllArgsConstructor
@Builder
@Table(name = "articles")
public class Article implements Serializable {
    @Serial
    private static final long serialVersionUID = 1L;

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    @NotEmpty
    @Column(nullable = false, length = 1024)
    private String post;

    @Column(nullable = false, updatable = false)
    private LocalDateTime createdAt;

    @Column
    private LocalDateTime updatedAt;
}

控制器代码片段 #

@PutMapping("{id}")
public ResponseEntity<ArticleResponseDTO> update(
        @PathVariable("id") Article fromDb,
        @Valid @RequestBody Article article
) {
    var updated = articlesService.updateArticle(fromDb, article);
    return ResponseEntity.ok(ArticleMapper.toDto(updated));
}

服务层方法 #

@Transactional
public Article updateArticle(Article fromDb, Article article) {
    fromDb.setPost(article.getPost());
    return fromDb;
}

问题现象 #

• 从数据库获取实体并传入新实体的流程正常，返回的DTO是更新后的内容，但修改后的实体并未保存到数据库。
• 手动调用repo.save(fromDb)时，更新能正常生效。

疑问 #

1. 该现象的原因是什么？
2. 是否可以在此场景下使用JPA的脏检查机制？

现象原因 #

核心问题是实体的持久化状态不匹配：

• 控制器中通过@PathVariable注入的fromDb实体，是由Spring Data JPA的DomainClassConverter加载的，这个加载过程会开启一个临时的持久化上下文，当控制器方法开始执行时，该上下文已经关闭，fromDb成为**游离状态（detached）**的实体——即不在任何持久化上下文的管理范围内。
• 服务层的@Transactional注解会开启一个全新的持久化上下文，但游离实体不会自动加入到这个新上下文。JPA的脏检查仅针对**持久化状态（managed）**的实体（当前上下文管理的实体），因此无法检测到fromDb的变更，自然不会触发数据库更新。
• 调用repo.save(fromDb)时，Spring Data JPA会执行merge操作，将游离实体合并到当前持久化上下文，此时实体变为持久化状态，后续的变更（或当前已有的变更）会被检测到并触发更新。

是否可以使用脏检查？ #

可以使用，但需要确保实体处于当前事务的持久化上下文管理中，推荐两种调整方案：

方案一：服务层重新加载实体 #

在服务层通过Repository根据ID重新加载实体，确保它处于当前事务的持久化上下文中：

@Transactional
public Article updateArticle(Long articleId, Article article) {
    Article fromDb = articlesRepository.findById(articleId)
            .orElseThrow(() -> new RuntimeException("文章不存在"));
    fromDb.setPost(article.getPost());
    return fromDb;
}

此时fromDb是当前事务上下文管理的持久化实体，修改后脏检查会自动触发数据库更新，无需手动调用save。

方案二：手动合并游离实体 #

在服务层将游离实体合并到当前持久化上下文：

@Transactional
public Article updateArticle(Article fromDb, Article article) {
    Article managedArticle = articlesRepository.merge(fromDb);
    managedArticle.setPost(article.getPost());
    return managedArticle;
}

这种方式也能让实体进入持久化状态触发脏检查，但相比重新加载，可能带来额外的上下文同步开销，且代码可读性稍差。

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