Hyperf 中 Redis 与多数据库混合使用需确保连接隔离、调用明确、资源不冲突：一、Redis 多实例须键名/poolName/DI 注册三者一致；二、DB 与 Redis 按场景绑定，解耦操作且缓存 key 带业务前缀；三、Swow 下重设连接池参数并升级 Redis 组件；四、敏感配置全走 .env 实现环境分离。
Hyperf 中 Redis 和多数据库混合使用，关键不在“堆配置”，而在连接隔离、调用明确、资源不冲突。默认情况下，Redis 实例和数据库连接互不影响，但实际业务中容易因命名混淆、池参数错配或切换逻辑缺失导致数据写错库、缓存未命中、甚至连接耗尽。
一、Redis 多实例配置：键名、poolName、DI 注册必须三者一致
要让不同业务模块用不同 Redis 实例（比如 cache_db、queue_db、notify_db），不能只改 redis.php 里的键名：
- 在 config/autoload/redis.php 中定义多个键，如
'cache'、'queue'、'notify'，每个含独立 host/port/db/pool 参数 - 新建 Redis 客户端类时，protected $poolName = 'cache' 必须与配置键名完全一致（大小写、空格敏感）
- 若用
RedisFactory::get('queue')显式获取，传入的字符串必须存在于 redis.php 键中，否则抛异常，便于早期发现配置遗漏 - 避免继承
Hyperf\Redis\Redis后依赖 DI 自动注入——一旦多个同名服务注册冲突，会静默 fallback 到 default，极难排查
二、数据库多连接 + Redis 混合读写：按场景绑定而非全局混用
例如用户中心查 MySQL 主库、写日志到 PostgreSQL、同时更新 Redis 缓存，需明确各操作归属：
- MySQL 查询用
Db::connection('default')->table(...)，日志写入用Db::connection('log_db')->insert(...) - Eloquent 模型中通过
protected $connection = 'report_db';固定绑定，避免运行时误切 - Redis 缓存操作应与 DB 操作解耦：DB 写成功后再调
$this->redisCache->set(...)，不要在事务内直接操作 Redis（Redis 不支持跨库事务） - 缓存 key 命名建议带业务前缀+数据库标识，如
user:profile:123（主库）、log:error:20260813（日志库），便于后期清理或监控分流
三、Swow 环境下必须重设连接池参数
启用 Swow 协程引擎后，原 Swoole 兼容层的 pool 配置失效，不调整会导致连接泄漏或 EMFILE 错误：
- 数据库配置中删掉旧
pool项，在 MySQL 连接块同级新增 Swow 专用'pool' => [ 'min_connections'=>8, 'max_connections'=>64, 'check_interval'=>3000 ] - Redis 需升级
hyperf/redis ≥ 3.2.5，并在配置中指定'handler' => SwowHandler::class - Redis 的
wait_timeout建议设为 2.0～3.0 秒；max_connections按 CPU 核数 × 8 估算，避免高并发下连接争抢 - 启动前务必清空
runtime/container，否则旧 Pool 实例残留，新配置不生效
四、环境变量与配置分离，避免硬编码
不同环境（dev/staging/prod）的 Redis 和 DB 地址、库名、密码应全部走 .env，配置文件只做结构定义：
- redis.php 中写
'host' => env('REDIS_CACHE_HOST', '127.0.0.1')，对应 .env 里REDIS_CACHE_HOST=redis-cache.internal - database.php 中多连接的
'database' => env('DB_REPORT_DATABASE', 'reports')，避免上线时漏改 - 敏感字段如 password、auth 必须设为
env('REDIS_NOTIFY_AUTH')，禁止明文写在配置文件中
