proxy_redirect 对 websocket 协议无效，因其仅处理 http 3xx 重定向的 location 头，而 websocket 握手使用 101 状态码、无 location 头；实际问题分两类：一是后端误返回 302，可用 proxy_redirect 配置修正；二是 websocket 连接失败，需正确配置 proxy_http_version、upgrade 和 connection 头。

proxy_redirect 不能用于修正 WebSocket 协议的 Location 跳转，因为 WebSocket 升级过程本身不涉及 HTTP 重定向（301/302）响应，也就不会返回 Location 响应头。

这是根本前提：
✅ proxy_redirect 只作用于上游服务器返回的 HTTP 3xx 状态码响应中的 Location、Refresh、Content-Location 头；
❌ WebSocket 握手是 HTTP 101 Switching Protocols，属于协议升级，不是重定向，没有 Location 头，因此 proxy_redirect 完全不生效。

---

那么 WebSocket 场景下“跳转问题”实际指什么？

常见误解或真实问题通常有两类：

1. 后端在 WebSocket 接口被误设计为返回 302（极少见但存在）

例如某些 Spring Boot + STOMP 配置错误，或前端误请求了需登录跳转的路径（如 /ws 实际被拦截重定向到 /login），此时：

• 真实返回的是 302 Location: /login
• 这属于普通 HTTP 重定向，proxy_redirect 可照常处理
  ✅ 解决方式：按标准 HTTP 重定向配置，例如

  location /ws {
    proxy_pass http://backend;
    proxy_redirect / /ws;  # 若后端跳转到 /login，改为 /ws/login
    # 或更稳妥：
    proxy_redirect ~^https?://[^/]+(/.*)$ $scheme://$host/ws$1;
  }

⚠️ 注意：这种场景本质是「WebSocket 路径被网关层拦截并重定向」，不是 WebSocket 自身行为。

FastAPI Flask Proxy

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

下载

2. WebSocket 连接失败，浏览器控制台报 net::ERR_CONNECTION_REFUSED 或 Error during WebSocket handshake

这不是 Location 问题，而是：

• 后端 WebSocket 地址写死为 ws://localhost:8080/endpoint（前端 JS 直连）
• 或 Nginx 未正确透传 WebSocket 升级头

✅ 正确解法是确保 Nginx 完整支持 WebSocket 代理，重点配置以下三项：

location /ws {
    proxy_pass http://backend;

    # 必须透传升级请求头
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";

    # 传递原始协议，便于后端生成正确 ws/wss URL（如做鉴权回调）
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_set_header Host $host;

    # 可选：防止长连接被代理中断
    proxy_read_timeout 86400;
}

✅ ws:// → wss:// 的协议适配，靠前端 JS 根据 window.location.protocol 动态构造 URL（如 wss://example.com/ws），Nginx 不参与协议转换。

---

总结关键点

• proxy_redirect 对纯 WebSocket（101 Switching Protocols）完全无效，它不处理协议升级；
• 若看到 Location 头，说明当前响应是 HTTP 重定向（3xx），不是 WebSocket 成功握手；
• WebSocket 连接异常，请检查：
  • 后端是否返回了 302（而非 101）；
  • Nginx 是否配置了 Upgrade 和 Connection 头；
  • 前端是否用 wss:// 请求，且域名、路径与 Nginx location 严格匹配；
• 真正需要 proxy_redirect 的，永远是后端「非 WebSocket 路由」意外触发的跳转（如登录守卫、OAuth 回调跳转等）。

不复杂但容易忽略。