Node.js promisify：回调给出两个结果，await 为什么只拿到第一个
旧接口通过回调同时返回内容与附加信息，改成 await 后只剩内容，附加信息没有报错却消失了。首先检查默认适配器如何定义成功结果。一个 Promise 只有一个兑现值，旧回调里的多个成功参数需要明确包装，不能期待转换工具猜出你想要的结构。
本文在 Node.js v24.19.0 实测。保存为 demo.mjs，再运行 node demo.mjs。演示函数不访问网络，只把一个数字及其两倍交给回调；负数走错误分支。这样既能检查值有没有丢失，也能验证适配以后失败仍然到达调用者。
先确认旧回调的完整协议
函数的最后一个参数是回调，回调首项表示错误，后面两项才是成功数据。直接调用得到三和六，而默认 promisify 包装后的兑现值只有三。对于这个没有额外自定义约定的普通函数，后续成功参数不会自动组成数组，也不会自行变成对象字段。
AI概念示意图：旧接口送出两种结果，自定义适配器把它们装入一个共同容器，供异步调用者读取。图片是概念说明。
import assert from 'node:assert/strict';
import { promisify } from 'node:util';
function legacy(value, callback) {
if (value < 0) {
callback(new RangeError('negative'));
return;
}
callback(null, value, value * 2);
}
let original;
legacy(3, (error, value, doubled) => {
assert.equal(error, null);
original = [value, doubled];
});
assert.deepEqual(original, [3, 6]);
const plain = promisify(legacy);
assert.equal(await plain(3), 3);
await assert.rejects(plain(-1), RangeError);
console.log('default:', await plain(3));
legacy[promisify.custom] = value => new Promise((resolve, reject) => {
legacy(value, (error, first, second) => {
if (error) reject(error);
else resolve({ value: first, doubled: second });
});
});
const structured = promisify(legacy);
assert.equal(structured, legacy[promisify.custom]);
assert.deepEqual(await structured(3), { value: 3, doubled: 6 });
await assert.rejects(structured(-1), RangeError);
assert.equal(await plain(3), 3);
console.log('custom:', JSON.stringify(await structured(3)));
console.log('old wrapper:', await plain(3));把多个值放进一个稳定结构
代码为原函数设置 promisify.custom，值是一个返回 Promise 的函数。它仍调用原来的实现，在错误出现时 reject，在成功时把 value 和 doubled 组成对象交给 resolve。最终得到的仍然是一个兑现值，只是这个值内部有两个具名字段。
字段名称属于新接口契约，应表达实际含义，不能为了省事把第二项随便叫 data2。若原回调的某个值允许缺失，也应说明是字段不存在、值为 undefined，还是显式的空值。调用者需要据此决定是否继续处理，适配器不应悄悄补出没有依据的数据。
custom 是库导出的 Symbol 属性。给函数添加同名字符串字段不会生效；属性存在但不是函数也会造成错误。本例断言新包装函数就是该自定义函数，确认真正采用了我们安排的转换入口，而不是只看到输出碰巧相同。
已创建的包装不会自动换实现
先前保存的 plain 仍保持原来的默认行为，最后再次调用仍返回三。给原函数增加自定义属性，不会改写已经得到的包装函数对象。若项目在模块初始化时统一生成适配器，应在那个阶段之前配置清楚，并让使用者引用同一份预期入口。
默认与自定义两条路径都用负数验证拒绝。不要只测试成功对象的形状；如果自定义回调忘记处理首项错误，失败可能被包装成看似成功但字段为空的对象。保留一个可确认的错误样本，才能证明错误优先协议仍然存在。
还有一些 Node.js 内置接口提供自己的自定义行为，因此不能把本例的“只拿第一项”推广成所有被 promisify 的函数都如此。接入具体库时，先读它的 Promise 版本或转换约定，再判断是否需要手写适配。已有正式异步入口通常更容易维护。
一次结果与持续事件分开设计
这个适配器假设回调描述一次操作的最终结果。若接口会多次回调报告进度，一个 Promise 不会替你保存后来的每次更新；更适合用事件、异步迭代器或另外的进度通道。不能用首条数据成功返回就宣布整段流已经处理完成。
原函数若依赖 this，还必须保留正确接收者；本例故意用独立函数避开这项条件。超时、取消和资源释放也不会因为采用 await 自动出现，应由底层接口与调用流程分别承担。先写出输入、错误和完整成功值，再做适配，才能发现静默丢字段的问题。
