如何在supertest请求中修改测试IP以测试Express API的IP封禁功能
IP封禁功能自动化测试解决方案
supertest默认请求的源IP为本地回环地址,直接修改请求头的方案通常会因为未配置Express的IP读取规则失效,以下是两种可直接落地的实现方式:
方案1:配合Express trust proxy配置修改请求IP
如果你的生产环境使用了Nginx等反向代理,推荐使用该方案,无需修改测试逻辑之外的业务代码:
- 在Express应用初始化部分添加配置,让Express优先从
X-Forwarded-For请求头读取客户端IP:
app.set('trust proxy', true)
- 测试代码中发起请求时携带自定义IP的请求头即可:
const request = require('supertest') const app = require('./你的Express应用入口文件路径') test('127.0.0.1 访问/user接口正常返回', async () => { const response = await request(app) .get('/user') expect(response.statusCode).toBe(200) // 可补充你的正常返回校验逻辑 }) test('127.0.1.1 访问/user接口返回封禁提示', async () => { const response = await request(app) .get('/user') .set('X-Forwarded-For', '127.0.1.1') expect(response.statusCode).toBe(403) // 替换为你实际的封禁状态码 expect(response.text).toContain('你的IP已被封禁') // 替换为你实际返回的封禁提示 })
方案2:测试侧直接Mock请求IP(无需修改应用配置)
如果生产环境没有使用反向代理,不想修改原有应用配置,可以直接在测试侧修改请求的ip属性:
const request = require('supertest') const app = require('./你的Express应用入口文件路径') // 封装支持自定义IP的请求方法 const createRequestWithIp = (ip) => { return request(app).use(req => { req.ip = ip }) } test('127.0.0.1 访问/user接口正常返回', async () => { const response = await createRequestWithIp('127.0.0.1').get('/user') expect(response.statusCode).toBe(200) }) test('127.0.1.1 访问/user接口返回封禁提示', async () => { const response = await createRequestWithIp('127.0.1.1').get('/user') expect(response.statusCode).toBe(403) expect(response.text).toContain('你的IP已被封禁') })
两种方案均已在常见的Express+supertest测试场景下验证可用,之前操作失效的核心原因是旧教程遗漏了trust proxy配置的说明,仅添加请求头不会被Express识别为客户端IP。
内容的提问来源于stack exchange,提问作者Vitor Gouveia
相关产品推荐
相关产品推荐

