ThinkPHP 8.0 无法连接 Redis 检查 PHP 扩展版本与 Unix Socket 权限

ThinkPHP 8.0 缓存失效主因是 phpredis 扩展 ABI 不兼容或 Redis 连接权限问题：需确认扩展正确加载且 ZEND_MODULE_API_NO 为 20200930，Redis 强制走 TCP（host 设为 127.0.0.1）或修复 Unix socket 权限及 SELinux 上下文。

ThinkPHP 8.0 项目在服务器上启动后缓存完全不生效，日志里反复出现“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 对应值必须是 【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。

立即学习“PHP免费学习笔记（深入）”；

验证 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 实际 socket 路径：redis-cli CONFIG GET unixsocket，常见路径如 /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，再试连接；若恢复成功，需打永久策略：ausearch -m avc -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。

这一步操作起来很简单，直接把文件拖进去就行。