Express中http-proxy-middleware配置动态target代理失效解决方案

你写的两种实现不生效都是写法不符合库的调用规则，具体原因和正确写法如下：

错误写法原因 #

• 第一种自定义中间件的写法：仅在路由回调里执行了createProxyMiddleware生成代理实例，但没有把请求对应的req/res/next参数传给代理实例执行，请求进入回调后没有任何处理逻辑，会直接挂起超时。
• 第二种router配置的写法：首先target字段不允许传空字符串，库初始化阶段会校验target合法性，空值直接导致初始化失败；其次TS类型标注错误，router的入参是请求对象不是字符串，错误的类型标注会导致resolveApiUrl拿不到正确的入参，返回异常的目标地址。

推荐实现（官方标准写法） #

直接使用库内置的router配置项实现动态target，性能最好也最稳定，注意必须配置一个合法的默认target作为兜底：

server.use('/login', createProxyMiddleware({
  target: 'https://default.example.com', // 兜底默认地址，不可留空
  changeOrigin: true,
  logLevel: 'debug', // 调试阶段可开启，控制台会打印实际代理目标方便排查
  router: (req) => {
    // 直接调用自定义解析逻辑即可，确保返回值是带http/https协议的完整域名
    return resolveApiUrl(req)
  }
}))

自定义中间件写法（适合需要额外前置逻辑的场景） #

如果需要在代理前加额外的鉴权、参数处理逻辑，可以在自定义中间件里手动调度代理实例，注意要做实例缓存避免重复创建导致内存泄漏：

// 缓存不同target对应的代理实例，避免每次请求重复生成
const proxyInstanceMap = new Map()

server.use('/login', (req, res, next) => {
  const currentTarget = resolveApiUrl(req)
  // 不存在对应实例则初始化
  if (!proxyInstanceMap.has(currentTarget)) {
    proxyInstanceMap.set(currentTarget, createProxyMiddleware({
      target: currentTarget,
      changeOrigin: true
    }))
  }
  // 关键：必须把req/res/next传给代理实例执行，才能完成代理转发
  const targetProxy = proxyInstanceMap.get(currentTarget)
  return targetProxy(req, res, next)
})

注意事项 #

• resolveApiUrl的返回值必须是带协议的完整URL格式，例如https://pretest.test.example，不能仅返回域名、不能遗漏协议头，否则会导致代理路径拼接错误。
• 如果代理目标是自签名HTTPS证书的测试环境，可加secure: false配置跳过证书校验。
• 如果出现cookie不生效、跨域报错问题，可搭配cookieDomainRewrite: {'*': ''}配置重写cookie域名。

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