Spring Data JPA保存关联Task的TaskHistory时事务静默回滚问题排查

嗨，我之前也碰到过一模一样的问题，咱们来一步步拆解排查，把这个坑填上！

首先看你抛出的两个关键错误，先把它们串起来：

• Transaction silently rolled back because it has been marked as rollback-only：这说明事务里某个操作抛出了异常，事务被标记成了只能回滚，但后续代码没把这个异常抛出来，最后就出现了“静默回滚”的情况。
• 根因的org.hibernate.TransientPropertyValueException：翻译过来就是“非空属性引用了一个瞬态值——瞬态实例必须在当前操作前保存”，看起来是说TaskHistory的task字段是未持久化的，但你的Task明明是从数据库里查出来的已持久化实例，问题其实出在实体监听器（TaskAuditListener）的关联维护和执行时机上。

一、先揪出核心问题：双向关联维护不全 #

我猜你在TaskAuditListener的回调方法里，只做了task.getHistory().add(history)这一步，却没给TaskHistory设置对应的Task实例？或者虽然设置了，但监听器执行时的实例状态有问题？

举个例子，如果你的监听器代码是这样的（大概率踩了这个坑）：

public class TaskAuditListener {
    @PreUpdate
    public void preUpdate(Task task) {
        TaskHistory history = new TaskHistory();
        history.setFieldName("status");
        history.setOldValue(/* 旧状态值 */);
        history.setNewValue(/* 新状态值 */);
        history.setChangedAt(LocalDateTime.now());
        // 只给Task的History列表加了元素，没给History设置对应的Task
        task.getHistory().add(history);
    }
}

这时候虽然Task端的双向关联加了元素，但TaskHistory端的task属性是null，而这个字段在数据库里是nullable = false的，Hibernate就会判定你要保存一个task为瞬态（实际是null）的History，直接抛出异常，进而把整个事务标记为rollback-only，最后就出现了静默回滚。

二、一步步解决问题 #

1. 补全双向关联的两端维护 #

在监听器里添加TaskHistory的时候，必须同时维护关联的两端：

@Component
public class TaskAuditListener {
    @PersistenceContext
    private EntityManager entityManager;

    @PreUpdate
    public void preUpdate(Task task) {
        // 从Hibernate持久化上下文里取Task的旧状态快照
        Session session = entityManager.unwrap(Session.class);
        Task oldTask = session.get(Task.class, task.getId());
        String oldStatus = oldTask.getStatus().name();
        String newStatus = task.getStatus().name();

        TaskHistory history = new TaskHistory();
        history.setFieldName("status");
        history.setOldValue(oldStatus);
        history.setNewValue(newStatus);
        history.setChangedAt(LocalDateTime.now());
        // 关键：给History设置对应的Task实例
        history.setTask(task);
        // 同时维护Task端的关联列表
        task.getHistory().add(history);
    }
}

这里要注意：@PreUpdate回调执行时，参数里的Task已经是更新后的状态了，所以要通过Hibernate的Session获取旧状态的快照，才能拿到正确的oldValue。

2. 确保监听器在Spring事务上下文里运行 #

把TaskAuditListener加上@Component注解，让Spring管理这个Bean，这样它注入的EntityManager才是当前事务上下文里的实例，避免出现状态不一致的问题。同时记得在Task实体的@EntityListeners里指定这个类。

3. 检查服务层的事务边界 #

你的PATCH接口对应的服务层方法，一定要加上@Transactional注解，确保Task的更新和TaskHistory的级联保存都在同一个事务里执行。比如：

@Service
public class TaskService {
    private final TaskRepository taskRepository;

    // 构造注入（推荐）
    public TaskService(TaskRepository taskRepository) {
        this.taskRepository = taskRepository;
    }

    @Transactional
    public Task updateTaskStatus(Long taskId, Status newStatus) {
        Task task = taskRepository.findById(taskId)
                .orElseThrow(() -> new RuntimeException("指定Task不存在"));
        task.setStatus(newStatus);
        return taskRepository.save(task);
    }
}

如果没加@Transactional，Spring会在每个数据操作方法上创建独立的事务，很容易出现瞬态对象的问题。

4. 优化：给TaskHistory加自动时间戳 #

你可以在TaskHistory实体里加@PrePersist回调，自动设置changedAt字段，不用在监听器里手动处理，更优雅：

@Entity
public class TaskHistory {
    // 其他字段...
    private LocalDateTime changedAt;

    @PrePersist
    public void prePersist() {
        this.changedAt = LocalDateTime.now();
    }
}

三、验证效果 #

修改完之后，再调用PATCH接口更新Task状态，应该就能正常保存TaskHistory，事务也能正常提交，不会再出现静默回滚的问题了。

内容来源于stack exchange