javascript 可以用 promise.race() 让任务与超时 promise 竞争,再通过任务工厂控制重试次数。race 只决定外层结果,不会取消底层任务;超时后重试可能与旧任务并行。以下 node.js 示例只对自定义 timeouterror 重试,适用于无副作用的演示任务,不应直接套用到支付或写入操作。

封装会清理定时器的超时函数
保存为 timeout.cjs。接收 taskFactory 而不是已经创建的 Promise,确保每次尝试都能启动新任务;通过 Promise.resolve().then(...) 也能把同步抛出的异常转成拒绝结果。finally 在成功、失败或超时后清理本轮定时器。
class TimeoutError extends Error {
constructor() {
super('任务等待超时');
this.name = 'TimeoutError';
}
}
async function withTimeout(taskFactory, timeoutMs) {
if (!Number.isFinite(timeoutMs) || timeoutMs <= 0) {
throw new RangeError('timeoutMs 必须为正数');
}
let timer;
const timeout = new Promise((_, reject) => {
timer = setTimeout(() => reject(new TimeoutError()), timeoutMs);
});
try {
return await Promise.race([
Promise.resolve().then(taskFactory),
timeout
]);
} finally {
clearTimeout(timer);
}
}
module.exports = { TimeoutError, withTimeout };这里只限制调用方愿意等待多久。若任务支持 AbortSignal,可以另外把取消信号传入具体操作;不支持取消的任务仍会继续运行,定时器清理也不会撤销已经发生的业务动作。

立即学习“Java免费学习笔记(深入)”;
只在超时时重新创建任务并限制总调用次数
保存为 retry.cjs,与 timeout.cjs 放在同一目录。maxRetries 表示首次执行之外的额外重试次数:设为 2,最多调用任务工厂 3 次。业务错误、参数错误及同步异常不会因为消息里出现“超时”两个字就被重试。
const { TimeoutError, withTimeout } = require('./timeout.cjs');
async function retryOnTimeout(taskFactory, timeoutMs, maxRetries = 2) {
if (!Number.isInteger(maxRetries) || maxRetries < 0) {
throw new RangeError('maxRetries 必须为非负整数');
}
for (let attempt = 0; attempt <= maxRetries; attempt++) {
try {
return await withTimeout(taskFactory, timeoutMs);
} catch (error) {
if (!(error instanceof TimeoutError) || attempt === maxRetries) {
throw error;
}
}
}
}
module.exports = { retryOnTimeout };此实现没有退避等待或并发残留清理,目的是展示超时与次数边界。接入真实服务前,还要明确哪些错误可重试、操作是否幂等,以及服务端是否已经执行了请求;不能把“没等到响应”当作“服务端没做”。
验证立即成功、一次超时后成功和重试耗尽
保存为 check.cjs,执行 node check.cjs。测试用不结束的本地 Promise 模拟超时,不发送网络请求,不依赖随机数决定结果。第二项只在第一次超时,第三项持续超时,最后一项确认普通异常只调用一次。
const assert = require('node:assert/strict');
const { TimeoutError } = require('./timeout.cjs');
const { retryOnTimeout } = require('./retry.cjs');
const pending = () => new Promise(() => {});
async function main() {
assert.equal(await retryOnTimeout(() => Promise.resolve('ok'), 30), 'ok');
let calls = 0;
const recovered = await retryOnTimeout(() => {
calls++;
return calls === 1 ? pending() : Promise.resolve('恢复');
}, 30, 2);
assert.equal(recovered, '恢复');
assert.equal(calls, 2);
calls = 0;
await assert.rejects(retryOnTimeout(() => {
calls++;
return pending();
}, 30, 2), TimeoutError);
assert.equal(calls, 3);
calls = 0;
await assert.rejects(retryOnTimeout(() => {
calls++;
throw new TypeError('输入错误');
}, 30, 2), TypeError);
assert.equal(calls, 1);
console.log('成功、恢复、重试耗尽及普通异常检查通过');
}
main().catch(error => { console.error(error); process.exitCode = 1; });这些断言验证的是外层等待与工厂调用次数,不证明底层操作已取消。示例里未完成的 Promise 没有计时器或 I/O,不会单独阻止 Node.js 退出;真实任务需要自己的资源生命周期管理。


















