jest测试中，若仅用`spyon`模拟模块方法而未彻底隔离依赖，mock状态可能跨测试残留，导致`tohavebeencalledtimes(1)`断言在第二例中意外失败为2次；正确做法是结合`jest.mock()`对整个模块进行自动模拟，确保每个测试拥有干净、独立的mock环境。
在 Jest 中，spyOn 本质上是对已存在对象的方法进行监听和替换，但它不会重置模块的原始引用或内部状态。你当前的配置虽启用了 clearMocks: true、restoreMocks: true 和 resetMocks: true，并手动在 afterEach 中调用 jest.clearAllMocks() 和 jest.restoreAllMocks()，但这些操作无法清除模块顶层导出对象（如 sequelize）上已被 spyOn 修改过的属性引用——尤其当该对象被其他模块（如 app 或数据库中间件）提前持有并复用时，spyOn(sequelize, 'query') 创建的 spy 可能被多次绑定或触发，造成调用计数“累积”。
更关键的是：你的 Express 应用 app 在 require("../../server") 时，很可能已内部导入并缓存了 sequelize 实例。因此，即使你在每个 it 块中重新 spyOn，实际被调用的仍是同一个被污染的 sequelize.query 方法引用，且 mockResolvedValueOnce 的“一次性”行为在多个测试间并不天然隔离。
✅ 正确解法：使用 jest.mock("../../sequelize") 对整个模块进行自动模拟（auto-mocking）。这会：
- 在模块加载前拦截 require，生成一个全新的、完全可控的 mock 模块；
- 所有导出（包括 sequelize 对象及其方法）默认为 jest.fn()，可自由配置返回值；
- 每个测试文件（或 describe 块）中，该 mock 是独立实例（除非显式 jest.unmock），天然避免跨测试污染；
- 配合 jest.resetModules()（你已在配置中启用），可进一步确保模块重载时 mock 状态清零。
以下是修正后的推荐写法：
// ✅ 正确：在文件顶部 mock 整个模块（必须位于 import 之后、describe 之前）
const request = require("supertest");
const app = require("../../server");
// 注意：此处不能直接解构 sequelize，否则会破坏 mock 生效时机
const sequelizeModule = require("../../sequelize"); // 仅用于类型/占位，实际将被 mock 替换
// ? 关键：mock 整个模块，确保 sequelize 是全新 mock 对象
jest.mock("../../sequelize");
describe("API routes tests", () => {
// 可选：在 beforeEach 中重置 mock，增强确定性
beforeEach(() => {
// 获取 mock 后的 sequelize 实例（注意：必须在 mock 后获取）
const { sequelize } = require("../../sequelize");
// 重置其 query 方法，确保每次测试从干净状态开始
sequelize.query.mockReset();
});
describe("GET /api/my-route", () => {
it("Test 1", async () => {
const { sequelize } = require("../../sequelize");
const mockedResponse = [{ log: 1 }, { log: 2 }];
// 配置 mock 行为（无需 spyOn，直接设置 mock 实现）
sequelize.query.mockResolvedValueOnce(mockedResponse);
const response = await request(app)
.get("/api/user-activity-logs")
.query(defaultQueryParams);
expect(sequelize.query).toHaveBeenCalledTimes(1);
expect(response.status).toBe(200);
expect(response.body).toHaveProperty("groupedLogs", mockedResponse);
});
it("Test 2", async () => {
const { sequelize } = require("../../sequelize");
const mockedResponse = [{ log: 3 }, { log: 4 }];
sequelize.query.mockResolvedValueOnce(mockedResponse);
const response = await request(app)
.get("/api/user-activity-logs")
.query(defaultQueryParams);
expect(sequelize.query).toHaveBeenCalledTimes(1); // ✅ 现在稳定通过
expect(response.status).toBe(200);
expect(response.body).toHaveProperty("groupedLogs", mockedResponse);
});
});
});⚠️ 注意事项：
- jest.mock() 必须写在文件顶部（在任何 require 或 import 使用目标模块之后，但在 describe 之前），Jest 会自动提升（hoist）它，但显式位置可读性更强；
- 不要再对 sequelize.query 使用 spyOn —— 因为此时 sequelize 已是 mock 对象，其 query 属性本身就是 jest.fn()；
- 若需模拟不同返回值，优先使用 mockResolvedValueOnce / mockRejectedValueOnce，而非 mockResolvedValue（后者会永久生效）；
- 移除 afterEach 中冗余的 jest.clearAllMocks() 和 jest.restoreAllMocks()，改用 beforeEach + mockReset() 更精准控制；
- 确保 defaultQueryParams 在测试中已正确定义（如 const defaultQueryParams = { page: 1 };），避免因变量未定义引发隐式错误。
总结：spyOn 适用于临时监听外部不可控对象（如全局 fetch），而测试中涉及自身依赖模块时，应优先采用 jest.mock() 进行模块级隔离——这是 Jest 单元测试可靠性的基石。
