在 JPA 中使用 @Query 执行原生 UPDATE 语句时，必须同时添加 @Modifying 注解并设置 nativeQuery = true，否则不会触发数据库更新；还需显式指定 WHERE 条件以避免全表误更新，并注意返回类型应为 void（或配合 @Transactional 返回实体）。
在 jpa 中使用 `@query` 执行原生 update 语句时，必须同时添加 `@modifying` 注解并设置 `nativequery = true`，否则不会触发数据库更新；还需显式指定 where 条件以避免全表误更新，并注意返回类型应为 `void`（或配合 `@transactional` 返回实体）。
在 Spring Data JPA 中，原生 UPDATE 查询与常规查询有本质区别：它属于数据修改操作（DML），而非只读查询（DQL），因此不能直接复用 @Query 的默认行为。若忽略关键配置，JPA 会静默忽略更新逻辑，甚至抛出 TransactionRequiredException 或返回空/异常结果。
✅ 正确写法如下：
@Repository
public interface CustomerRepository extends JpaRepository<Customer, Long> {
@Modifying // 必须：标识该查询会修改数据
@Query(value = "UPDATE CUSTOMER SET NAME = :name, PHONE = :phone WHERE CUSTOMER_ID = :customerId",
nativeQuery = true) // 必须：声明为原生 SQL（非 JPQL）
void updateCustomerWithNameAndPhone(
@Param("name") String name,
@Param("phone") String phone,
@Param("customerId") Long customerId);
}⚠️ 关键注意事项：
-
@Modifying不可省略：JPA 默认将@Query视为只读，@Modifying是启用 DML 的开关； -
必须搭配
@Transactional：调用方（如 Service 层）需在事务上下文中执行该方法，否则会抛出异常：@Service @Transactional // 推荐加在 service 方法或类上 public class CustomerService { public void updateCustomer(String name, String phone, Long id) { customerRepository.updateCustomerWithNameAndPhone(name, phone, id); } } -
WHERE 条件必不可少：原示例中缺失
WHERE子句，会导致全表更新，严重违反数据安全原则； -
返回值建议为
void：原生 UPDATE 不返回实体对象；若需返回更新后的客户信息，应拆分为两步——先更新，再通过findById()查询，或改用 JPQL +@Query(...)+Optional<t></t>结合save()实现； -
慎用
clearAutomatically = true：@Modifying(clearAutomatically = true)可清空一级缓存，避免脏读，但可能影响性能，按需启用。
? 补充：若希望方法返回受影响行数，可将返回类型改为 int：
@Modifying
@Query(value = "UPDATE CUSTOMER SET NAME = :name WHERE CUSTOMER_ID = :id", nativeQuery = true)
int updateCustomerName(@Param("name") String name, @Param("id") Long id);综上，原生 UPDATE 在 JPA 中不是“写对 SQL 就能跑”，而是需要注解协同、事务保障与语义严谨三者缺一不可。
