Skip to content
🧪

测试与调试错误

50 个错误

测试常见错误排查手册:测试不稳定、Mock 失效、异步断言失败等问题的定位与修复。

50 / 50

  1. 1

    AssertionError: Expected 值到 是 equal

    大多数常见测试失败: 你的 assertion expected one 值但 获取 another. 错误消息 shows 两者都值 到 help 你 diagnose mismatch.

  2. 2

    TypeError: jest.fn 是不 函数

    测试 tries 到 use jest.fn() 但 Jest 是不 available in current 环境. 这个 happens 当测试 runner isn't Jest or Jest isn't 配置.

  3. 3

    异步测试不 Awaiting Promise

    测试函数返回之前异步操作 completes. Jest marks 测试 as 通过不使用运行 assertions, giving 假正.

  4. 4

    Snapshot Mismatch

    输出的 你的 code 更改由于 snapshot 是最后保存. 这个能 是 intentional 更改 or bug — 你需要到 review diff.

  5. 5

    测试 Timeout Exceeded

    测试 didn't finish 在内 timeout period. 这个通常平均值异步操作是 hanging or 测试是 做也 much 工作.

  6. 6

    Mock 不 Called

    assertion toHaveBeenCalled() 失败因为 mock 是从不 called. 你的 code path didn't 触发 expected 函数 call.

  7. 7

    Cannot 查找模块

    Jest 能't 查找模块你're trying 到导入. path 可能是 错误, file 可能不 exist, or Jest's 模块 resolution isn't 配置正确地.

  8. 8

    ReferenceError: 描述是 不定义

    测试 uses Jest globals (描述, 测试, expect) 但它们're 不定义. Jest 是要么不 测试 runner or globals aren't 配置.

  9. 9

    Coverage Below Threshold

    你的测试 suite 通过, 但 coverage 是 below 配置 threshold. 新 code 是添加不使用 sufficient 测试.

  10. 10

    Spy 不 Restored

    spy replaced 真实函数但 是从不 restored, 所以 spy persists 到 other 测试, causing unexpected behavior.

  11. 11

    Expected 到 Throw 但做 不

    测试 expected code 到 throw 错误, 但它 didn't. 要么 code 应该 throw 但 doesn't (bug), or 测试 expectation 是错误.

  12. 12

    toBe Used on 对象 (引用 Inequality)

    toBe uses 对象.是 (引用 equality). Two separately 创建对象是 不同引用, 所以 toBe 失败偶数 for identical 内容. Use toEqual for deep equality.

  13. 13

    测试不 运行 (File 不 Discovered)

    Jest 能't 查找你的测试 files. files 可能不 match Jest's naming 约定 or testMatch 配置是 错误.

  14. 14

    Unhandled Promise Rejection in 测试

    异步操作拒绝 (threw 错误) 但测试 didn't catch 它. 这个能 cause 测试到 通过不正确地 or crash unexpectedly.

  15. 15

    Mock Implementation 不正确

    mock's 返回值 doesn't match 什么测试 expects. mock 设置 (mockReturnValue, mockResolvedValue) 有错误值.

  16. 16

    Floating 点 Comparison 失败

    JavaScript floating-点 arithmetic 是 imprecise. 0.1 + 0.2 equals 0.30000000000000004, 不 0.3. Using toBe for 精确 comparison 失败.

  17. 17

    测试顺序 Dependency

    测试 depends on 状态左 通过 other 测试. 当运行 alone 它设置上 它的 own 状态, 但 in 完整 suite, 上一个测试有 修改 shared 状态.

  18. 18

    Cannot 读取属性的 undefined

    code or 测试 tries 到 access 属性 on undefined 值. mock 可能不 是配置到 返回 expected 对象.

  19. 19

    Missing 做() 回调 in 异步测试

    测试 uses 做回调模式但 forgets 到 call 做() 内部异步回调. Jest marks 测试 as 完整之前 assertion 运行.

  20. 20

    否 Assertions in 测试

    测试已完成不使用 calling expect(). 不使用 assertions, 测试总是通过 — 偶数如果 code 是 completely broken.

  21. 21

    toMatchObject 部分 Match 失败

    toMatchObject 检查那个接收对象包含 at 最少 expected 属性使用 matching 值. 属性值 didn't match.

  22. 22

    Fake Timer 不 Restored

    Fake timers 是启用但 从不 restored 到真实 timers, causing 时间-related issues in subsequent 测试.

  23. 23

    Enzyme 方法不 找到 (React 测试)

    测试 uses Enzyme APIs (查找, simulate, shallow) 但 Enzyme 是不 安装, 不配置, or 方法 doesn't exist on wrapper.

  24. 24

    元素不 找到 in DOM 测试

    测试 tries 到查找元素 (通过 role, 文本, testId) 但它 doesn't exist in rendered 组件. 元素可能不 是 rendered or 查询是 错误.

  25. 25

    多个元素找到

    查询找到更多 than one 元素. getBy* 查询必须查找精确地 one match — use getAllBy* for 多个 matches.

  26. 26

    测试 File 语法错误

    测试 file 包含语法错误 — typo, missing bracket, or unsupported 语法. Jest 能't parse and 运行 file.

  27. 27

    Circular 引用 in Snapshot

    对象通过到 toMatchSnapshot() 有 circular 引用 (对象那个引用它自己), 哪个能't 是 serialized.

  28. 28

    E2E 测试 Timeout Waiting for 元素

    E2E 测试 waited for 元素那个从不 appeared 在内 timeout. page 可能不 有加载, or 元素 doesn't exist.

  29. 29

    Jest 配置错误

    jest.配置.js or Jest 配置 in 包.JSON 有无效设置, causing Jest 到失败之前运行任何测试.

  30. 30

    Memory Leak in 长测试 Suite

    测试 suite consumes 也 much memory, causing 节点.js 到 crash 使用 out-的-memory 错误. 这个 happens 使用 very 大测试 suites or memory leaks.

  31. 31

    测试超时:异步测试未完成

    你的测试超时了 —— 异步操作或 promise 未在超时时间内 resolve 或 reject。

  32. 32

    Mock 未被调用:预期交互未发生

    你的测试期望 mock 被调用,但代码路径未触发被 mock 的函数。

  33. 33

    Fixture 未找到:测试数据文件缺失

    你的测试尝试加载 fixture 文件,但在指定路径找不到该文件。

  34. 34

    测试隔离失败:测试间共享状态

    你的测试共享状态 —— 一个测试修改的数据会影响另一个测试的结果,取决于执行顺序。

  35. 35

    快照不匹配:UI 或输出已更改

    你的快照测试失败 —— 输出与存储的快照不同,可能是故意更改或回归。

  36. 36

    测试中未处理的 promise 拒绝

    你的测试有未处理的 promise 拒绝 —— promise 被 reject 但没有 .catch() 或 try/catch 处理它。

  37. 37

    长时间运行测试套件的内存泄漏

    你的测试套件泄漏内存 —— 对象、监听器或连接累积且未在测试间清理。

  38. 38

    缺少测试装饰器或注解

    你的测试函数未被测试运行器识别 —— 缺少 @test 装饰器或 test() 包装。

  39. 39

    无效断言:匹配器不存在

    你的测试使用了测试框架不识别的匹配器,如 toBeGreaterThan 或 toMatchSnapshot。

  40. 40

    测试断言中的类型不匹配

    你的断言比较不同类型的值 —— 匹配器无法比较字符串和数字等。

  41. 41

    测试文件中缺少导入

    你的测试使用了未导入的函数或类 —— 测试在运行时以 ReferenceError 失败。

  42. 42

    无效测试配置:未知选项

    你的测试配置有未知选项 —— 测试框架拒绝配置或忽略该选项。

  43. 43

    测试 setup 中的循环依赖

    你的测试 setup 有循环导入 —— 模块 A 导入模块 B,模块 B 又导入模块 A,导致不完整初始化。

  44. 44

    不稳定测试:间歇性通过和失败

    你的测试不稳定 —— 由于非确定性行为,有时通过有时失败。

  45. 45

    测试实现而非行为

    你的测试检查代码内部如何工作而非它做什么 —— 重构会破坏测试即使行为未变。

  46. 46

    测试覆盖不足:缺少边界情况

    你的测试只覆盖了典型情况 —— 边界情况、错误路径和边界值未被测试。

  47. 47

    过度 mock:测试测试的是 mock 而非代码

    你的测试 mock 了太多,以至于测试的是 mock 设置而非实际被测代码。

  48. 48

    无消息断言:失败不清晰

    你的断言失败了但错误消息是通用的 —— 不清楚预期什么和收到了什么。

  49. 49

    测试依赖环境:在 CI 失败但本地通过

    你的测试在本地通过但在 CI 中失败 —— 它依赖环境特定的设置或资源。

  50. 50

    未使用的测试 setup:beforeEach 无清理

    你的 beforeEach 创建资源但没有 afterEach 清理 —— 后续测试受残留状态影响。

← 返回错误