Promise值穿透是规范定义的默认行为：当then未传失败回调且上游被拒绝时，错误原样传递至后续catch或带onRejected的then，目的是集中捕获、避免静默丢失。
Promise 的值穿透不是“意外发生”，而是规范定义的默认行为：当 then 方法没传失败回调（即第二个参数为 undefined 或非函数），它会把上一个 Promise 的拒绝状态原样往下传递，直到遇到能处理它的 catch 或带 onRejected 的 then。这不是 bug，是设计使然，目的是让错误集中捕获、避免静默丢失。
值穿透发生的条件和机制
值穿透只在以下情况触发：
-
当前 then 没提供 onRejected 回调（比如写成
.then(fn)或.then(fn, undefined)） -
上游 Promise 处于 rejected 状态（不管是因为
reject()、抛错，还是返回了被 reject 的 Promise） - 该 then 返回的新 Promise 会继承上游的 rejection，且不执行任何失败处理逻辑
例如：Promise.reject(1).then(() => {}).catch(console.log) → 输出 1。中间的 then 没写失败回调，所以 1 直接穿透到 catch。
用正确参数避免意外穿透
想中断穿透、主动处理错误或转换状态，关键在于显式提供 onRejected 参数，并控制其返回值：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
立即学习“Java免费学习笔记（深入）”；
-
想吞掉错误并转为成功：在
onRejected中返回任意非 Promise 值（包括undefined），新 Promise 就变成 fulfilled 状态
例：.then(null, () => 'fallback')→ 后续then收到'fallback' -
想转换错误但保持失败态：在
onRejected中调用throw或返回被 reject 的 Promise
例：.then(null, err => { throw new Error('包装错误') }) -
想保留原始错误继续穿透：直接
return错误值不会触发穿透（因为 return 不等于 throw），必须throw或reject
规范要求：若onRejected返回值不是 Promise，且未抛错，则新 Promise 以该返回值 fulfilled；只有抛错才会让新 Promise rejected
常见误用与推荐写法
容易踩坑的地方：
-
.then(fn, null)——null不是函数，等价于没传，照样穿透 -
.then(fn, reason => reason)—— 返回原始错误值，新 Promise 是 fulfilled，不是 rejected！想保持失败要用throw reason -
.catch(fn)实质是.then(undefined, fn)，所以它天然承接所有未被拦截的 rejection
推荐写法：
• 单点错误处理用 .catch() 最清晰
• 需要“失败转成功”时，明确写 .then(null, () => defaultValue)
• 链式中每个 then 都应考虑是否需要处理失败，不写第二参数就等于选择穿透
