必须确认phpredis扩展已启用、config/database.php和.env中redis.client设为phpredis、CACHE_DRIVER=redis，且Cache::getStore()->getDriverName()返回phpredis；预热应直调Redis::connection('cache')原生命令，禁用自动prefix，并验证CLI与Redis容器网络连通及目标DB写入。
直接用 phpredis 驱动做缓存预热，核心是绕过 Laravel 默认的 predis 抽象层，直连 Redis 实例批量写入——但必须确认你的环境已启用 phpredis 扩展且配置对齐，否则会静默降级到文件缓存或报错。
确认 phpredis 已加载并被 Laravel 识别
预热前不验证驱动状态，极大概率写进错的地方（比如写进了 predis 连接池或 fallback 的 file 缓存）。执行以下检查：
- 运行
php -m | grep redis，输出含redis（不是predis）才表示扩展已启用 - 检查
config/database.php中redis.client是否设为'phpredis'，而非'predis' - 在
.env中确认REDIS_CLIENT=phpredis，且CACHE_DRIVER=redis - 运行
php artisan tinker后输入Cache::getStore()->getDriverName()，返回phpredis才算真正生效
预热命令中避免 Cache::put() 封装，改用 PhpRedis 原生批量写入
Cache::put() 在 phpredis 驱动下仍走 Laravel 的序列化/前缀封装逻辑，吞吐低、不可控。高频数据预热应跳过门面，直调底层连接：
- 在 Artisan 命令的
handle()中，用$redis = Redis::connection('cache')获取原生实例（需先use Illuminate\Support\Facades\Redis;） - 对分类列表这类结构化数据，用
$redis->hMSet('categories:all', $data)替代Cache::put('categories', $data, 3600)，减少序列化开销 - 对简单键值（如站点配置），用
$redis->setEx('site_config', 7200, json_encode($config))，显式控制 TTL 和编码格式 - 禁用 Laravel 自动前缀（
cache.）时，需在config/cache.php的stores.redis.prefix设为空字符串，否则原生命令写入的 key 与业务代码读取的不一致
预热失败常因 CLI 环境 Redis 连接不可达
Docker 或多容器部署下，CLI 容器默认无法访问 Web 容器的 localhost:6379。错误现象是预热命令无报错但 redis-cli keys "*" 查不到数据，或抛出 Connection refused。
立即学习“PHP免费学习笔记（深入）”；
- 在
.env中把REDIS_HOST改为 Docker 内部服务名（如redis），而非127.0.0.1或localhost - 确保 CLI 容器与 Redis 容器在同一 Docker 网络（如通过
docker-compose.yml的networks字段声明） - 预热前加诊断步骤：
php artisan tinker -n→Redis::connection()->ping()，返回+PONG 才代表通路正常 - 若使用 Laradock 或 Sail，注意它们对 CLI 环境的 DNS 解析限制，必要时在
/etc/hosts中手动映射redis到对应 IP
最易被忽略的是：预热后没验证数据是否真的写进目标 Redis DB。别只信命令退出码，一定要用 redis-cli -h $REDIS_HOST -p $REDIS_PORT -n $REDIS_DB keys "categories:*" 直连确认——因为 phpredis 的 database 配置和实际连接 DB 号错位时，数据会写进别的库，业务请求永远读不到。
