Spring Data JPA无@Query注解执行Update查询遇事务异常问题

问题原因 #

执行JPA的update/delete这类修改操作时，必须处于事务上下文中，否则会抛出javax.persistence.TransactionRequiredException异常。你的代码里没有为执行update的方法声明事务，导致操作无法执行。另外，原代码中update语句执行后调用getResultList()是错误的——update语句仅返回受影响行数，不会返回实体列表，需要单独执行select查询获取结果。

解决方案 #

1. 添加事务注解 #

在自定义Repository的实现方法上添加@Transactional注解，开启事务支持。

2. 修正方法逻辑 #

将update操作和查询操作分开执行，确保返回正确的实体列表。

修改后的CustomUserRepositoryImpl代码：

import org.springframework.transaction.annotation.Transactional;

@Autowired
private EntityManager entityManager;

@Override
@Transactional // 显式声明事务
public List<User> findByUniqueId(String uniqueId, UserStatus role) {
    // 执行更新操作
    Query updateQuery = entityManager.createQuery("update User u set u.userStatus=:userStatus where u.unique=:unique");
    updateQuery.setParameter("userStatus", role)
               .setParameter("unique", uniqueId);
    updateQuery.executeUpdate();
    
    // 查询更新后的用户列表
    Query selectQuery = entityManager.createQuery("select u from User u where u.unique=:unique");
    selectQuery.setParameter("unique", uniqueId);
    return selectQuery.getResultList();
}

额外优化建议 #

• 接口方法名findByUniqueId不符合当前"更新+查询"的语义，建议改为更清晰的名字，比如updateUserStatusByUniqueIdAndReturnUsers，提升代码可读性。
• 确保项目已正确引入Spring事务依赖（Spring Boot项目默认已包含），且已开启事务管理（Spring Boot默认通过@SpringBootApplication自动开启）。

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