JavaScript异步测试中未捕获Promise拒绝会导致测试崩溃或静默失败；需全局监听unhandledRejection并转为显式失败，每个测试须用expect.resolves/rejects或try/catch处理Promise，且及时清理悬空异步资源。
在 JavaScript 异步测试中，未捕获的 Promise 拒绝（unhandledRejection）会导致测试进程意外退出、报错中断，或更隐蔽地“静默失败”——测试看似通过，但实际逻辑已出错且无日志可查。这在 Jest、Vitest、Mocha 等主流测试框架中都常见，根源和生产环境一致：Promise 被 reject 后没被 .catch() 或 try/catch 捕获，就会触发全局 unhandledRejection 事件。
测试前统一监听并拦截 unhandledRejection
这是最基础也最关键的兜底措施。在测试启动时（如 setupFilesAfterEnv 或 beforeAll 中）注册一次监听器，并确保它不会干扰正常断言：
- 用
process.on('unhandledRejection', ...)捕获所有漏网错误，避免测试崩溃 - 把错误转发给测试框架的失败机制（如 Jest 的
expect.fail()或抛出同步异常），让测试明确失败而非静默 - 务必调用
event.preventDefault()（Node.js v15+）或手动process.exit(1)（旧版）防止默认终止行为干扰测试生命周期
示例（Jest setup 文件）：
process.on('unhandledRejection', (reason, promise) => {console.error('Unhandled rejection in test:', reason);
expect.fail(`Unhandled Promise rejection: ${reason}`);
});
每个异步测试必须显式处理 Promise 结果
不能只 await 一个可能 reject 的 Promise 就结束测试；必须确保它被完整消费。常见错误写法：
test('should fetch user', async () => {
await fetch('/api/user'); // 如果 404 或网络失败，这里会 reject 且无捕获
});
正确做法是：
-
显式 catch 并断言错误：若期望失败，用
await expect(...).rejects.toThrow(...) - 用 try/catch 包裹 await：便于自定义错误检查或清理逻辑
-
避免“fire-and-forget”式调用：如
someAsyncFn().catch(console.error)在测试中无效，因错误未进入测试上下文
使用测试框架原生支持的异步断言语法
Jest 和 Vitest 都提供了安全的异步断言工具，它们内部自动处理 Promise 生命周期，避免 unhandledRejection：
-
await expect(promise).resolves.toBe(...)—— 成功路径断言 -
await expect(promise).rejects.toThrow(...)—— 失败路径断言（推荐用于预期错误） - 这些方法会等待 Promise settle，并在 reject 时主动捕获，不依赖外部 .catch
示例：
test('fetch rejects on network error', async () => {await expect(fetch('http://invalid')).rejects.toThrow();
});
清理测试中产生的悬空 Promise
某些操作（如定时器、事件监听、未关闭的 HTTP 客户端）可能在测试结束后才 resolve/reject，导致后续测试出现跨测试的 unhandledRejection。解决方式：
- 在
afterEach或teardown中主动取消或清理异步资源（如 AbortController、mock clear、server.close()） - 对非关键异步副作用（如日志上报）加
.catch(() => {})忽略，防止污染测试环境 - 启用 Jest 的
detectOpenHandles或 Vitest 的dangerouslyIgnoreUnhandledRejections（仅调试用，不推荐线上启用）
