可选链仅防null/undefined访问错误，不防运行时异常；?.()返回Promise|undefined，需显式处理；应结合??提供默认值，并用isReady等状态标识确保SDK已初始化。
可选链不是万能的，它只防 nil/undefined，不防运行时异常
很多人以为加个 ?.greet() 就万事大吉，其实不然。可选链只在调用链中遇到 null 或 undefined 时短路返回 undefined，但一旦方法存在却抛出异常（比如网络超时、参数校验失败、SDK 内部空指针），它照样崩溃。
典型错误现象：TypeError: Cannot read property 'data' of undefined 消失了，但换成 SDKError: request timeout 或 RangeError: invalid token —— 这类错误仍需 try/catch 捕获。
- 可选链只处理“访问路径断裂”，不处理“方法执行失败”
- 第三方 SDK 的 API 方法往往内部含异步逻辑（如
fetch、axios调用），返回 Promise；此时?.then()无效，必须先确保对象存在，再.then()或await - TypeScript 中，
?.()的返回类型会变成T | undefined，但不会自动把Promise<t></t>变成Promise<t> | undefined</t>—— 类型检查可能误导你
嵌套 SDK 实例 + 异步方法调用的正确组合写法
假设你拿到一个第三方 SDK 实例 sdkClient，它有个不稳定的方法 getUserProfile()，返回 Promise<user></user>，而你不确定 sdkClient 是否已初始化成功。
错误示范：sdkClient?.getUserProfile()?.then(...) —— ?.getUserProfile() 返回的是 Promise<user> | undefined</user>，但 ?.then() 不合法（undefined 没有 then 方法）。
正确做法分两步：先保对象，再保调用。
- 用可选链安全访问实例和方法：
const fetchFn = sdkClient?.getUserProfile - 再显式判断并调用：
if (fetchFn && typeof fetchFn === 'function') { await fetchFn() } - 或更简洁：
await (sdkClient?.getUserProfile?.())—— 注意这里是?.()，不是?.then()；括号触发调用，结果是Promise<user> | undefined</user>，所以后续必须处理undefined - 推荐封装一层：
async function safeCall<t>(fn?: () => Promise<t>): Promise<t null> { return fn ? fn().catch(() => null) : Promise.resolve(null); }</t></t></t>，然后const profile = await safeCall(sdkClient?.getUserProfile)
与空值合并操作符（??）配合降级更实用
单纯靠可选链返回 undefined 往往不够，业务需要默认值或兜底行为。这时候 ?? 比 || 更可靠，因为它只在左侧为 null 或 undefined 时生效，不会误判 0、false、'' 等 falsy 值。
常见场景：调用 sdkClient?.config?.timeout ?? 5000 获取超时时间，或 (await sdkClient?.fetchOrder?.(id)) ?? { id, status: 'pending' } 提供默认订单结构。
- 避免写
sdkClient?.fetchOrder?.(id) || defaultOrder—— 如果 API 返回{ id, status: '' }，||会误触发兜底 - 注意：
??不能直接用于 Promise 链末端，比如(await fn()) ?? fallback是 OK 的，但fn()?.then(...) ?? fallback无效，因为??左侧是Promise对象本身，永远不是null/undefined - 若需对整个异步调用设兜底，用
Promise.race([fn(), Promise.resolve(fallback)])或封装超时逻辑
SDK 初始化未完成时，可选链反而掩盖真正问题
有些 SDK（比如阿里云文档审核 SDK 或支付宝小程序 APM SDK）依赖异步初始化（如加载配置、鉴权、连接 WebSocket）。如果直接写 sdk?.scanDocument?.(file)，即使 sdk 是个空对象或占位符，也会静默返回 undefined，导致业务逻辑“看似正常”却没真正发起请求。
这不是可选链的错，而是你没区分“未初始化”和“不可用”的语义。
- 检查 SDK 是否提供
isReady、status或init()返回 Promise 的状态标识，优先用它而不是仅依赖可选链 - 在关键调用前加断言：
if (!sdkClient?.isReady) throw new Error('SDK not ready');，比静默失败更容易定位集成问题 - 日志中记录可选链失效点，例如：
console.warn('SDK method scanDocument unavailable, client:', sdkClient)，方便排查是加载失败还是版本不匹配
null，什么条件下会抛异常，什么条件下会 resolve 一个错误结构体（比如 { code: 401, message: 'invalid token' }）。这些细节藏在它的初始化流程、网络策略和错误约定里，不读文档、不看源码、不抓包，光靠 ?.() 早晚踩坑。 
