Predis连接Redis失败主因是Client构造参数错误:默认不支持redis:// URL,须用数组配置或显式启用;DNS解析、超时、序列化方式及连接复用不当亦常见。

用 Predis 连接 Redis 时连不上,先看 Predis\Client 构造参数对不对
绝大多数连接失败不是 Redis 没起,而是 Predis\Client 初始化时传了错误的连接信息。它不认 redis:// 前缀的 DSN(除非显式启用),默认只接受数组配置。
- 错:
new Predis\Client('redis://127.0.0.1:6379')—— 默认不解析 URL,会报Connection refused或空异常 - 对:
new Predis\Client(['scheme' => 'tcp', 'host' => '127.0.0.1', 'port' => 6379]) - 如果坚持用 URL,得加配置:
new Predis\Client('redis://127.0.0.1:6379', ['parameters' => ['scheme' => 'tcp']]) - 密码必须显式传
'password' => 'yourpass',redis://:pass@...格式在旧版 Predis 中可能被忽略
执行 set() 或 get() 报 “Cannot assign requested address”
这通常是 DNS 解析失败或 host 写成了不可达域名(比如 localhost 在 Docker 容器里指向 127.0.0.1,但 Redis 并不在容器内)。
- 本地开发:优先用
'host' => '127.0.0.1',别用localhost - Docker 场景:PHP 容器连 Redis 容器,host 应填 Redis 容器名(如
'host' => 'redis'),且确保在同一 network 下 - 超时要设:加
'timeout' => 2.0, 'read_write_timeout' => 2.0,否则默认阻塞很久才报错 - 检查 Redis 是否监听外网:
bind配置不能只有127.0.0.1(生产环境除外),protected-mode no要配合密码用
存数组或对象进 Redis,取出来变 null 或乱码
Predis 默认用 PHP 的 serialize(),但如果你手动 JSON 编码过,或者用了其他序列化方式,读取时没对应解码,就会出问题。
- 默认行为安全:直接
$client->set('key', ['a' => 1]),再$client->get('key')能正确还原数组 - 如果用了
json_encode()存,就必须json_decode($client->get('key'), true)取,不能混用 - 注意
hSet()/hGetAll()等哈希命令也遵循同样规则,值部分仍走序列化 - 不想序列化?传选项:
new Predis\Client($config, ['serializer' => Predis\Serializer\None::class]),但此时只能存字符串
并发写入时出现数据覆盖或 ERR max number of clients reached
没做连接复用或连接池,每次请求都 new 一个 Predis\Client,短时间大量请求会耗尽 Redis 连接数(默认 10000,但 PHP-FPM 子进程多时很容易打满)。
立即学习“PHP免费学习笔记(深入)”;
- 必须复用 Client 实例:放到容器里、单例类中,或至少每个请求生命周期内只初始化一次
- 别在循环里反复 new:
for ($i=0; $iset(...); }是典型反模式 - 查当前连接数:
redis-cli info clients | grep connected_clients - 临时缓解可调 Redis 配置:
maxclients 20000,但治标不治本











