redis密码未正确传递至底层连接会导致认证失败或缓存写入异常，需按版本配置服务端requirepass、tp8显式password参数、tp5.x的redis_auth常量及宝塔环境手动同步，并通过redis-cli和ping验证生效。
如果您在ThinkPHP中配置Redis连接后仍提示认证失败或无法写入缓存/会话，则很可能是Redis密码未被正确传递至底层连接。以下是针对不同ThinkPHP版本与部署场景的多种密码认证配置方法：
一、修改Redis服务端配置并启用requirepass
该方法确保Redis服务强制要求密码验证，是所有客户端密码配置生效的前提。必须先完成此步，否则客户端设置密码无效。
1、打开Redis配置文件redis.conf（常见路径：/etc/redis/redis.conf 或 /usr/local/redis/etc/redis.conf）。
2、查找以# requirepass foobared开头的行，取消注释并替换为实际密码，例如：requirepass MySecur3P@ss2026。
3、若Redis启用ACL（Redis 6.0+），则需禁用requirepass，改用ACL规则：在redis.conf中添加aclfile /etc/redis/users.acl，并在users.acl中定义用户，例如：user default on >MySecur3P@ss2026 ~* +@all。
4、保存配置文件后执行systemctl restart redis（或redis-server --daemonize yes）重启服务。
二、ThinkPHP 8 配置cache.php与session.php显式密码参数
TP8不从.env读取Redis连接细节，所有认证参数必须直接写入config/cache.php和config/session.php中的store配置数组，否则密码将被忽略，导致静默降级为file驱动。
1、编辑config/cache.php，在'stores' => ['redis' => [...]]内添加完整连接参数：
2、确保包含'password' => 'MySecur3P@ss2026'（ACL模式下改为'auth' => 'MySecur3P@ss2026'）。
3、同时填写'host' => '127.0.0.1', 'port' => 6379, 'database' => 0，不可留空或依赖默认值。
4、编辑config/session.php，设置'type' => 'redis'后，必须补全'store' => []数组，其中同样需明确指定'password' => 'MySecur3P@ss2026'及host/port等字段。
三、ThinkPHP 5.x（含5.1/5.2/6.x）配置DATA_CACHE_TYPE与REDIS_AUTH
旧版ThinkPHP使用全局常量或配置项控制Redis密码，需配合Redis扩展原生auth调用，否则连接成功但命令执行被拒绝。
1、在应用配置文件（如config.php或database.php）中添加：'REDIS_AUTH' => 'MySecur3P@ss2026'。
2、确认已启用phpredis扩展（非predis），运行php -m | grep redis验证输出存在redis。
3、若使用自定义Redis驱动类（如ThinkPHP\Library\Think\Cache\Driver\Redis.class.php），需在connect之后、setOptions之前插入auth调用：在构造函数中找到$this->handler->connect(...)后一行，添加$this->handler->auth(C('REDIS_AUTH'));。
4、避免使用'REDIS_PASSWORD'等非标准键名——TP5.x仅识别'REDIS_AUTH'作为密码配置项。
四、宝塔面板环境下的密码同步配置
宝塔中Redis密码通过面板设置，但ThinkPHP项目不会自动读取该密码，必须人工同步到代码配置中，否则出现“可连接但keys *报ERR operation not permitted”现象。
1、登录宝塔面板，进入Redis管理页，点击“设置”，在“密码设置”栏输入并保存密码（如MySecur3P@ss2026）。
2、进入对应PHP版本的“配置修改”，确认已安装并启用redis扩展（非memcached或其他）。
3、在项目extend目录下创建RedisPackage.php时，其$options数组中必须硬编码'password' => 'MySecur3P@ss2026'，不可留空或设为null。
4、测试连接：在控制器中实例化该类并调用get('test')，若返回false且无异常，则说明auth未执行；此时检查是否遗漏self::$handler->auth($this->options['password'])调用。
五、调试连接与验证密码生效
当配置完成后仍无法操作Redis，需绕过ThinkPHP直接验证底层连接与认证是否真实生效，排除框架封装干扰。
1、在服务器终端执行：redis-cli -h 127.0.0.1 -p 6379 -a MySecur3P@ss2026 keys *，若返回key列表则服务端密码正确。
2、若提示(error) NOAUTH Authentication required，则说明requirepass未生效或密码错误；若提示(error) ERR operation not permitted，则说明已认证但ACL权限不足。
3、在ThinkPHP中临时插入调试代码：dump(\think\Cache::store('redis')->handler()->ping());，返回+PONG表示连接与认证均成功。
4、观察日志：开启ThinkPHP日志（app_debug = true），查看runtime/log/*.log中是否出现[ warning ] Redis connection failed, fallback to file，该提示即表明密码配置失效。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
