关键在于理解报错背后的“测试逻辑断层”:多数单测失败源于断言预期与实际行为不匹配或测试环境未隔离,而非语法或运行时错误。

记单元测试常见报错,关键不是死背错误字符串,而是理解报错背后的“测试逻辑断层”。它和业务代码报错不同——绝大多数单测失败,根源不在语法或运行时异常,而在断言预期与实际行为不匹配,或者测试环境没隔离干净。下面几个维度帮你高效记住、快速定位。
看报错位置:先分清是“框架报错”还是“断言失败”
真正需要你关注的,是 Jest/Vitest 等测试框架输出的红色信息中带 expected 和 received 的那一行。比如:
-
Expected: "hello"→ 你写的expect(...).toBe("hello") -
Received: "Hello"→ 实际返回值(大小写错了)
这类不是 JS 错误,是逻辑偏差。只要盯住 expected/received 对比,90% 的“报错”当场就能改对。而像 ReferenceError: jest is not defined 这类,则属于环境配置问题,说明测试文件没正确加载 Jest 全局对象。
记三类高频“非代码错误”场景
它们反复出现,但新手常归因为“代码写错了”,其实和业务逻辑无关:
-
异步没等完就断言:用了
setTimeout、fetch、Promise却没用await或done(),结果断言跑在数据回来前 → 报错通常是expected undefined或空值 -
mock 没打对地方:比如想 mock
axios.get,却写了jest.mock('axios')而没指定方法,或 mock 返回值写成{ data: ... }但实际函数返回的是整个响应对象 → 断言收不到想要的数据结构 -
状态残留:上一个 test 修改了全局变量、localStorage 或 DOM,下一个 test 拿到脏数据 → 表现为“有时通过有时失败”,需检查
beforeEach是否重置了环境
用“失败模式”代替“错误全文”来记忆
不用记完整堆栈,只记关键词组合,对应处理动作:
-
“Cannot read property X of undefined” + 出现在 expect 行 → 检查被测函数是否返回了
undefined,或 mock 返回值结构不对 -
“Received: null” / “Received: undefined” → 不是代码崩溃,是函数根本没返回值,或 async 函数忘了加
return或await -
“Jest has detected… open handles” → 测试结束前还有未清理的定时器、事件监听、未关闭的连接 → 加
afterEach(() => { jest.clearAllTimers() })
把报错当“测试说明书”来读
每次遇到新报错,别急着搜解决方案。先做两件事:
- 看报错里提到的文件名和行号,确认是不是你的测试文件(而不是源码文件)
- 复制报错中
at myTest.test.js:24:5这段,直接跳转到那行,看那里写了什么断言、调了什么函数、有没有 await
你会发现,80% 的所谓“奇怪报错”,其实是你自己写的那行 expect 和被测函数的实际输出之间,存在一个清晰可验证的 gap。











