防止 unhandled promise rejection 的核心是确保每个被拒 promise 都有明确处理路径：用 await expect().rejects 断言、测试函数必须 async 并 await 所有异步调用、全局监听 unhandledrejection 辅助排查、mock 异步依赖避免 pending。
防止测试中出现 Unhandled promise rejection 警告，核心是确保每个被拒绝的 Promise 都有明确的处理路径，不让错误“漏网”。Jest、Vitest 等框架会主动将未捕获的 reject 视为测试失败，所以这不是警告级别问题，而是测试逻辑缺陷信号。
用 expect().rejects 替代手动 try/catch
这是最简洁、语义最清晰的方式。它自动等待 Promise 结束，并在 reject 时提取 reason 进行断言，内部已抑制未处理警告：
- ✅ 正确写法：
await expect(fetchUser(123)).rejects.toThrow('Network error') - ❌ 错误写法：
expect(async () => { throw new Error() }).toThrow()—— async 函数本身同步返回 Promise，永远不会同步抛错 - ❌ 冗余写法：
try { await fetchUser(123); } catch (e) { expect(e).toMatch(...) }—— 容易遗漏 reject 或导致测试提前退出
测试函数必须声明 async 并 await 所有异步调用
不 await 就等于放弃等待，测试框架会在 Promise 完成前就结束测试，导致 reject 无处被捕获：
- ❌
test('...', () => { getUser().catch(console.error); });—— 没 await，Promise 成为“孤儿” - ✅
test('...', async () => { await getUser(); });—— 即使不校验结果，也要 await 让框架接管生命周期 - 若函数返回 Promise 但你不关心结果，至少写
await getUser();或return getUser();
全局兜底：监听 unhandledrejection（仅用于排查）
开发阶段可在测试入口统一监听，快速定位漏掉的 reject：
- 在
setupFilesAfterEnv（Jest）或setupFiles（Vitest）中添加： process.on('unhandledRejection', (reason, promise) => { console.warn('⚠️ Unhandled rejection in test:', reason); });- 注意：这不能替代正确断言，只是辅助发现；生产环境不应依赖此机制
Mock 异步依赖，避免真实请求挂起
未 mock 的 fetch、axios 或定时器会导致 Promise 永远 pending，一旦被 reject 就必然触发未捕获警告：
- 用
jest.mock('node-fetch')或vi.mock('axios')替换网络请求 - 对
setTimeout使用jest.useFakeTimers()+jest.runAllTimers() - 确保 mock 返回的是明确 resolve 或 reject 的 Promise，而不是抛出同步错误
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
