异步断言漏错本质是测试未等待异步完成，导致断言提前执行、错误被跳过或promise拒绝未被捕获；须用await显式等待、启用未处理promise检测、避免错误吞没，并用promise.race加超时保险。
异步断言漏掉错误，本质是测试流程没真正等异步操作结束，导致断言提前执行、错误被跳过或 Promise 拒绝未被捕获。关键不是加更多 expect，而是让测试运行器“感知到异步已完成”，并主动拦截未处理的拒绝。
确保每个异步断言都正确 await
未加 await 是最常见原因：expect(...).rejects.toThrow() 返回的是一个 Promise，不 await 就等于断言了一个 pending 状态，永远通过。
- ✅ 正确写法：
await expect(fetchUser()).rejects.toThrow('Network error') - ❌ 错误写法：
expect(fetchUser()).rejects.toThrow('Network error')（无 await，断言失效） - ❌ 同样错误：
await expect(fetchUser()).rejects（缺少具体匹配器，不校验内容）
启用未处理 Promise 检测机制
现代测试工具能自动发现“发出去却没人管”的 Promise，这是定位漏 await 的第一道防线。
- Jest：在配置中开启
detectOpenHandles: true，运行时加--detectOpenHandles，会报出未 resolve/reject 的 Promise - Vitest：默认启用
unhandledRejection: 'error'，控制台出现Unhandled promise rejection就说明有异步逻辑没被 await 或 catch - 看到这类日志，立刻检查对应测试用例是否漏了 await、.catch() 或 try-catch 包裹
顶层 await + 显式 reject 处理，不依赖隐式传播
不要指望错误会自动冒泡到测试函数顶层。异步操作内部抛错，必须显式暴露给测试断言。
- 避免在被测函数里吞掉错误：
async function apiCall() { try { return await fetch(...); } catch { return null; } }—— 这会让测试无法断言异常 - 应让错误透出：
async function apiCall() { const res = await fetch(...); if (!res.ok) throw new Error(`HTTP ${res.status}`); return res.json(); } - 测试时就能准确捕获：
await expect(apiCall()).rejects.toThrow('HTTP 500')
用 Promise.race 给断言加“保险超时”
某些异步逻辑可能卡住（如未响应的 fetch、死循环的轮询），导致测试既不失败也不结束。加超时可强制中断并暴露问题。
- 封装 timeout 工具：
const timeout = (p, ms) => Promise.race([p, new Promise((_, r) => setTimeout(() => r(new Error('Timeout')), ms))]); - 测试中使用：
await expect(timeout(fetch('/api'), 2000)).rejects.toThrow('Timeout'); - 这不仅能防止漏断言，还能反向验证：如果本该成功却进了 timeout 分支，说明逻辑存在阻塞或未触发 resolve
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
