Promise是JavaScript异步编程的基础设施，本质是同步执行执行器函数的状态容器，不自动触发异步；then/catch需正确配对，Promise.all全失败而allSettled可获全部结果。
Promise 是 JavaScript 中处理异步操作的标准机制，不是语法糖，也不是可选工具——它是现代 JS 异步编程的基础设施。你写 fetch()、async/await，底层都依赖 Promise 的状态流转和链式能力。
Promise 本质是「状态容器」，不是「自动执行器」
很多人误以为 new Promise() 会“自动开始异步”，其实它只是把一段逻辑（执行器函数）**同步执行一次**，而真正的异步行为（比如 setTimeout、fetch、fs.readFile）得你自己写进去。
const p = new Promise((resolve, reject) => {
console.log('这行立刻执行'); // ✅ 同步打印
setTimeout(() => {
resolve('延迟1秒后才触发');
}, 1000);
});
console.log('这行在new Promise之后立刻执行'); // ✅ 也同步
- Promise 构造函数里的回调是**同步执行的**，但里面调用的异步 API（如
setTimeout）才是真正的“异步源头” - Promise 本身不控制事件循环，它只负责在异步完成时，按规则把
resolve或reject的值塞进微任务队列 - 漏写异步调用（比如忘了
setTimeout或fetch），Promise 就永远卡在pending状态，既不then也不catch
then() 和 catch() 不是“必须成对出现”的开关
常见错误：在 then() 里处理成功，在下一个 then() 里处理失败——这是错的。Promise 链中，catch() 捕获的是**前面所有环节抛出的错误或被 reject 的 Promise**，不是仅捕获上一个 then()。
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
Promise.resolve(1)
.then(x => { throw new Error('boom') })
.then(x => console.log('不会执行'))
.catch(err => console.log('这里会捕获 boom')); // ✅ 正确
-
then(onFulfilled, onRejected)的第二个参数只能捕获**前一个 Promise 成功后、onFulfilled 函数内部抛出的错误**，不能捕获前一个 Promise 本身被 reject 的情况 - 推荐统一用
.then(...).catch(...)形式，避免错误静默丢失 -
catch()后如果没再抛错，后续then()仍会执行（因为 catch 返回的是 fulfilled 状态的新 Promise）
并发请求别硬套 Promise.all()，小心全盘失败
当你用 Promise.all([p1, p2, p3]) 并发请求多个接口，只要其中任意一个被 reject，整个 all 就立刻失败——哪怕另外两个早已成功。这不是 bug，是设计使然。
立即学习“Java免费学习笔记（深入）”；
const p1 = Promise.resolve('a');
const p2 = Promise.reject(new Error('timeout'));
const p3 = Promise.resolve('c');
<p>Promise.all([p1, p2, p3])
.then(console.log) // ❌ 永远不会执行
.catch(err => console.log(err.message)); // ✅ 输出 'timeout'</p>- 需要“不管成败都等全部结束”，改用
Promise.allSettled()（ES2020+，现代浏览器和 Node.js ≥12.9.0 支持） - 需要“只要一个成功就停”，用
Promise.race()；但注意：第一个 reject 也会让 race 失败 - 兼容老环境？手动封装：对每个 Promise 做
.then(...).catch(...)包一层，确保返回 always-fulfilled 结构
Promise 的难点不在语法，而在它把「时间不确定性」显式地变成「状态确定性」。你写的每一步 then，都是在声明：“当上一步确认完成（无论成功失败），请把结果交给我”。一旦习惯这种思维，async/await 就只是语法糖，而不是魔法。真正容易被忽略的，是执行器函数里那句没写上的 reject() —— 它不会报错，只会让整个链悬在那里，等你半夜查监控时才发现某个按钮点了没反应。
