异步测试中断言提前结束，本质是测试函数在异步操作完成前就返回，关键要等待异步行为真正完成的信号；需确保测试函数返回Promise或标记为async，避免setTimeout延时，正确mock并启用超时和日志调试。
异步测试中断言提前结束，本质是测试函数在异步操作完成前就返回了，导致断言没执行或检查了未就绪的状态。关键不是“等多久”，而是“等什么”——要明确等待异步行为真正完成的信号。
确保测试函数正确返回 Promise 或标记异步
这是最常见也最容易被忽略的起点。Jest、Vitest 等框架会自动等待测试函数返回的 Promise 被 resolve；若函数是 async 或显式 return 一个 Promise，测试才会挂起直到它 settle。
- ❌ 错误写法（测试立即结束）：
test('fetches user', () => {
api.getUser().then(user => expect(user.name).toBe('Alice'));
});
此处没有 return，Promise 被丢弃，测试不等待，断言可能根本没运行。 - ✅ 正确写法（三种等效方式）：
test('fetches user', async () => {
const user = await api.getUser();
expect(user.name).toBe('Alice');
});
或
test('fetches user', () => {
return api.getUser().then(user => expect(user.name).toBe('Alice'));
});
或（Vitest 支持）
test('fetches user', () => expect(api.getUser()).resolves.toMatchObject({ name: 'Alice' }));
避免依赖 setTimeout 或固定延时等待
用 setTimeout(() => { ... }, 100) 模拟“等一下”看似简单，实则脆弱：网络快时浪费时间，慢时仍可能失败；还掩盖了真正的完成条件。
- ❌ 不推荐：
test('updates UI after save', done => {
saveData();
setTimeout(() => {
expect(screen.getByText('Saved!')).toBeInTheDocument();
done();
}, 300);
}); - ✅ 推荐：用可观察的状态变化作为等待依据，例如：
- 使用 waitFor（Jest + @testing-library/react）：
await waitFor(() => expect(screen.getByText('Saved!')).toBeInTheDocument());
- 或等待某个 Promise 完成（如 mock 的 API 调用已 resolve）；
- 或监听组件内部状态（如通过 act + waitFor 触发并验证更新）。
检查 Mock 是否真正触发了回调或 resolve
异步逻辑常依赖外部服务，我们用 mock 替代。但若 mock 写得不完整（比如只定义了函数却没调用 resolve 或触发 callback），测试就会卡住或跳过断言。
立即学习“Java免费学习笔记（深入）”；
- ❌ 常见疏漏：
jest.mock('./api', () => ({
getUser: jest.fn(), // ❌ 没返回 Promise，也没 resolve
})); - ✅ 正确 mock 示例：
jest.mock('./api', () => ({
getUser: jest.fn().mockResolvedValue({ id: 1, name: 'Alice' }),
}));
或手动控制：
const mockGetUser = jest.fn();
jest.mock('./api', () => ({ getUser: mockGetUser }));
// 在测试中：
mockGetUser.mockImplementation(() => Promise.resolve({ name: 'Alice' }));
启用测试超时和调试日志定位卡点
当测试“静默失败”（没报错但断言没生效），很可能是 Promise 一直 pending。给测试加 timeout 并打印中间状态，能快速暴露问题环节。
- 在 test 中加超时（Jest）：
test('handles error gracefully', async () => {
jest.setTimeout(5000); // 允许最长 5 秒
await api.fetchWithError();
console.log('after fetch'); // 看这行是否打印
expect(...).toBe(...);
}, 5000); - 对关键 Promise 添加 .catch(e => console.error('Promise rejected:', e))，确认是否意外 reject 而没被捕获。
