Spring Boot 中 @Transactional 注解在服务层失效，通常是因为事务方法被同一类中的非事务方法调用（内部调用），导致代理未生效；本文详解原理、修复方式及最佳实践。
spring boot 中 `@transactional` 注解在服务层失效，通常是因为事务方法被同一类中的非事务方法调用（内部调用），导致代理未生效；本文详解原理、修复方式及最佳实践。
在 Spring Boot 应用中，@Transactional 是实现声明式事务的核心机制，但其生效依赖于 Spring 的 AOP 代理机制。一个典型却极易被忽视的问题是：当带 @Transactional 的方法被同一个 Bean 内部的其他方法直接调用时，事务将不会生效——这正是你代码中 insertEmployee() 调用 insertEmployee1() 所遭遇的情况。
? 问题根源：代理失效（Self-Invocation）
Spring 的事务管理基于动态代理（JDK Proxy 或 CGLIB）。@Transactional 方法只有通过代理对象调用时，才能触发事务拦截器（TransactionInterceptor）。而当你在 insertEmployee() 中直接调用 this.insertEmployee1(...)，实际执行的是目标对象自身的普通 Java 方法调用，绕过了代理层，因此事务注解被完全忽略。
你的原始代码存在两个关键问题：
- insertEmployee1() 虽有 @Transactional，但被同 Service 类内的 insertEmployee() 内部调用；
- insertEmployee() 本身无事务注解，且未通过代理调用 insertEmployee1()。
@Service
public class EmpService {
@Autowired
EmployeeRepo empRepo;
@Autowired
EmployeeHealthInsuranceRepo healthRepo;
@Transactional // ✅ 此处声明有效，但仅对代理调用生效
public void insertEmployee1(Employee employee, EmployeeHealthInsurance insurance) {
empRepo.save(employee);
System.out.println(100 / 0); // ⚠️ 运行时异常，应触发回滚
healthRepo.save(insurance);
}
// ❌ 错误：内部调用 → 事务不生效
public void insertEmployee(Employee employee, EmployeeHealthInsurance insurance) {
insertEmployee1(employee, insurance); // ← this. 调用，绕过代理！
}
}✅ 正确解决方案
方案一：为入口方法添加 @Transactional（推荐）
将事务边界上移到对外暴露的业务入口方法，确保其通过代理调用：
@Service
public class EmpService {
@Autowired
EmployeeRepo empRepo;
@Autowired
EmployeeHealthInsuranceRepo healthRepo;
// ✅ 移除内部方法的 @Transactional（可选），专注入口控制
public void insertEmployee1(Employee employee, EmployeeHealthInsurance insurance) {
empRepo.save(employee);
System.out.println(100 / 0);
healthRepo.save(insurance);
}
// ✅ 入口方法加 @Transactional → 由代理调用，事务生效
@Transactional
public void insertEmployee(Employee employee, EmployeeHealthInsurance insurance) {
insertEmployee1(employee, insurance);
}
}方案二：使用 AopContext.currentProxy()（不推荐，侵入性强）
仅在必须保留内部调用结构时使用（需开启暴露代理）：
@Service
public class EmpService {
@Transactional
public void insertEmployee1(...) { ... }
public void insertEmployee(...) {
// 强制通过代理调用（需在启动类添加 @EnableAspectJAutoProxy(exposeProxy = true)）
((EmpService) AopContext.currentProxy()).insertEmployee1(...);
}
}⚠️ 注意：此方式破坏封装性，增加测试难度，应避免在新项目中使用。
? 关键注意事项
- 检查事务传播行为：默认 PROPAGATION_REQUIRED 已满足多数场景，如需嵌套事务或独立事务，请显式指定 @Transactional(propagation = ...);
- 异常类型决定是否回滚：Spring 默认仅对 RuntimeException 及其子类、Error 回滚；若需对检查型异常（如 Exception）回滚，需配置 @Transactional(rollbackFor = Exception.class)；
- 确保 Bean 由 Spring 容器管理：手动 new EmpService() 创建的对象无法被代理，事务必然失效；
- 数据库引擎支持事务：确认 MySQL 表引擎为 InnoDB（MyISAM 不支持事务）；
- 启用事务日志调试：添加 logging.level.org.springframework.transaction=DEBUG 查看事务创建/提交/回滚过程。
✅ 验证事务是否生效
启动应用后，观察控制台日志：
- 若事务生效，应看到类似 Creating new transaction、Initiating transaction rollback（因 100/0 抛出 ArithmeticException）；
- 若未看到回滚日志，且数据库中 employee 记录已写入但 health 未写入，则说明事务未覆盖整个操作链——即典型的代理失效表现。
掌握事务的代理机制本质，远比死记“加注解就生效”更重要。始终让事务边界落在外部可访问的、由 Spring 管理的 Bean 方法上，是保障数据一致性的第一道防线。
