本文介绍一种安全、可控的方式为 cypress 中的递归轮询函数添加“2 分钟超时”逻辑——不依赖 promise.race + settimeout，而是通过限制最大重试次数实现等效超时效果，并确保递归终止明确、避免内存泄漏或无限等待。
本文介绍一种安全、可控的方式为 cypress 中的递归轮询函数添加“2 分钟超时”逻辑——不依赖 promise.race + settimeout，而是通过限制最大重试次数实现等效超时效果，并确保递归终止明确、避免内存泄漏或无限等待。
在 Cypress 测试中，常需轮询后端接口直至状态就绪（如交易确认）。但直接使用无限递归（如原 resWait()）存在严重风险：若服务异常或条件永不满足，测试将无限挂起，最终超时失败且难以定位原因。虽然直觉上可用 Promise.race() 配合 setTimeout 实现超时，但在 Cypress 的命令式异步模型中，这种纯 Promise 方案易与 cy.req()、cy.wait() 等命令产生时序冲突，导致不可预测行为（如超时触发时命令队列未清空、重复执行等）。
因此，推荐采用“有限重试 + 显式退出”策略——用参数控制最大尝试次数，结合每次等待时间，精准模拟超时效果。例如，目标总耗时约 2 分钟（120 秒），单次轮询后等待 3 秒，则最多允许 Math.floor(120 / 3) = 40 次重试；为留余量，设为 35～40 次更稳妥。
以下是重构后的健壮版本：
function resWait(attemptsRemaining = 40) {
// 发起请求
cy.req(
'GET',
`${url}/transaction/acquirertrxquery?acquirerId=1&dateFrom=${actualDate}%2000:00:00&dateTo=${actualDate}%2023:59:00&externalId=${idExternal}`
).then((res) => {
// 提前校验响应结构，避免因数据缺失导致脚本崩溃
const content = res.body?.content;
if (!Array.isArray(content) || content.length === 0) {
cy.log('⚠️ API 返回空 content，跳过状态检查');
if (attemptsRemaining > 0) {
cy.wait(3000);
resWait(attemptsRemaining - 1);
}
return;
}
const statusDesc = content[0]?.trxConfirmationStatus?.description;
const isConfirmed = statusDesc === 'Confirmed';
// ✅ 条件满足 或 ❌ 重试耗尽 → 终止递归
if (isConfirmed || attemptsRemaining === 0) {
if (!isConfirmed) {
cy.log(`❌ 轮询超时：${attemptsRemaining === 0 ? '达到最大重试次数' : '状态未确认'}`);
}
return;
}
// 继续下一轮：等待后递归调用
cy.wait(3000);
resWait(attemptsRemaining - 1);
});
}关键改进说明：
- ✅ 显式终止逻辑：attemptsRemaining 作为递减计数器，使递归出口清晰可控，杜绝无限调用；
- ✅ 防御性编程：增加 res.body?.content 和嵌套属性可选链校验，防止因 API 异常返回导致测试中断；
- ✅ 可观测性增强：通过 cy.log() 输出超时原因，便于调试；
- ✅ 时间可配置：若需调整超时阈值，仅需修改 attemptsRemaining 初始值（如 = 20 对应约 60 秒），无需改动等待逻辑。
⚠️ 注意事项：
- 避免在 cy.req().then() 外部使用 Promise 封装该函数——Cypress 命令必须在命令队列中顺序执行，随意混用 Promise 可能破坏其自动重试、截图、视频录制等核心机制；
- 若业务要求严格精确到毫秒级超时（罕见），才需引入 Promise.race() + cy.task() 自定义超时命令，但会显著增加复杂度和维护成本；
- 建议将 url、actualDate、idExternal 等变量通过参数传入，提升函数复用性与测试隔离性。
此方案兼顾可靠性、可读性与 Cypress 最佳实践，是生产环境轮询逻辑的推荐实现方式。
