Webman 能撑住高并发挂号场景，但需三重协同：PHP 运行时启用 pcntl/posix、进程模型用 daemon + event-loop、数据库交互结合 Redis 信号量与 MySQL 行锁；Nginx 关闭 proxy_buffering 并配置 keepalive；Docker 需清理 workerman.pid 避免端口冲突。
Webman 能撑住高并发挂号场景，但默认配置和常见部署方式会直接导致秒杀式请求下 502、连接超时或排班数据错乱——关键不在框架本身，而在 PHP 运行时、进程模型和数据库交互的三重协同。
Webman 启动模式必须用 daemon + event-loop，不能用 php start.php start
本地开发常用 php start.php start 是阻塞式调试模式，生产环境一上量就卡死。挂号高峰（如早8点放号）每秒数百请求，必须启用常驻守护 + 异步事件循环。
-
php start.php start -d是最低要求，-d 表示 daemon 模式，避免终端退出导致进程终止 - 必须确认
pcntl和posix扩展已启用，否则 Workerman 底层无法 fork 子进程，php -m | grep -E "pcntl|posix"返回为空即失败 - 若用宝塔面板，PHP 设置里要手动清空“禁用函数”列表中的
pcntl_fork、posix_kill、posix_getpid，否则启动后看似成功，实则 worker 进程数为 0 - 建议在
config/app.php中显式设置'worker_num' => 12（根据 CPU 核数 × 2），避免默认 4 个 worker 在高负载下成为瓶颈
挂号接口必须加 Redis 信号量 + MySQL 行锁，不能只靠事务
单纯用 START TRANSACTION + SELECT ... FOR UPDATE 在 Webman 的协程环境下容易因上下文切换导致锁等待堆积，出现“号源已抢完但返回成功”的脏状态。
Webman 2.2.0版本强化了 TCP/UDP 服务支持，优化路由组管理，并增强异步任务处理能力。结合协程与连接池技术，Webman 能轻松应对高并发场景，适用于网站、接口服务、即时通讯、物联网及游戏开发，兼具高性能、灵活扩展与稳定可靠，是多场景 PHP 服务开发的理想选择。
- 先用 Redis
SETNX做分布式信号量：键名形如booking:20260728:cardiology:zhangsan，过期时间设为 30 秒，抢号前SETNX成功才进入后续流程 - MySQL 层仍需
SELECT ... FOR UPDATE，但仅作用于具体号段表（如schedule_slot），且 WHERE 条件必须命中主键或唯一索引，否则会升级为表锁 - 注意 Webman 默认不开启 PDO 的
PDO::ATTR_EMULATE_PREPARES = false，若未手动设置，prepare 语句可能被模拟执行，导致FOR UPDATE失效 - 失败时统一返回
429 Too Many Requests，前端做退避重试，不要返回 500 或静默失败
Nginx 必须配 proxy_buffering off + keepalive 60，否则挂号响应延迟翻倍
挂号操作是短连接高频写入，Nginx 默认开启 proxy_buffering on 会缓存响应体，导致用户点击“提交”后界面长时间无反馈，实际后端早已处理完毕。
- 在 Nginx server 块中添加：
proxy_buffering off;、proxy_http_version 1.1;、proxy_set_header Connection ''; -
upstream webman_backend { server 127.0.0.1:8787; keepalive 60; }，keepalive 数值不宜过大（超过 100 易占满后端连接池） - 务必关闭
fastcgi_cache或任何页面级缓存，挂号接口严禁缓存，哪怕 1 秒都不行 - 检查
client_max_body_size是否足够（挂号请求含患者 ID、医生 ID、时段 ID，一般 2KB 内，设为4k即可）
Docker 部署时要覆盖 workerman.pid 路径，否则多容器重启失败
Docker 容器重启后，旧 workerman.pid 文件残留会导致新实例启动报错 Address already in use 或静默退出，这不是 Webman 问题，而是 Workerman 进程管理机制与容器生命周期不匹配。
- 在
docker-compose.yml的 service 配置里加：volumes: - /tmp/webman-pid:/var/www/webman/runtime/pid，把 pid 文件映射到宿主机临时目录 - 启动命令改用：
command: sh -c "rm -f /var/www/webman/runtime/pid/workerman.pid && php start.php start -d" - 健康检查不能只 ping 端口，要加
curl -f http://localhost:8787/health，确保 master 进程和至少 1 个 worker 正常运行 - 若用宝塔 Docker 插件，注意其自动生成的 compose 文件可能没处理 pid 冲突，建议手动覆盖
真正难的不是把号挂出去，而是在 1000 人同时点“确认挂号”时，让每条请求都拿到确定的结果——不是“正在处理”，不是“网络错误”，而是“成功”或“余号不足”。这需要 PHP 层的信号量、MySQL 层的精确锁、Nginx 层的透传配置、Docker 层的进程清理全部咬合到位，漏掉任意一环，系统就在高并发下开始说谎。
