如何在Express+TypeScript单元测试中模拟请求响应以满足VSCode编译器

我完全懂你这个痛点——Jest测试里随便传个空对象确实能跑，但VSCode的红色波浪线和TS编译器的报错看着真闹心😅。下面几种方法都是我实际项目里用过的，能完美解决类型问题：

方法1：手动模拟基础属性（适合简单场景） #

如果你的控制器只用到了req的少数属性（比如body、params），可以手动创建符合Request类型的对象，只填充需要的部分：

import { Request, Response } from 'express';

// 模拟请求对象，仅填充测试需要的属性
const mockReq = {
  body: { username: 'testUser', password: '123456' },
  params: { id: '123' }
} as Request;

// 模拟响应对象，常用方法用jest.mock实现链式调用
const mockRes = {
  json: jest.fn().mockReturnThis(),
  status: jest.fn().mockReturnThis(),
  send: jest.fn().mockReturnThis()
} as unknown as Response;

这里用as unknown as Response是因为我们只模拟了常用方法，TS默认会要求实现所有Response的属性，双重类型断言可以绕开这个要求，同时保留类型提示。

方法2：用Jest自动模拟（更优雅） #

可以让Jest自动模拟Express的类型，再补全测试需要的自定义属性：

import { Request, Response } from 'express';

jest.mock('express', () => ({
  Request: jest.fn(),
  Response: jest.fn(),
}));

// 初始化模拟对象并添加测试所需属性
const req = {
  body: { email: 'test@example.com' }
} as Request;

const res = {
  json: jest.fn(),
  status: jest.fn().mockReturnThis()
} as unknown as Response;

这种方式适合需要多次复用模拟对象的场景，不用每次都手动写重复的mock方法。

方法3：使用第三方模拟库（推荐复杂项目） #

如果测试需要覆盖更多Express特性（比如req.query、req.headers，或者res.cookie这类方法），可以用专门的模拟库，比如jest-mock-express：

首先安装依赖：

npm install jest-mock-express --save-dev

然后在测试里使用：

import { mockRequest, mockResponse } from 'jest-mock-express';

// 创建完全符合TypeScript类型的模拟对象
const req = mockRequest({
  body: { title: 'Test Post' },
  params: { postId: '456' }
});

const res = mockResponse();

// 调用控制器后直接断言
yourController(req, res);
expect(res.status).toHaveBeenCalledWith(200);
expect(res.json).toHaveBeenCalledWith({ success: true });

这个库会自动实现所有ExpressRequest和Response的方法与属性，TS完全不会报错，断言起来也非常顺手。

方法4：扩展Express类型（处理自定义属性） #

如果需要模拟自定义的请求属性（比如req.user），可以先扩展Express的类型：

在项目根目录创建types/express.d.ts文件：

declare namespace Express {
  export interface Request {
    user?: { id: string; username: string };
  }
}

然后在测试里模拟：

const req = {
  user: { id: '789', username: 'customUser' },
  body: {}
} as Request;

这样TS就能识别你自定义的req.user属性，不会再抛出类型错误。

总结一下：简单场景用手动模拟或Jest自动模拟，复杂项目直接用第三方库，自定义属性就扩展Express类型——这些方法都能解决VSCode和TS编译器的报错问题，同时让你的测试更规范。

内容的提问来源于stack exchange，提问作者Scott