async函数未加await会导致返回pending状态的promise而非预期值，排查关键是识别“本该是数据却变成promise”的异常，如返回值类型为promise、调用链中漏await、条件分支或回调中未处理promise等。
async 函数没加 await，本质是忘了“接住” Promise，结果拿到的是一个 pending 状态的 Promise 对象，而不是你期望的值。排查重点不是找语法错误，而是识别“本该是数据却变成了 Promise”的异常表现。
看返回值类型是否意外为 Promise
这是最直接的线索：函数明明声明为 async，也调用了异步操作，但调用后得到的却是 Promise { <pending> }</pending> 或 Promise { [object Object] }，而不是字符串、数字、对象等预期类型。
例如：
async function fetchUser() {
return fetch('/api/user').then(r => r.json()); // ❌ 忘了 await，直接 return 了 Promise
}
const data = fetchUser(); // → Promise { <pending> }，不是用户数据
console.log(data.name); // undefined！
</pending>
✅ 正确写法：
async function fetchUser() {
const res = await fetch('/api/user'); // ✅ 先 await 响应
return await res.json(); // ✅ 再 await 解析结果
}
检查调用链中是否漏掉了 await（尤其嵌套调用）
常见于“async 函数 A 调用了 async 函数 B，但 A 里没 await B”——B 返回了 Promise，A 又直接 return 它，导致整条链上游都拿到 Promise。
- 逐层检查每个 async 函数的调用处：只要它返回的是 Promise，而你又想用它的 resolved 值，就必须
await - 特别注意条件分支、循环、箭头函数回调里的调用（如
.map(x => apiCall(x))返回的是 Promise 数组，不是数据数组） - 在 Chrome DevTools 的 Console 中直接打印返回值，用
typeof val === 'object' && val?.then快速判断是不是 Promise
利用 TypeScript 或 ESLint 提前拦截
这类问题属于典型可静态检测的错误：
-
TypeScript：开启
"strict": true后，若函数标注为async且返回Promise<t></t>，而你在非 async 上下文中直接赋值给T类型变量，会报错 -
ESLint：启用
eslint-plugin-require-await（检测无 await 的 async 函数）和no-return-await（避免冗余 await），再配合@typescript-eslint/promise-function-async规则，能覆盖大部分疏漏场景
调试时加临时 await + console.log 验证执行流
当逻辑较深、不确定哪一层断开时，不用重写，只需插入验证点：
async function processOrder() {
const user = await getUser(); // ✅ 加 await 并 log
console.log('user:', user); // 看这里是不是真实对象
const order = createOrder(user); // ❓ 这里是否该 await？看 createOrder 是不是 async
console.log('order:', order); // 如果输出 Promise，就说明它其实是 async 函数
return order;
}
观察日志顺序和值类型，比单步调试更快定位“断点”。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
