Promise 构造函数必须显式调用 resolve 或 reject，否则永久 pending；需覆盖所有异步分支、加超时兜底；async/await 必须每处 await 配 try/catch；Promise.allSettled 替代 all 获取全量结果；.then 中必须显式 return 避免 undefined 传递。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Promise 构造函数里忘了 resolve 或 reject 会卡死
Promise 不会自动结束，一旦构造函数执行完但没调用 resolve 或 reject，它就永远处于 pending 状态。常见于异步操作没覆盖全分支，比如只处理了成功回调，漏了失败或超时。
- 检查所有可能的退出路径：网络请求的
catch、定时器的clearTimeout后是否还有reject、事件监听器里是否每个事件类型都对应了resolve/reject - 加个兜底超时：
const timeout = setTimeout(() => reject(new Error('timeout')), 5000);并在正常完成时clearTimeout(timeout) - Node.js 环境下可用
util.promisify包装老式回调函数，避免手写 Promise 时遗漏
用 async/await 替代嵌套 .then() 但没加 try/catch
async/await 让代码线性可读，但错误不会自动抛到外层——它只会让当前 async 函数返回一个 rejected Promise，不捕获就会静默失败或炸到未处理拒绝（unhandledrejection）。
- 每个
await行都应处在try/catch块中，尤其是调用外部 API、读文件、数据库查询 - 不要只在最外层包一层
try/catch：内部多个await中任意一个出错，都会跳到catch，但你无法知道是哪一步挂了 —— 拆成小函数 + 单独处理更可控 - 浏览器中可通过监听
window.addEventListener('unhandledrejection')快速定位漏捕获点
Promise.all 遇到第一个失败就中断，但你要的是“全量结果”
Promise.all 是短路的，只要一个 Promise reject，整个就 reject，拿不到其他已完成的结果。这在并发请求聚合场景下很危险，比如批量上传文件，一个失败不该让其余结果丢失。
- 改用
Promise.allSettled（ES2020+），它总是返回所有 Promise 的状态数组，每个元素含status、value或reason - 旧环境可用
Promise.all(promises.map(p => p.catch(e => ({ error: e })))).then(results => {...})手动兜底 - 注意
Promise.allSettled不提升性能，只是语义更安全；若需失败即停且不关心其余结果，Promise.all仍更合适
链式调用里忘了 return，导致下一个 .then 收到 undefined
这是最隐蔽的坑：在 .then 回调里没显式 return，后续的 .then 就会拿到 undefined，而不是你预期的数据。尤其在解构赋值、条件判断后容易漏。
立即进入“豆包AI人工智官网入口”；
立即学习“豆包AI人工智能在线问答入口”；
- 检查每个
.then回调的末尾：是不是写了return fetch(...)而不是只写了fetch(...)？ - 箭头函数单行隐式返回易误判：
.then(x => x.data)✅，但.then(x => { x.data })❌（花括号块不自动返回） - 用
eslint规则no-return-await和consistent-return可提前暴露这类问题
Promise 的本质是状态机，不是语法糖。写的时候得时刻想清楚：这个 Promise 在什么条件下变成 fulfilled？什么条件下变成 rejected？有没有第三种可能被忽略？漏掉任何一个出口，就是线上 bug 的伏笔。
