async函数只展平直接返回的promise，不递归解包嵌套promise；返回非promise值自动包装，返回promise则直接返回，返回已resolve的嵌套promise仍保留内层结构。
async 函数本身会自动把返回值包装成 Promise，如果返回值已经是 Promise（包括嵌套的 Promise），JavaScript 会自动“展平”一层，但不会递归解包多层嵌套。关键在于：async 函数只会展平**直接返回的 Promise**，不会处理 Promise 内部 resolve 的另一个 Promise（即未被 await 的嵌套）。
async 函数对返回值的自动处理规则
当你在 async 函数中 return 一个值，JavaScript 会按以下逻辑处理：
- return 非 Promise 值（如字符串、对象、undefined）→ 自动包装为
Promise.resolve(value) - return 一个 Promise（例如
return fetch(...)）→ 直接返回该 Promise，不额外包装 - return 一个已 resolve 为 Promise 的值（例如
return Promise.resolve(Promise.resolve(42))）→ 不会展平内层，最终 Promise 的 value 就是那个内部 Promise 对象
常见嵌套 Promise 场景与修复方法
真正导致“嵌套 Promise”的，往往是因为忘了 await 或错误地链式调用 .then() 后又 return 了新 Promise。
-
错误写法（产生 Promise
>）： async function bad() { return Promise.resolve(42).then(x => Promise.resolve(x * 2)); }
这里 return 的是.then()的返回值——一个 Promise，而它的 resolve 值又是另一个 Promise（因为箭头函数返回了Promise.resolve(...)）。 -
正确写法（得到 Promise
）：
用 await 确保拿到最终值：async function good() { const inner = await Promise.resolve(42); return inner * 2; }
或者避免在 then 回调里返回 Promise：async function alsoGood() { return Promise.resolve(42).then(x => x * 2); }
如何检查是否意外返回了嵌套 Promise？
可以在调用后加一层判断：
- 打印返回值的 constructor：
const p = bad(); p.then(v => console.log(v.constructor)); // 输出 Promise，说明 v 是 Promise 而非原始值 - 用
await两次（仅用于调试）：const nested = await bad(); const actual = await nested; // 如果 nested 是 Promise，第二次 await 才拿到真值 - 更稳妥的做法：始终在 async 函数内部 await 所有异步操作，再 return 平坦值。
实用建议：保持返回值“扁平化”
要让 async 函数始终返回你期望类型的 Promise（比如 Promise
- 在 async 函数中，对所有异步来源（Promise、其他 async 函数）都使用 await 获取最终值，再 return
- 避免在 async 函数中混用 .then() 和 return，尤其不要在 .then() 回调里 return 新的 Promise
- 如果必须链式调用，确保 .then() 的回调返回的是普通值，或用 await 替代 .then()
- 使用 TypeScript 可在编译期捕获部分嵌套类型问题（例如
Promise<promise>></promise>会被标为类型不匹配）
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
