在将项目部署到服务器后，发现缓存始终无法生效，日志中反复出现“Connection refused”或“read error on connection”。这类问题通常并非配置错误，而是PHP扩展版本与Redis服务通信机制存在底层冲突。特别是当Redis启用Unix socket或PHP运行在SELinux环境中时，权限校验会直接拦截连接请求，甚至无法进入密码验证环节。
确认 phpredis 扩展是否真正加载且 ABI 兼容
首先，运行 php -m | grep redis 命令，检查输出中是否包含 redis（注意不是 predis 或 igbinary）。如果没有，则说明扩展尚未加载。
如果扩展已加载，接着执行 php -r "echo ZEND_MODULE_API_NO;"。PHP 8.0.x 对应的ABI版本号应为 20200930。若显示为 20210902 或 20220829，则说明你正在使用 PHP 8.1 或 8.2 的 redis.so 文件强行加载到 PHP 8.0 进程中，扩展将静默失效，导致 new Redis() 直接报 Class not found 错误。
检查扩展路径同样关键：在 Linux 环境下使用 php --ini 定位 FPM 所使用的 php.ini，打开文件确认 extension=redis.so 是否存在，且前面没有被分号注释掉。Windows 环境中对应的是 extension=php_redis.dll。
验证 Redis 服务监听方式与 PHP 客户端匹配
方法一：强制走 TCP 连接，绕过 Unix socket 权限问题
编辑 Redis 配置文件（通常位于 /etc/redis/redis.conf），将 bind 修改为 bind 127.0.0.1，并注释掉 unixsocket 那一行，然后重启 Redis：systemctl restart redis。在 ThinkPHP 配置中，host 必须显式指定为 127.0.0.1，不能使用 localhost——因为后者在多数 Linux 发行版中会强制走 Unix socket，而你的 PHP 进程可能无权访问该 socket 文件。
方法二：保留 Unix socket，但修复权限
如果必须使用 socket，先通过 redis-cli CONFIG GET unixsocket 查询 Redis 实际的 socket 路径，常见路径如 /var/run/redis/redis-server.sock。确认 PHP-FPM 进程用户（例如 www-data 或 nginx）对该文件具有读写权限：执行 ls -l /var/run/redis/redis-server.sock。若属主不是 www-data，则运行 chown www-data:www-data /var/run/redis/redis-server.sock，并确保目录 /var/run/redis/ 同样可访问。
这里有一个常见陷阱：当 SELinux 启用时（CentOS/RHEL 默认开启），即使文件权限正确，系统也会拦截 socket 连接。临时验证是否为 SELinux 导致的问题：执行 setenforce 0，再次尝试连接。如果恢复成功，说明问题根源在 SELinux，需要添加永久策略：ausearch -m a vc -ts recent | audit2why，然后使用 audit2allow 生成并加载模块。
检查 PHP 进程对 socket 文件的实际访问能力
第一步：确认 PHP-FPM 运行用户
执行 ps aux | grep php-fpm，查看 master 进程的启动者，通常为 www-data 或 nginx。
第二步：模拟该用户访问 socket
切换用户：sudo -u www-data bash，然后执行 redis-cli -s /var/run/redis/redis-server.sock ping。如果返回 PONG，说明权限和路径均无问题；若出现 Permission denied 或 Connection refused，则问题锁定在用户权限或 SELinux 上。
第三步：检查 socket 文件上下文（仅 SELinux 环境）
执行 ls -Z /var/run/redis/redis-server.sock，正确的上下文应为 system_u:object_r:redis_var_run_t:s0。如果显示 unconfined_u 或其他类型，则需要修复：semanage fcontext -a -t redis_var_run_t "/var/run/redis(/.*)?"，然后执行 restorecon -Rv /var/run/redis。这一步操作其实很简单，直接运行这两条命令即可。
