proxypassreverse 正确处理非标准端口跳转的关键是严格匹配后端返回的 location 地址格式（协议、ip/域名、端口、路径前缀），仅做字符串前缀替换；配置必须与后端实际响应头完全一致，否则失效。

ProxyPassReverse 要正确处理非标准端口后端的跳转，关键不是“适配端口”，而是**严格匹配后端实际返回的 Location 地址格式**——包括协议、IP（或域名）、端口和路径前缀。它本身不改端口逻辑，只做字符串前缀替换；端口写错或漏写，就完全失效。

必须把后端返回的真实地址完整写进 ProxyPassReverse

后端服务监听在 127.0.0.1:3000，但返回的跳转头是：

Location: http://127.0.0.1:3000/callback

那么 ProxyPassReverse 必须写成：

• ProxyPassReverse / http://127.0.0.1:3000/ ✅（协议+IP+端口全对）
• ProxyPassReverse / http://127.0.0.1/ ❌（漏端口，不匹配）
• ProxyPassReverse / http://localhost:3000/ ❌（域名不一致，不匹配）
• ProxyPassReverse / https://127.0.0.1:3000/ ❌（协议不一致，即使你用 HTTPS 访问，后端返回的是 HTTP）

HTTPS 场景下，端口 + 协议要双重对齐

用户访问 https://app.example.com，Apache 代理到 http://127.0.0.1:8081，但后端生成跳转时可能错误拼出：

FastAPI Flask Proxy

FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。

下载

Location: http://127.0.0.1:8081/login

这时 ProxyPassReverse 仍需写 HTTP + 端口：

• ProxyPassReverse / http://127.0.0.1:8081/ ✅（匹配后端真实输出）
• 同时加：RequestHeader set X-Forwarded-Proto "https"，让后端识别协议，避免它下次还生成 http:// 地址

子路径代理时，端口与路径层级必须同步

比如后端运行在 192.168.1.5:9002/v2，且所有跳转都带 /v2/ 前缀：

Location: http://192.168.1.5:9002/v2/dashboard

那么配置必须是：

• ProxyPass /api/ http://192.168.1.5:9002/v2/
• ProxyPassReverse /api/ http://192.168.1.5:9002/v2/ ✅（端口+路径层级完全一致）
• 不能写成 ProxyPassReverse /api/ http://192.168.1.5:9002/ ❌（少 /v2/，无法替换 /v2/dashboard）

验证是否生效：直接看响应头

别猜，用 curl 实测后端真实返回什么：

• curl -I https://your-domain.com/login
• 检查返回的 Location: 值是不是已变成 https://your-domain.com/callback
• 如果不是，说明 ProxyPassReverse 没命中——立刻比对：协议、IP、端口、斜杠、路径前缀，缺一不可