不能通过 export 语法本身导出具备“原子化事务”特征的异步业务处理器模块，因为 export 仅为静态声明机制，不提供事务语义、状态一致性或崩溃恢复能力。
不能通过 export 语法本身导出具备“原子化事务”特征的异步业务处理器模块。export 是 JavaScript 模块系统的静态声明机制，只负责暴露函数、类或值，不提供事务语义、状态一致性保障或崩溃恢复能力。
原子化事务不是 export 能赋予的特性
所谓“原子化事务”，指操作要么全部成功、要么全部回滚，中间状态对外不可见，且支持故障后恢复到一致点。这依赖于：
- 底层存储引擎（如 MySQL InnoDB 的 redo/undo log、PostgreSQL 的 WAL）
- 运行时协调机制（如 Seata 的 AT 模式、Saga 补偿逻辑、TCC 两阶段协议）
- 应用层对事务边界的显式划分（如 @Transactional 切点、流程引擎的状态快照点）
而 export async function processOrder() 只是一个可调用的异步函数，它内部若未集成事务上下文传播、分支状态记录、补偿注册等机制，就只是普通异步逻辑，不具备 ACID 特性。
真正支持事务语义的模块应这样组织导出
若需构建可复用、可嵌入事务流程的异步处理器，导出设计应聚焦“可参与事务”，而非“自带事务”：
ImageMagick 批处理处理器
下载
使用 ImageMagick 的 convert 和 mogrify 命令进行批量图像处理，支持调整大小、裁剪、水印和格式转换。与 libvips 集成以实现高性能缩略图生成。
-
导出带事务钩子的异步单元：例如 export async function chargeAccount({ userId, amount }, { txContext }) { ... }，其中
txContext由外部事务管理器注入，用于绑定 undo 操作或注册回调 - 导出补偿动作作为独立命名导出：如 export async function rollbackCharge({ userId, amount }) { ... }，与主逻辑分离，便于 Saga 编排器按需调用
- 导出事务元信息常量：如 export const TRANSACTION_SCOPE = 'payment'; export const TIMEOUT_MS = 30_000; 供协调器统一调度与超时控制
- 避免默认导出含副作用的执行体：不要 export default async () => { await db.insert(); await mq.send(); } —— 这类函数无法被安全回滚，也不利于状态追踪
与框架协同才能落地事务能力
模块导出的内容必须与运行环境配合才生效：
- 在 Spring Boot + Seata 环境中，需搭配 @GlobalTransactional 注解，且导出函数应在被代理的 Service 类中定义，而非纯 ES 模块
- 在 Flowable 或 Camunda 中，“事务性”体现为流程实例的状态持久化与节点迁移能力，模块应导出符合引擎接口规范的委托类（如 Java Delegate），而非 JS 函数
- 前端 HMR 场景下，export 接受回调中更新的只能是无状态处理器（如纯函数），有事务上下文的模块不可热替换，否则会丢失进行中的事务状态
推荐替代路径：用 export 封装“事务就绪型”能力
与其追求“导出即事务”，不如导出易于接入事务体系的模块结构：
- 导出工厂函数：export function createPaymentProcessor(txManager) { return { execute, compensate }; }
- 导出类型定义（TypeScript）：export interface TransactionalHandler
{ run(input: T): Promise ; rollback(): Promise ; } - 导出配置契约：export const PAYMENT_HANDLER_SCHEMA = { input: z.object({ userId: z.string(), amount: z.number() }), constraints: { idempotentKey: 'userId' } };
这些导出项不承诺事务，但明确表达了“如何被纳入事务流程”，让集成方能基于标准契约做统一治理。
