You need to enable JavaScript to run this app. Supervisor运行正常但本地Laravel Websockets不工作 握手报404
优惠活动
大模型
产品
解决方案
定价
更多

Supervisor运行正常但本地Laravel Websockets不工作 握手报404

Laravel Websockets WSS握手404问题排查

核心问题定位

当前Supervisor进程运行状态正常但WebSocket握手返回404,根本原因是接入层Nginx未将443端口收到的WSS请求正确转发到本地Laravel Websockets的监听端口,并非Websockets进程本身启动失败。

分步排查操作

  • 验证本地Websockets服务的端口监听状态
    执行命令netstat -tnlp | grep 6001,确认Laravel Websockets默认的6001端口处于正常LISTEN状态,排除Supervisor进程假活、端口被占用导致服务未实际启动的问题。
  • 补全Nginx层的WebSocket反向代理配置
    在对应lower.xsite.com站点的443 SSL服务配置块中,添加针对WebSocket请求的转发规则,核心逻辑是将请求路径下带Upgrade头的请求转发到本地6001端口,完成握手升级:
    # 匹配所有Websockets相关的/app路径请求
    location /app/ {
        proxy_pass http://127.0.0.1:6001;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
        # 设置长连接超时时间,避免空闲连接被主动切断
        proxy_read_timeout 86400;
    }
    
    注意站点启用SSL后,WSS请求默认走443端口,无需将6001端口开放到公网,所有流量通过Nginx本地环路转发到6001端口即可,既保证传输加密,也减少公网端口暴露风险。
  • 调整Nginx规则匹配优先级
    Plesk环境默认的Nginx配置中,所有PHP请求会被全局规则匹配,直接交给PHP-FPM处理。如果WebSocket转发规则的优先级低于PHP处理规则,请求会被错误路由到静态文件/PHP处理流程,最终返回404。需要将上述/app/的转发规则移动到PHP处理规则之前,保证匹配优先级。
  • 交叉核对配置一致性
    • 打开项目下config/websockets.php文件,确认服务监听端口与Nginx转发的6001端口完全一致,避免环境变量覆盖配置导致端口偏移
    • 检查服务器防火墙、Plesk自带防火墙规则,确认没有拦截127.0.0.1到6001端口的本地环路流量
  • Supervisor配置长期稳定性优化
    当前配置使用root用户运行Websockets进程存在权限安全风险,建议将user=root调整为站点对应的专属系统用户,避免因文件权限读取异常导致服务崩溃;同时可在启动命令中加上--port=6001参数显式指定服务端口,避免配置加载顺序差异导致端口错配。

内容的提问来源于stack exchange,提问作者mia

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.11 19:15:10