WebSocket服务启动失败主因是端口被占，需用lsof或netstat查杀；路由须用Amp\Http\Server\Router显式配置；大消息需分片发送；生产环境需调优心跳间隔并配置Nginx WebSocket支持。
WebSocket 服务启动失败：Amp\Socket\Server 绑定端口报错 Address already in use
常见于本地调试时，8080 或 8000 端口被 PHP 内置服务器、Node 进程或上一次未退出的 Amp\Socket\Server 占用。Amp 的 WebSocket 服务不是靠 php -S 启动的，它自己就是完整服务器，必须确保端口干净。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 先执行
lsof -i :8080（macOS/Linux）或netstat -ano | findstr :8080（Windows）查占用进程，再kill -9 [PID]干掉 - 别在
index.php里直接跑Server::start()后就刷新浏览器——Amp 是长生命周期进程，应通过终端命令启动：php server.php，且运行后不退出 - 开发时加
set_error_handler捕获底层 socket 错误，否则Address already in use可能静默失败，只看到进程闪退
客户端连不上 Amp\WebSocket\Server：握手 400 或连接立即关闭
Amp 的 WebSocket 服务默认不处理 HTTP 升级请求以外的路径，也不自带静态文件服务。如果你用 ws://localhost:8080/ 能连，但 ws://localhost:8080/api/ws 报 400，大概率是路由没配对。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
-
Amp\WebSocket\Server本身不解析 URL path，它只监听 upgrade 请求；你得用Amp\Http\Server\Router做前置路由，把/api/ws路径显式指向 WebSocket 处理器 - 别漏掉
Origin校验逻辑——浏览器强制发送 Origin 头，若服务端没响应Access-Control-Allow-Origin，握手会失败（Chrome 控制台显示Unexpected response code: 400） - 客户端用
new WebSocket('ws://...')时，确保协议是ws://（非http://），且服务端监听的是 TCP 端口，不是 HTTP 代理后的路径
Amp\WebSocket\Connection::send() 发送大消息卡死或断连
Amp 默认使用内存缓冲区传输帧，如果一次性 send() 超过几 MB 的 JSON 字符串，会触发底层 BufferException 或导致连接被对方主动关闭（尤其浏览器端）。这不是 bug，是流控机制生效。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 单次
send()数据建议控制在 128KB 以内；超过则手动分片，用array_chunk()切成小块，每块间隔yield new Delayed(1)防爆 - 避免在
onOpen回调里直接yield $connection->send($hugeData)—— 这会阻塞整个 Event Loop；改用Loop::defer()推迟执行 - 注意
Connection::isClosed()必须在 send 前检查，Amp 不自动重连，已关闭连接上调用send()会抛InvalidStateException
生产环境部署：为什么 supervisord 管理的 Amp 进程总在 30 秒后意外退出
Amp 默认启用心跳检测（Ping/Pong），但某些负载均衡器（如 Nginx 默认配置）会在 60 秒无数据时主动断开空闲连接；而 Amp 若未收到客户端 pong，30 秒超时后会关掉连接。两者叠加，导致看似“稳定运行”实则连接频繁重建。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 在
Amp\WebSocket\Server初始化时传入自定义Settings：new Settings(['max_ping_interval' => 45])，让服务端 ping 间隔小于 LB 超时 - Nginx 前置时，必须加 WebSocket 支持配置：
proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "upgrade"; - 别用
pm.max_children类 FPM 思维管理 Amp 进程——它是单进程全异步，一个实例撑万级连接，supervisord只需保活 1 个主进程，无需多 worker
真正的难点不在写几行 yield $server->onOpen(...)，而在理解 Amp 的事件循环如何与操作系统 socket 缓冲区、TCP Keepalive、反向代理超时层层咬合。少配一个 proxy_read_timeout，线上就收不到心跳 pong；多套一层 Swoole 兼容层，反而破坏 Amp 的原生协程调度。这些地方没日志，只在凌晨三点掉连接时才露头。
