iris.ReverseProxy需自定义http.Transport并手动处理X-Forwarded头、HTTPS重写及OPTIONS预检:设IdleConnTimeout、MaxIdleConnsPerHost、Proxy;显式设置X-Forwarded-For/Proto/Host;Director中同步改Scheme和Host;额外注册app.Options路由。

iris.ReverseProxy 不能直接用 http.DefaultTransport 会导致连接复用异常
Go 标准库的 http.DefaultTransport 默认启用了连接池和 keep-alive,但 Iris 的 iris.ReverseProxy 在构造时若直接传入该实例,可能在高并发下出现 http: proxy error: context canceled 或连接泄漏。根本原因是 ReverseProxy 内部未完全接管 transport 的超时与取消逻辑。
实操建议:
立即学习“go语言免费学习笔记(深入)”;
- 显式构造自定义
http.Transport,设置IdleConnTimeout和MaxIdleConnsPerHost,避免长连接堆积 - 禁用
ExpectContinueTimeout(设为 0),防止代理转发时因等待 100-continue 而卡住 - 务必为 transport 设置
Proxy: http.ProxyFromEnvironment,否则会绕过系统代理配置(如公司内网场景)
transport := &http.Transport{
Proxy: http.ProxyFromEnvironment,
IdleConnTimeout: 30 * time.Second,
MaxIdleConnsPerHost: 100,
ExpectContinueTimeout: 0,
}用 iris.Any().HandleFunc 做路径级转发时必须手动处理 X-Forwarded-* 头
Iris 不会自动注入 X-Forwarded-For、X-Forwarded-Proto 等头字段,后端服务若依赖这些头做鉴权或重定向,会拿到空值或错误 IP。这不是 bug,而是框架默认不篡改原始请求头的设计选择。
实操建议:
立即学习“go语言免费学习笔记(深入)”;
- 在
HandleFunc中显式读取c.RemoteAddr()并写入X-Forwarded-For(注意处理多层代理的追加逻辑) - 根据
c.Request().TLS判断是否 HTTPS,设置X-Forwarded-Proto为https或http - 若目标服务校验
X-Forwarded-Host,需从c.Host()提取并设置,而非原封不动透传(防止 header 注入)
app.Any("/api/{subpath:path}", func(c iris.Context) {
req := c.Request()
req.Header.Set("X-Forwarded-For", c.RemoteAddr())
if req.TLS != nil {
req.Header.Set("X-Forwarded-Proto", "https")
} else {
req.Header.Set("X-Forwarded-Proto", "http")
}
// 继续调用 ReverseProxy.ServeHTTP...
})转发到 HTTPS 后端时 Director 必须重写 URL.Scheme 和 URL.Host
常见错误是只改了 URL.Host 却漏掉 URL.Scheme,导致 ReverseProxy 仍用 HTTP 协议发起请求,返回 400 Bad Request 或直接拒绝连接(尤其 Nginx / Traefik 作为后端时)。
实操建议:
立即学习“go语言免费学习笔记(深入)”;
-
Director函数里必须同时设置req.URL.Scheme = "https"和req.URL.Host = "backend.example.com:443" - 若后端使用自签名证书,需在 transport 层设置
TLSClientConfig: &tls.Config{InsecureSkipVerify: true},不能只靠 Director 处理 - 避免硬编码端口:HTTPS 后端默认是 443,HTTP 是 80;显式写出端口反而容易在非标部署中出错
director := func(req *http.Request) {
req.URL.Scheme = "https"
req.URL.Host = "api.internal.company"
// 注意:不写 :443,由 Go HTTP client 自动补全
}
iris.NewReverseProxy 返回的 handler 对 OPTIONS 预检请求默认不透传
CORS 预检请求(OPTIONS)会被 Iris 默认路由匹配拦截,若没显式注册 OPTIONS 路由,会返回 404,而不是转发给后端。这和 Express/Koa 的行为不同,容易误以为是跨域配置问题。
实操建议:
立即学习“go语言免费学习笔记(深入)”;
- 必须对所有需要代理的路径,额外调用
app.Options(...)并指向同一 handler - 不要依赖
Any()拦截OPTIONS—— Iris 的Any()不包含OPTIONS方法(它属于“非标准方法”,需显式声明) - 若后端已正确返回 CORS 头,代理层无需再加
c.Header("Access-Control-Allow-Origin", "*"),重复设置可能引发浏览器报错
复杂点在于:预检请求的 Origin 和 Access-Control-Request-Method 头必须原样转发,否则后端无法判断是否允许该跨域请求。Iris 的 ReverseProxy 默认不做头过滤,这点可以放心。


















