如何通过静态分析 AST 自动将旧代码库中的 Promise.then 重构为 Await-js教程-PHP中文网

直接替换.then()为await会出错，因await必须在async函数内且只能解包单个promise；需同步升格外层函数、展开链式调用、重写catch/finally为try/catch/finally。

如何通过静态分析 ast 自动将旧代码库中的 promise.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）。

核心是匹配 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(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 块