Mock 失效主因是运行时对象未替换、请求未拦截或数据结构不匹配；需确保 jest.mock() 在 import 前、URL 精确匹配、Mock 数据与接口字段/层级/类型一致，并用函数式响应处理分页等动态逻辑。
Mock 模拟失效，多数不是语法写错，而是运行时对象没被真正替换、请求没被正确拦截，或数据结构与真实接口对不上。核心就一点：你 mock 的那个东西，是不是代码里实际调用的那个。
Mock 函数没触发？先确认引用是否一致
ES Module 的静态导入机制会让模块在首次 import 时就被缓存。如果你在测试文件顶部写了 import { fn } from './utils'，再执行 jest.mock('./utils')，那 fn 已是原始函数的副本，Mock 不会覆盖它。
- 把 jest.mock() 放在所有 import 语句之前（包括被测模块）
- 改用 jest.doMock() + require() 动态加载，确保每次拿到的是新实例
- 加一行 console.log(utils.fn)，看输出是不是 [MockFunction]
- 用 expect(mockFn).toBeCalled() 验证是否真被调用，没触发说明路径不对
Mock 数据返回了，但前端解析报错？检查结构一致性
Mock 数据字段名、嵌套层级、类型必须和真实接口严格对齐。比如后端实际返回的是 data.items，你 mock 成 data.list，前端解构就会出错。
- 对照接口文档或抓包结果，逐层比对 key 名、是否包裹 data、分页字段（total/pageNum 等）
- 用 Mock.mock({ 'code': 200, 'data|10': [...] }) 生成列表时，注意 list|10 是声明数组长度，不是字段名
- 分页场景建议封装函数：getTableData(page = 1, size = 10)，动态计算 id|+1 起始值
Ajax 请求没被拦截？排查匹配规则与时机
Mock.js 的拦截依赖 URL 字符串或正则匹配。常见问题包括路径不一致（带斜杠/不带斜杠）、协议不同、代理层提前转发。
- URL 匹配要精确：Mock.mock('/api/user', ...) 不会拦截 /api/user/ 或 http://localhost:8080/api/user
- 推荐用正则：Mock.mock(/\/api\/user/, ...) 更鲁棒，忽略协议、域名、尾部斜杠
- 确保 Mock 初始化早于任何 Ajax 请求发起，Vue 项目建议在 main.js 最上方引入并执行
- Vite 或 Webpack Dev Server 开启了代理（proxy），请求可能根本没走到浏览器 XHR 层，Mock 就无从拦截
经典案例复盘：表格分页数据始终显示第一页
某 Vue 后台系统 mock 用户列表，前端传参 page=2&size=10，但 Mock 始终返回前 10 条，ID 从 1 开始递增。
- 问题根源：模板写成 'list|10': [{ 'id|+1': 1, ... }]，|+1 每次都从 1 重置，不感知 page 参数
- 修复方式：改用函数响应式拦截：Mock.mock(/\/api\/users/, (options) => { const url = new URL(options.url); const page = Number(url.searchParams.get('page')) || 1; const size = Number(url.searchParams.get('size')) || 10; return Mock.mock({ data: { list|size: [{ 'id|+1': (page-1)*size + 1, ... }] } }); })
- 延伸提醒：真实接口若用 POST 提交分页参数，Mock 也要对应监听 post 方法，并解析 options.body
