Promise链的输入由上一个then()回调的返回值决定：若返回普通值则立即传递，若返回Promise则等待其resolve；catch仅捕获前序未处理的rejection；Promise.all并行执行，finally仅执行清理且不改变数据流。
Promise链的返回值决定下一级的输入
Promise链不是自动把上一个结果传给下一个，而是取决于 then() 回调函数的返回值。如果回调里没写 return，或返回的是普通值（比如字符串、数字），那下一个 then() 就会立刻收到这个值；如果返回的是另一个 Promise，那下一个 then() 就要等它 resolve 后才触发。
常见错误是忘了在 then() 里 return 异步操作：
fetch('/api/user')
.then(res => res.json())
.then(user => {
fetch(`/api/posts?userId=${user.id}`); // ❌ 忘了 return，下一个 then 会立即拿到 undefined
})
.then(posts => console.log(posts)); // 这里 posts 是 undefined
正确写法是：
- 每个异步步骤都用
return显式传出 Promise - 避免在
then()里只调用异步函数却不返回它 - 可以用
async/await替代嵌套then()，但底层仍是 Promise 链逻辑
catch() 只捕获前面未处理的 rejection
catch() 不是“全局错误处理器”，它只捕获链中它之前、且没有被 then(null, ...) 或另一个 catch() 拦截的错误。一旦某个 catch() 处理了错误，后续的 then() 会照常执行（除非你手动抛出新错误）。
立即学习“Java免费学习笔记（深入）”；
典型陷阱：
- 把
catch()放在中间位置，以为能兜住后面所有错误 —— 实际上它对后边的 Promise 无效 - 在
catch()里没重新抛错，导致错误“静默消失”，后续逻辑继续跑，但数据可能为空 - 多个
catch()并存时，只有第一个生效，后面的不会触发（除非前一个又抛错）
示例：
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
Promise.reject('fail1')
.catch(err => {
console.log(err); // 'fail1'
return 'recovered';
})
.then(val => {
throw 'fail2'; // 这个错误不会被上面的 catch 捕获
})
.catch(err => console.log(err)); // ✅ 这里才捕获 'fail2'
Promise.all() 和链式调用的区别在哪
链式调用（.then().then().then()）是串行：每个步骤等前一个完成再开始；而 Promise.all() 是并行：所有 Promise 同时启动，全部 resolve 才算成功，任一 reject 整体就失败。
选哪个取决于业务逻辑：
- 需要按顺序获取数据（比如先登录，再用 token 请求用户信息，再用 userId 请求订单）→ 用链式
- 几个独立请求互不依赖（比如同时拉取用户头像、通知数、未读消息）→ 用
Promise.all([p1, p2, p3]) - 想让部分失败不影响整体（比如日志上报失败不该阻塞主流程）→ 用
Promise.allSettled()
注意：Promise.all() 的参数必须是数组，不能是链式结构；它返回的是一个新的 Promise，不是链的一部分。
finally() 不接收参数，也不影响链的数据流
finally() 的作用只是做清理工作（比如关闭 loading 状态、释放资源），它不接收上一步的值，也不能修改传递给后续 then() 的数据。无论前面是 resolve 还是 reject，它都会执行。
容易误用的点：
- 在
finally()里试图通过return改变链的输出 → 不生效，返回值会被忽略 - 把它当成
catch()用，以为能拦截错误 → 它不接收 error 参数，也无法阻止错误向下传播 - 和
catch()顺序写反，比如.finally().catch()→ 错误仍会触发finally，但catch还是能捕获它
真正该用 finally() 的地方，是那些“不管成不成功都要做的事”：
loading.value = true;
fetch('/api/data')
.then(res => res.json())
.catch(err => console.error(err))
.finally(() => {
loading.value = false; // ✅ 正确：清掉 loading，不关心结果
});
链的复杂度往往不在语法，而在控制流意图是否清晰。每加一个 then() 或 catch()，都要问自己：这里到底想等什么？谁该负责处理错误？有没有隐式的串行假设？这些比记住 API 更关键。
