事务中禁止调用外部网络接口，应将远程调用剥离出事务边界；推荐方案包括拆分方法、事务回调、异步执行或消息队列，并注意@Async的public修饰、非自调用及异常处理。
事务中调用外部网络接口（如 HTTP 调用、MQ 发送、Redis 写入、MongoDB 操作等）是引发大事务、超时、数据不一致的高频原因。根本原则是：**事务边界内只做本地数据库操作，所有远程交互必须剥离出事务范围。**
为什么不能在事务里调远程接口
远程调用不可控——网络抖动、对方响应慢、重试逻辑复杂，会导致事务长时间挂起。而数据库连接被占用、锁未释放，轻则拖慢整个服务，重则引发连接池耗尽、死锁或主从延迟加剧。Spring 的 @Transactional 默认传播行为是 REQUIRED，一旦嵌套调用也带事务，问题还会放大。
把远程调用移出事务的常用方式
- 拆分方法 + 显式控制事务边界：将本地 DB 操作和远程调用拆成两个独立方法，仅对前者加 @Transactional；后者在事务提交后执行
- 使用 TransactionSynchronizationManager 注册回调：在事务成功提交后触发远程调用，确保“先落库、再发消息”，适用于需要强最终一致性的场景
- 异步解耦（推荐）：用线程池或 Spring 的 @Async 启动新线程执行远程调用，避免阻塞主线程和事务线程。注意需配置独立线程池并处理异常重试
- 借助消息队列：本地事务成功后发一条 MQ 消息（如 RocketMQ 的事务消息、RabbitMQ 的 confirm 模式），由下游消费者完成远程操作。这是最健壮的解耦方案
特别注意的细节
即使用了 @Async，也要确认：事务方法是否为 public（AOP 代理才生效）、是否在同一个类内自调用（会绕过代理导致事务失效）、异步方法是否捕获并妥善处理异常（否则失败无声）。如果远程调用涉及状态变更（如支付回调），还需配套幂等设计和补偿机制。
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
简单示例（拆分 + 异步）
✅ 正确写法：
立即学习“Java免费学习笔记（深入）”；
public void createOrderAndNotify(Order order) {orderMapper.insert(order); // 在事务内
notifyThirdPartyAsync(order); // 异步发出，不在事务中
}
@Transactional
public void createOrder(Order order) {
orderMapper.insert(order);
}
@Async
public void notifyThirdPartyAsync(Order order) {
// 调用 HTTP 或发 MQ
}
❌ 错误写法：把 notifyThirdParty() 直接写在 @Transactional 方法内部，或用 private 方法封装后调用。
