测试与调试错误
50 个错误
测试常见错误排查手册:测试不稳定、Mock 失效、异步断言失败等问题的定位与修复。
50 / 50
- 1
AssertionError: Expected 值到 是 equal
大多数常见测试失败: 你的 assertion expected one 值但 获取 another. 错误消息 shows 两者都值 到 help 你 diagnose mismatch.
- 2
TypeError: jest.fn 是不 函数
测试 tries 到 use jest.fn() 但 Jest 是不 available in current 环境. 这个 happens 当测试 runner isn't Jest or Jest isn't 配置.
- 3
异步测试不 Awaiting Promise
测试函数返回之前异步操作 completes. Jest marks 测试 as 通过不使用运行 assertions, giving 假正.
- 4
Snapshot Mismatch
输出的 你的 code 更改由于 snapshot 是最后保存. 这个能 是 intentional 更改 or bug — 你需要到 review diff.
- 5
测试 Timeout Exceeded
测试 didn't finish 在内 timeout period. 这个通常平均值异步操作是 hanging or 测试是 做也 much 工作.
- 6
Mock 不 Called
assertion toHaveBeenCalled() 失败因为 mock 是从不 called. 你的 code path didn't 触发 expected 函数 call.
- 7
Cannot 查找模块
Jest 能't 查找模块你're trying 到导入. path 可能是 错误, file 可能不 exist, or Jest's 模块 resolution isn't 配置正确地.
- 8
ReferenceError: 描述是 不定义
测试 uses Jest globals (描述, 测试, expect) 但它们're 不定义. Jest 是要么不 测试 runner or globals aren't 配置.
- 9
Coverage Below Threshold
你的测试 suite 通过, 但 coverage 是 below 配置 threshold. 新 code 是添加不使用 sufficient 测试.
- 10
Spy 不 Restored
spy replaced 真实函数但 是从不 restored, 所以 spy persists 到 other 测试, causing unexpected behavior.
- 11
Expected 到 Throw 但做 不
测试 expected code 到 throw 错误, 但它 didn't. 要么 code 应该 throw 但 doesn't (bug), or 测试 expectation 是错误.
- 12
toBe Used on 对象 (引用 Inequality)
toBe uses 对象.是 (引用 equality). Two separately 创建对象是 不同引用, 所以 toBe 失败偶数 for identical 内容. Use toEqual for deep equality.
- 13
测试不 运行 (File 不 Discovered)
Jest 能't 查找你的测试 files. files 可能不 match Jest's naming 约定 or testMatch 配置是 错误.
- 14
Unhandled Promise Rejection in 测试
异步操作拒绝 (threw 错误) 但测试 didn't catch 它. 这个能 cause 测试到 通过不正确地 or crash unexpectedly.
- 15
Mock Implementation 不正确
mock's 返回值 doesn't match 什么测试 expects. mock 设置 (mockReturnValue, mockResolvedValue) 有错误值.
- 16
Floating 点 Comparison 失败
JavaScript floating-点 arithmetic 是 imprecise. 0.1 + 0.2 equals 0.30000000000000004, 不 0.3. Using toBe for 精确 comparison 失败.
- 17
测试顺序 Dependency
测试 depends on 状态左 通过 other 测试. 当运行 alone 它设置上 它的 own 状态, 但 in 完整 suite, 上一个测试有 修改 shared 状态.
- 18
Cannot 读取属性的 undefined
code or 测试 tries 到 access 属性 on undefined 值. mock 可能不 是配置到 返回 expected 对象.
- 19
Missing 做() 回调 in 异步测试
测试 uses 做回调模式但 forgets 到 call 做() 内部异步回调. Jest marks 测试 as 完整之前 assertion 运行.
- 20
否 Assertions in 测试
测试已完成不使用 calling expect(). 不使用 assertions, 测试总是通过 — 偶数如果 code 是 completely broken.
- 21
toMatchObject 部分 Match 失败
toMatchObject 检查那个接收对象包含 at 最少 expected 属性使用 matching 值. 属性值 didn't match.
- 22
Fake Timer 不 Restored
Fake timers 是启用但 从不 restored 到真实 timers, causing 时间-related issues in subsequent 测试.
- 23
Enzyme 方法不 找到 (React 测试)
测试 uses Enzyme APIs (查找, simulate, shallow) 但 Enzyme 是不 安装, 不配置, or 方法 doesn't exist on wrapper.
- 24
元素不 找到 in DOM 测试
测试 tries 到查找元素 (通过 role, 文本, testId) 但它 doesn't exist in rendered 组件. 元素可能不 是 rendered or 查询是 错误.
- 25
多个元素找到
查询找到更多 than one 元素. getBy* 查询必须查找精确地 one match — use getAllBy* for 多个 matches.
- 26
测试 File 语法错误
测试 file 包含语法错误 — typo, missing bracket, or unsupported 语法. Jest 能't parse and 运行 file.
- 27
Circular 引用 in Snapshot
对象通过到 toMatchSnapshot() 有 circular 引用 (对象那个引用它自己), 哪个能't 是 serialized.
- 28
E2E 测试 Timeout Waiting for 元素
E2E 测试 waited for 元素那个从不 appeared 在内 timeout. page 可能不 有加载, or 元素 doesn't exist.
- 29
Jest 配置错误
jest.配置.js or Jest 配置 in 包.JSON 有无效设置, causing Jest 到失败之前运行任何测试.
- 30
Memory Leak in 长测试 Suite
测试 suite consumes 也 much memory, causing 节点.js 到 crash 使用 out-的-memory 错误. 这个 happens 使用 very 大测试 suites or memory leaks.
- 31
测试超时:异步测试未完成
你的测试超时了 —— 异步操作或 promise 未在超时时间内 resolve 或 reject。
- 32
Mock 未被调用:预期交互未发生
你的测试期望 mock 被调用,但代码路径未触发被 mock 的函数。
- 33
Fixture 未找到:测试数据文件缺失
你的测试尝试加载 fixture 文件,但在指定路径找不到该文件。
- 34
测试隔离失败:测试间共享状态
你的测试共享状态 —— 一个测试修改的数据会影响另一个测试的结果,取决于执行顺序。
- 35
快照不匹配:UI 或输出已更改
你的快照测试失败 —— 输出与存储的快照不同,可能是故意更改或回归。
- 36
测试中未处理的 promise 拒绝
你的测试有未处理的 promise 拒绝 —— promise 被 reject 但没有 .catch() 或 try/catch 处理它。
- 37
长时间运行测试套件的内存泄漏
你的测试套件泄漏内存 —— 对象、监听器或连接累积且未在测试间清理。
- 38
缺少测试装饰器或注解
你的测试函数未被测试运行器识别 —— 缺少 @test 装饰器或 test() 包装。
- 39
无效断言:匹配器不存在
你的测试使用了测试框架不识别的匹配器,如 toBeGreaterThan 或 toMatchSnapshot。
- 40
测试断言中的类型不匹配
你的断言比较不同类型的值 —— 匹配器无法比较字符串和数字等。
- 41
测试文件中缺少导入
你的测试使用了未导入的函数或类 —— 测试在运行时以 ReferenceError 失败。
- 42
无效测试配置:未知选项
你的测试配置有未知选项 —— 测试框架拒绝配置或忽略该选项。
- 43
测试 setup 中的循环依赖
你的测试 setup 有循环导入 —— 模块 A 导入模块 B,模块 B 又导入模块 A,导致不完整初始化。
- 44
不稳定测试:间歇性通过和失败
你的测试不稳定 —— 由于非确定性行为,有时通过有时失败。
- 45
测试实现而非行为
你的测试检查代码内部如何工作而非它做什么 —— 重构会破坏测试即使行为未变。
- 46
测试覆盖不足:缺少边界情况
你的测试只覆盖了典型情况 —— 边界情况、错误路径和边界值未被测试。
- 47
过度 mock:测试测试的是 mock 而非代码
你的测试 mock 了太多,以至于测试的是 mock 设置而非实际被测代码。
- 48
无消息断言:失败不清晰
你的断言失败了但错误消息是通用的 —— 不清楚预期什么和收到了什么。
- 49
测试依赖环境:在 CI 失败但本地通过
你的测试在本地通过但在 CI 中失败 —— 它依赖环境特定的设置或资源。
- 50
未使用的测试 setup:beforeEach 无清理
你的 beforeEach 创建资源但没有 afterEach 清理 —— 后续测试受残留状态影响。
未找到相关错误。