直接替换.then()为await会出错，因await必须在async函数内且只能解包单个Promise；需同步升格外层函数、展开链式调用、重写catch/finally为try/catch/finally。
为什么直接替换 .then() 为 await 会出错
因为 .then() 是链式调用，而 await 必须在 async 函数内、且只能解包单个 Promise；直接把 promise.then(x => x + 1) 换成 await promise; x + 1 语法非法，还会丢掉上下文作用域和错误处理逻辑。
真正可行的重构必须同时做三件事：升格外层函数为 async、把 .then() 链展开为顺序 await 表达式、重写 .catch() 和 .finally() 为 try/catch/finally 块。
常见错误现象包括：await is only valid in async functions、Promise resolved with undefined（漏 return）、Uncaught (in promise) TypeError（没处理 reject）。
用 jscodeshift + 自定义 AST 脚本识别并转换基础 .then() 链
核心是匹配 CallExpression 中 callee.property.name === 'then'，再向上追溯是否属于 Promise 调用链。不能只看单个 .then()，要捕获整个链式结构（如 p.then(a).then(b).catch(c)）。
实操建议：
AI 舌诊面诊问诊医疗系统 + 诊疗商城系统源码是一套结合 AI 辅助诊断与商品转化的健康类程序，基于浩创云、ThinkPHP（PHP）开发，支持微信服务号与 H5 端，适合做中医舌诊面诊问答、健康建议推送以及配套诊疗商品的运营。
- 用
jscodeshift -t ./transform.js src/ --dry --verbose先预览变更，避免批量污染 - 跳过已含
await或async的函数体，防止重复处理 - 对嵌套
.then()（如inner().then(x => outer().then(y => ...))），优先降级为警告而非自动转换——这类需人工判断执行顺序依赖 - 保留原注释位置：用
path.node.comments提取并插入到对应await行上方
如何安全处理 .catch() 和错误传播
.catch(fn) 不能简单转成 catch (e) { fn(e) }，因为 fn 可能返回新 Promise（用于错误恢复），也可能 throw 新错误。AST 分析必须检查 catch 回调的返回值类型。
关键判断点：
- 若
catch回调是箭头函数且返回字面量（e => e.message），可转为同步catch块 +return - 若回调内含
await或调用其他 Promise 方法（如retryApi().then(...)），必须包裹进async匿名函数：catch (e) { return (async () => { ... })() } - 多个
.catch()链式调用（.then().catch().catch()）需合并为单个try/catch并用条件判断区分错误类型
否则会出现错误被吞掉、或异步错误未被 await 捕获的问题。
重构后必须验证的三个边界点
静态分析无法覆盖运行时行为，以下三点必须手动加测试或快速验证：
-
Promise.all([p1, p2]).then(([a, b]) => ...)→ 必须拆成const [a, b] = await Promise.all([p1, p2])，不能写成两个独立await（会失去并发性） -
then回调里修改外部变量（let result; p.then(x => result = x)）→await后需显式赋值，且注意作用域是否仍可达 - 原代码用
.then(null, err => ...)只处理 reject → 必须转为try { await p } catch (err) { ... }，不能漏掉try块
最易被忽略的是错误堆栈丢失：原 .then().catch() 保留原始 Promise 的 rejection 堆栈，而 try/catch 会截断。如果项目依赖长链错误溯源，得额外加 err.stack = originalStack + '\n' + err.stack 修补。
