You need to enable JavaScript to run this app. 如何在supertest请求中修改测试IP以测试Express API的IP封禁功能
优惠活动
大模型
产品
解决方案
定价
更多

如何在supertest请求中修改测试IP以测试Express API的IP封禁功能

IP封禁功能自动化测试解决方案

supertest默认请求的源IP为本地回环地址,直接修改请求头的方案通常会因为未配置Express的IP读取规则失效,以下是两种可直接落地的实现方式:

方案1:配合Express trust proxy配置修改请求IP

如果你的生产环境使用了Nginx等反向代理,推荐使用该方案,无需修改测试逻辑之外的业务代码:

  1. 在Express应用初始化部分添加配置,让Express优先从X-Forwarded-For请求头读取客户端IP:
app.set('trust proxy', true)
  1. 测试代码中发起请求时携带自定义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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.13 14:03:02