swoole\coroutine\redis需显式启用tcp keep-alive并配合ping心跳检测，避免空闲连接被中间设备断开；实例不可跨协程复用，连接池须校验健康性且大小按qps×响应时间×1.2动态计算；php 8.1+需改用swoole\redis或co\redispool。
别直接 new Swoole\Coroutine\Redis() 就往里塞业务逻辑——协程生命周期、连接复用、错误重试这三块不处理，线上准炸。
为什么 Swoole\Coroutine\Redis 一用就报 read error on connection
这不是 Redis 挂了，而是连接在协程退出前没被正确回收或保活。Swoole 协程 Redis 客户端默认不启用 TCP Keep-Alive，空闲连接容易被中间网络设备（如 NAT、防火墙）静默断开。
- 必须显式开启：在
connect()后立刻调用$redis->setOption(\Redis::OPT_TCP_KEEPALIVE, 1) - 配合心跳检测：服务端
redis.conf中设tcp-keepalive 60，客户端连接后执行一次$redis->ping()确认连通性 - 避免跨协程复用同一个实例：
Swoole\Coroutine\Redis实例不是线程/协程安全的，一个实例只能被一个协程独占使用
连接池不是加个 new RedisPool() 就完事
手写连接池漏掉异常分支或未做健康检查，会导致坏连接持续进入队列，后续所有请求都卡在 get() 阻塞上。
Redis Skill - 高性能缓存管理
下载
Redis 缓存和数据结构管理技能。通过自然语言操作 Redis，支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。
- 初始化时必须验证连接有效性：
if (!$redis->connect(...) || $redis->ping() === false) { continue; } - 从池中取出连接后，建议先
ping()再用；或者用try-catch包裹操作，失败时主动$pool->put(null)归还空连接 - 池大小别硬写 100：按公式算 ——
max_connections ≈ (QPS × 平均响应时间) × 1.2，再结合 CPU 核心数上限（≤ 核心数 × 4）
异步回调里不能直接 throw 异常
$pool->push('get', ['key'], function($result) { throw new Exception('boom'); }); 这种写法会让异常直接丢失，协程静默退出，连接也不归还。
- 回调函数内必须自己
try-catch，错误要记录日志、标记连接失效、必要时触发重试 - 不要依赖全局
set_exception_handler—— 协程上下文里它不生效 - 更稳妥的做法是统一返回结构：
['success' => false, 'error' => 'redis timeout']，由业务层判断处理
PHP 版本与扩展版本对不上，php -m 有但 phpinfo() 不显示
Mac（尤其是 Big Sur+）和 MAMP 环境下高频出现：pecl 安装的 redis.so 被写进了系统 php.ini，但实际运行的是 MAMP 或 brew 的独立 PHP，配置文件路径完全不一致。
- 先确认真实加载的
php.ini：运行php --ini，看 “Loaded Configuration File” 路径 - 再确认扩展是否真加载：
php -r "var_dump(extension_loaded('redis'));"，比php -m更准 - Mac 上若用 brew php，扩展目录通常是
/opt/homebrew/lib/php/pecl/，extension=redis.so必须指向这个路径下的文件
最易被忽略的一点：Swoole 5.0 + PHP 8.1+ 环境下，Swoole\Coroutine\Redis 已废弃，必须改用 Swoole\Redis（协程版）或接入 Co\RedisPool 接口，旧代码不改会静默失败，连错误提示都没有。
