Webman集群登录失效、购物车清空、502错误，主因是Session未共享（需切Redis）及Nginx缺乏健康检查与故障转移配置。
Webman集群部署后出现登录失效、购物车清空、接口返回502，基本可以断定是Session未共享或后端节点健康状态未被感知——这不是Webman自身的问题，而是负载均衡层与应用层协同缺失导致的。
Webman多实例启动时端口必须唯一
Webman默认监听0.0.0.0:8787，若在同一台机器启多个实例却不改端口，第二个会直接报Address already in use。这不是配置错误，是系统级端口冲突。
- 修改
config/server.php中的listen字段，例如改为0.0.0.0:8788、0.0.0.0:8789 - 确保每个实例的
name字段不同（如webman-1、webman-2），方便php start.php status识别 - Linux下用
lsof -i :8787检查端口占用，避免误判为Webman异常退出
Nginx upstream必须配健康检查与故障转移参数
只写server 192.168.1.10:8787是不够的。Nginx默认不主动探测后端是否存活，一旦某Webman进程崩溃，请求仍会被转发过去，最终超时或返回502。
Redis Skill - 高性能缓存管理
下载
Redis 缓存和数据结构管理技能。通过自然语言操作 Redis，支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。
- 在
upstream块中启用check指令（需编译Nginx时加入nginx_upstream_check_module）：check interval=3000 rise=2 fall=3 timeout=1000 - 或使用原生
max_fails/fail_timeout组合（无需额外模块）：server 192.168.1.10:8787 max_fails=3 fail_timeout=30s - 务必配置
proxy_next_upstream error timeout http_502 http_503 http_504，否则单点失败会直接暴露给用户 -
backup节点不能只写一个——它只在所有主节点不可用时才启用，无冗余能力
Session丢失不是Nginx问题，而是Webman没切存储后端
Webman默认用文件存Session，每个实例写本地runtime/session目录，自然无法跨节点同步。改Redis不是“可选优化”，而是集群前提条件。
- 确认已安装
php-redis扩展（非predis/predis纯PHP实现，后者性能差且不支持连接池） - 修改
config/session.php：'handler' => 'redis'，并填入'host'、'port'、'auth'（如有） - 设置
'prefix' => 'session:'，避免和缓存key冲突；'lifetime' => 7200建议显式设值，别依赖Redis默认TTL - 重启所有Webman实例（
php start.php restart-d），再验证redis-cli keys "session:*"是否有数据写入
故障转移生效的前提是客户端能重试
Nginx的proxy_next_upstream只对当前请求生效，不会“记住”某个节点已挂。如果客户端（比如前端axios）设置了timeout: 1000且没配重试逻辑，那它根本等不到Nginx切换——请求已在客户端侧超时了。
- Webman自身不处理故障转移，它只管响应；真正的转移发生在Nginx到后端这一跳
- 若用
ip_hash做会话粘滞，必须配合proxy_set_header X-Real-IP $remote_addr，否则CDN或代理后看到的全是同一个IP（如10.0.0.1） - 测试时别只curl一次，要用
ab -n 100 -c 10 http://your-domain.com/api/test模拟并发，才能触发failover行为
最常被忽略的一点：Webman的start.php脚本本身不感知其他实例状态，它只管理本机进程。所有高可用逻辑都压在Nginx和Redis上——你调优的重点从来不在PHP代码里，而在nginx.conf的upstream块和redis.conf的maxmemory-policy设置上。
