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端口,完成握手升级:
注意站点启用SSL后,WSS请求默认走443端口,无需将6001端口开放到公网,所有流量通过Nginx本地环路转发到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; } - 调整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
相关产品推荐
相关产品推荐

