WebSocket与HTTP共用同一端口为何冲突，该如何解决？

问题原因 #

当前所有端口流量都被WebSocket服务优先拦截处理，没有对请求路径、请求头做区分路由：只有请求路径匹配/ws、且带WebSocket要求的Upgrade: websocket头的请求才应该交给WebSocket服务处理，其他普通HTTP请求被误送到WebSocket服务后，就会触发你看到的报错。

解决方案 #

方案1：用Nginx反向代理做路由分发（最通用） #

在Nginx配置同一监听端口下，按路径匹配转发到不同的后端服务：

server {
    listen eeee;
    server_name aaa.bbb.cc.ddd;

    # 匹配ws路径的请求转发给WebSocket服务
    location /ws {
        proxy_pass http://你的WebSocket服务本地监听地址;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
    }

    # 其他所有请求转发给HTTP服务
    location / {
        proxy_pass http://你的HTTP服务本地监听地址;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

配置后重启Nginx即可，注意WebSocket和HTTP服务要改成监听本地不同的端口，不要直接占用对外的eeee端口。

方案2：自研服务代码层做路由判断 #

如果是自己实现的底层服务，没有用反向代理，直接在请求入口加判断逻辑：

• 先判断请求是否带Connection: Upgrade头、Upgrade: websocket头，且请求路径为/ws：符合条件的交给WebSocket逻辑处理
• 其余所有请求全部交给HTTP服务逻辑处理

方案3：框架自带路由适配 #

如果用的是支持单端口同时托管HTTP和WebSocket的框架（比如FastAPI、Spring Boot、Gin等），直接按框架官方文档配置WebSocket的路径为/ws即可，框架原生会自动做请求区分，不会出现WebSocket拦截全局请求的问题。

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