redis服务未启动导致redis::ping()报错，需先确保redis进程运行、php扩展加载、配置匹配，并区分缓存与队列的db及前缀，连接超时和清理操作也须精准配置。
Redis 服务没起来，php artisan tinker 里 Redis::ping() 直接报错
Laravel 要用 Redis，前提是 Redis 进程得在本地或目标服务器上跑着。常见错误是只装了 php-redis 扩展，但没启 Redis 服务本身。
实操建议：
- Linux/macOS 下检查：
redis-cli ping返回PONG才算通；不通就先sudo systemctl start redis或brew services start redis - Windows（WSL）同理，别直接在 CMD 里试 Windows 版 Redis（兼容性差），优先走 WSL 的原生安装
-
php -m | grep redis确认 PHP 扩展已加载，否则Redis::ping()会抛Class 'Redis' not found - 配置文件里
REDIS_HOST默认是127.0.0.1，如果用了 Docker，得改成宿主机网关（如host.docker.internal）或容器名
缓存驱动切到 Redis 后，Cache::get('key') 返回 null，但 redis-cli keys * 能看到 key
不是数据丢了，大概率是 Laravel 默认用了 cache 数据库（DB 0），而你手动操作时连的是默认 DB 0 —— 表面一致，实际可能不匹配。
实操建议：
- 检查
.env：确认REDIS_CACHE_DATABASE=0和REDIS_DATABASE=0一致（除非你故意分库） - Laravel 缓存 key 会被自动加前缀，比如
laravel_database_key_name，用redis-cli --scan --pattern "*key_name*"才能搜到 - 别用
Cache::forever()存敏感数据，它底层用的是SET key value，没设 TTL，容易占满内存；改用Cache::put('key', $val, 3600) - 如果用了 Horizon 或自定义队列连接，注意
cache和queue可以指向不同 Redis DB，但别配成同一个 DB 又混用DEL *清库
队列任务卡在 pending 状态，php artisan queue:work 不消费
Redis 队列依赖 LIST 结构（如 queues:default），但 Laravel 默认用的是 redis 连接池里的 default 连接 —— 如果这个连接被其他组件（比如缓存）占满或配置超时太短，BRPOP 就会失败静默退出。
实操建议：
- 检查
config/queue.php中redis配置的connection是否和config/database.php里redis.default对应；别写成'connection' => 'cache'这种不存在的键 - 给 Redis 连接加超时：在
database.redis.default下加'timeout' => 5，避免网络抖动导致 worker 假死 - 运行
php artisan queue:work --verbose，看是否报Connection refused或read error on connection—— 这类错基本指向连接配置或服务可用性 - 别在开发环境用
redis驱动跑队列还开着 Horizon，Horizon 会独占连接，queue:work就抢不到资源
php artisan cache:clear 清不掉 Redis 缓存？
因为 cache:clear 默认只清当前缓存驱动的「有效 key」，而 Redis 驱动的清理逻辑是遍历所有带前缀的 key 并 DEL，但如果前缀不匹配、DB 选错、或用了集群模式，就会漏删。
实操建议：
- 先确认当前缓存驱动：
php artisan tinker→config('cache.default')，确保是redis - 查前缀：
config('cache.stores.redis.options.prefix')，默认是laravel_cache:，清库时得对上 - 最稳的清法是直连 Redis：
redis-cli -n 0 --scan --pattern "laravel_cache:*" | xargs redis-cli -n 0 DEL - 生产环境禁止用
FLUSHDB，它会把队列、Session、甚至其他服务存的 key 全干掉；务必按前缀精准清理
Redis 在 Laravel 里不是“装上就能用”的黑盒，缓存、队列、Session、Horizon 各自连哪个 DB、用什么前缀、是否复用连接，这些细节一错，问题就藏得深。配完别急着写业务，先用 tinker 过一遍 Cache::put/get、Redis::ping()、dispatch(new TestJob())->onQueue('default') 这三步。
