Spring Data JPA中deleteAllByField自定义删除方法不生效问题咨询

核心根源 #

该问题本质是Spring Data JPA默认事务配置和事务传播机制共同作用的结果：

• Spring Data JPA的默认Repository实现类SimpleJpaRepository类上默认标注了@Transactional(readOnly = true)，所有没有单独标注方法级@Transactional的Repository方法，都会继承这个只读事务属性。
• JpaRepository内置的修改类方法（比如deleteAll()、save()等）都在方法上单独标注了@Transactional，覆盖了类上的只读配置，默认readOnly = false，可以正常执行写操作。
• 你自定义的派生删除方法deleteAllByField没有显式标注@Transactional，默认继承了SimpleJpaRepository类上readOnly = true的事务属性。

场景原因分析 #

1. Service层事务未生效（最常见场景） #

Spring的声明式事务基于AOP动态代理实现，只有事务方法被代理类外部调用时事务注解才会生效。如果是FooService类内部直接调用deleteAllByField方法（比如同一个类内的其他方法通过this.调用），Service类上的@Transactional不会生效，此时：

• 调用自定义deleteAllByField方法时，Spring会为该Repository方法新建一个只读事务。
• 只读事务会强制将EntityManager的flush模式设置为FlushMode.NEVER，事务提交时不会将持久化上下文中的删除操作同步到数据库，因此不会输出SQL，数据也不会被删除。
• 调用内置deleteAll()方法时，该方法自带@Transactional(readOnly = false)配置，会新建可写事务，删除操作可以正常flush，因此能正常执行并打印SQL。

2. 事务注解包引用错误 #

如果Service层的@Transactional引用的是javax.transaction.Transactional而非Spring官方的org.springframework.transaction.annotation.Transactional，注解的属性不会被Spring事务管理器识别，导致Service层配置的事务属性不生效，最终效果和上述Service事务未生效的场景一致。

为什么给Repository方法加@Transactional就可以正常执行 #

当你在自定义deleteAllByField方法上单独添加@Transactional后，该方法的事务属性变为readOnly = false，覆盖了SimpleJpaRepository类上的只读配置：
此时无论外层是否有生效的Service事务，该方法都会运行在可写事务中，删除操作可以正常flush到数据库，SQL也会正常打印。

补充注意事项 #

• 自定义修改类Repository方法（包括派生的delete、update方法），建议显式标注@Transactional和@Modifying注解，批量操作时可添加@Modifying(clearAutomatically = true)同步持久化上下文，避免数据不一致问题。

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