java分布式事务中，接口是定义参与者行为契约的核心，需包含prepare()、commit()、rollback()等标准化方法，强调幂等性、语义明确与业务中立，避免技术细节和受检异常，配合协调者实现解耦调度。
Java 中接口本身不执行逻辑，但它是定义分布式事务行为契约的核心手段。关键在于用接口统一约束参与者（Participant）在各阶段必须提供的能力，让协调者（Coordinator）能以一致方式调用不同服务节点，而不关心具体实现细节。
定义标准化的 Participant 接口
这是整个分布式事务协作的基础。接口需覆盖三阶段或两阶段必需的操作，且方法签名要明确语义和返回含义：
- prepare()：返回 boolean，表示该节点是否就绪（如本地事务已预写日志、资源已锁定）。不能抛异常代替拒绝，否则协调者无法区分“失败”与“拒绝”。
- commit()：无返回值，仅执行最终提交动作（如确认消息、释放锁、更新状态）。应具备幂等性，允许重复调用。
- rollback()：无返回值，执行清理操作（如释放资源、删除临时数据）。同样需幂等，避免多次回滚引发错误。
- 可选增加 recover() 方法：用于故障恢复时查询本地事务状态，辅助协调者做补偿决策。
接口设计要避开常见陷阱
很多团队直接照搬 JDBC 的 Connection 接口，结果导致语义混淆。比如把 commit() 设计成返回 int 或抛 SQLException —— 这在分布式场景下不合理，因为网络超时、节点宕机不是“SQL 错误”，而是协议层面的协作中断。
- 避免在接口中暴露底层技术细节（如 XA、JDBC、MQ 类型），保持业务中立。
- 不要让 prepare() 抛出受检异常（Checked Exception），否则强制调用方处理大量非业务异常，破坏协议简洁性。
- 所有方法都应声明 throws RuntimeException，由具体实现决定是否包装为特定异常（如 TimeoutException、UnavailableException）。
- 接口不应包含状态字段（如 isCommitted），状态应由协调者统一维护，参与者只响应指令。
配合协调者实现统一调度逻辑
协调者不依赖具体实现类，只面向 Participant 接口编程。例如三阶段提交中：
- 准备阶段遍历所有 Participant 调用 prepare()，任一返回 false 就终止流程；
- 预提交阶段不检查返回值，只确保全部调用 commit()（此时是“预生效”，非终态）；
- 提交阶段再确认全局一致性后，再次调用 commit() 完成终态，或触发 rollback() 补偿。
这种解耦让新增服务节点只需实现 Participant 接口并注册到协调者，无需修改核心调度逻辑。
实际项目中的扩展建议
纯接口定义只是起点。生产环境常补充以下机制提升可靠性：
- 添加 timeoutMs() 方法，让每个参与者声明自己 prepare 最长容忍时间，便于协调者设置全局超时阈值；
- 引入 version() 或 protocol() 方法，支持多版本协议共存（如同时兼容 2PC 和 TCC）；
- 配合 Spring 的 @Transactional 注解时，可用自定义注解（如 @DistributedParticipant）自动装配实现类，避免硬编码注册。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
