用 promise 包装第三方 sdk 回调的核心是 new promise 封装，将 err-first 或 success/fail 回调映射为 resolve/reject；需先明确 sdk 参数结构，再适配超时、防重复等健壮性措施。
用 Promise 包装第三方 SDK 的回调接口，核心是用 new Promise 封装调用过程，把成功/失败的回调转为 resolve 和 reject。
明确 SDK 回调参数结构
先看清 SDK 文档或源码：回调函数通常接收两个参数——错误对象（如 err 或 error）和结果数据（如 data 或 res）。常见模式有：
SDK.doSomething(params, (err, data) => { ... })SDK.upload(file, { success: fn, fail: fn })-
SDK.request(options, callback)，其中callback(err, result)
识别清楚参数顺序和含义，才能正确映射到 Promise 的 resolve/reject。
基础包装写法（标准 err-first 回调）
如果 SDK 使用 Node.js 风格的 (err, data) 回调，可直接按如下方式封装：
function sdkPromise(params) {
return new Promise((resolve, reject) => {
SDK.doSomething(params, (err, data) => {
if (err) {
reject(err);
} else {
resolve(data);
}
});
});
}
调用时即可用 async/await 或 .then()：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
async function handle() {
try {
const result = await sdkPromise({ id: 123 });
console.log(result);
} catch (err) {
console.error('SDK 调用失败:', err);
}
}
适配非标准回调（如 success/fail 分离）
有些 SDK 提供独立的成功和失败回调（如微信小程序、某些支付 SDK），需手动合并逻辑：
function uploadFilePromise(file) {
return new Promise((resolve, reject) => {
SDK.upload({
file,
success: (res) => resolve(res),
fail: (err) => reject(err)
});
});
}
注意：确保两个回调中只触发一次 resolve 或 reject，避免多次调用造成未定义行为。
增强健壮性（超时、重复调用防护）
第三方 SDK 可能不触发回调（如网络卡死），建议加超时控制：
function sdkWithTimeout(params, timeout = 10000) {
return Promise.race([
sdkPromise(params),
new Promise((_, reject) =>
setTimeout(() => reject(new Error('SDK 调用超时')), timeout)
)
]);
}
也可在 Promise 外层加防抖或节流逻辑，避免高频误触发；若 SDK 自身支持取消（如返回 cancel 函数），可进一步封装成可取消 Promise（需配合 AbortController 或自定义信号）。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
