ThinkPHP5伪静态与WebSocket属不同协议层，伪静态仅处理HTTP请求，WebSocket需独立Nginx反向代理配置（如location /wss透传Upgrade头），严禁混入伪静态规则，否则导致握手失败。
ThinkPHP5 伪静态和 WebSocket 不是同一层机制，不能“一起配”——它们走的是完全不同的请求通道：伪静态处理 HTTP GET/POST 请求（走 Nginx/Apache），WebSocket 是长连接、独立协议（ws:// 或 wss://），必须绕过 URL 路由和伪静态规则。强行混用会导致 404、连接失败或路由错乱。
伪静态配置只影响普通 HTTP 请求
ThinkPHP5 的伪静态（比如把 /index/index 写成 /index）本质是靠服务器重写 + 框架 pathinfo_depr 解析实现的。它只对 GET/POST 类请求生效，且依赖 index.php 入口被正确转发。
-
location /块里的try_files $uri $uri/ /index.php?s=$uri&$args规则，不会也不该匹配 WebSocket 升级请求（Upgrade: websocket） - 如果在 Nginx 中错误地把
/wss也塞进伪静态规则里，比如写成location /wss { try_files ... /index.php?s=$uri... }，会导致 WebSocket 握手被转给 PHP 处理，直接返回 HTML 或 500，连接立刻断开 - Apache 的
.htaccess同理：RewriteRule默认不处理Upgrade头，但若误加了全局重写，也可能干扰ws://升级路径
WebSocket 必须单独配置反向代理
Workerman/GatewayWorker 启动后监听的是纯 TCP 端口（如 2346 或 2000），不走 PHP-FPM，也不经过 ThinkPHP 的路由层。Nginx 要让它对外可用，只能用 proxy_pass 做四层转发，且必须透传关键 Header。
- 确保 Nginx 编译时启用了
ngx_http_proxy_module（默认都有） - 不要把 WebSocket location 块放进
location /的伪静态逻辑里；必须独立声明，例如：location /wss { proxy_pass http://127.0.0.1:2000; proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "Upgrade"; proxy_set_header Host $host; } - 端口
2000（或你实际监听的）必须在云服务器安全组、本地防火墙中放行；Workerman 进程需以非 root 用户常驻运行（如www），避免权限冲突
入口文件与目录结构容易踩坑
ThinkPHP5 默认入口是 public/index.php，而 Workerman 的 server.php 通常放在项目根目录。这两者路径不一致，但又都依赖 APP_PATH 定义。一旦搞混，Worker 启动后可能加载不到模型、配置或中间件。
立即学习“PHP免费学习笔记（深入）”；
- 检查
server.php中的APP_PATH是否指向__DIR__.'/application/'（即与public/index.php一致的相对路径） - 如果项目部署在二级目录（如
https://example.com/myapp/），伪静态规则要加前缀（如rewrite ^/myapp/(.*)$ /myapp/index.php?s=/$1 last;），但 WebSocket 的proxy_pass仍指向后端绝对地址（http://127.0.0.1:2000），不受路径影响 - 别在
index.php入口里手动补$_SERVER['PATH_INFO']来适配 WebSocket —— 它根本不走这个流程，纯属白忙
真正麻烦的点在于：伪静态生效后，前端发 HTTP 请求时 URL 看起来“很静态”，但 WebSocket 连接地址（new WebSocket('wss://domain.com/wss')）必须显式暴露一个路径前缀，且该路径不能被任何 rewrite 规则捕获。这个边界一旦模糊，调试时就会出现“页面能打开，但 ws 连不上”的典型症状。
