laravel生产环境启用redis必须打通连接可达、权限校验、配置固化、服务隔离四层关卡：先用redis-cli和redis::ping()验证服务与扩展就绪，再通过config:clear/config:cache固化cache_driver=redis等环境变量，绑定专用cache连接避免键冲突，队列使用独立database和命名空间化queue名，并用supervisor守护queue:work进程。
让Laravel生产环境真正用上Redis，必须同时打通连接可达、权限校验、配置固化、服务隔离四层关卡，否则Cache::get()静默返回null、queue:work启动即报错、任务进队列却永不执行——这些问题在上线前必须一次性扫清。
验证Redis服务与PHP扩展就绪
这一步跳过，后续所有配置都等于在断电插座上插电器。先确认Redis进程是否运行，再验证PHP能否通过扩展与其通信。
在项目根目录执行：redis-cli -h $REDIS_HOST -p $REDIS_PORT -a "$REDIS_PASSWORD" ping，返回PONG才说明服务层通了；若报Connection refused，说明Redis根本没启动，或$REDIS_HOST填错（Docker环境下绝不能写127.0.0.1）。
接着运行php artisan tinker，输入Redis::ping()：抛出异常说明PHP扩展未加载或认证失败；返回"PONG"证明Laravel底层通信链路已打通。
【关键前提】必须确保phpredis或predis扩展已安装且启用，否则Redis::ping()会直接报类不存在错误，连连接测试都进不去。
配置缓存驱动并固化环境变量
环境变量只是开关，不执行清缓存命令，Laravel永远读取旧的编译后配置，CACHE_DRIVER=redis形同虚设。
第一步：打开.env文件，确保这五行存在且值合理：CACHE_DRIVER=redisREDIS_HOST=10.0.0.5（Docker请改用容器名如redis）REDIS_PORT=6380REDIS_PASSWORD=null（若设密码，此处填真实密码；若留空字符串会导致认证失败）REDIS_CACHE_DB=1
第二步：执行php artisan config:clear，强制删除bootstrap/cache/config.php缓存文件。
第三步：立即执行php artisan config:cache，把当前.env和配置文件重新编译固化——这一步漏掉，改一百遍.env都没用。
绑定专用Redis连接避免键冲突
默认cache和session共用database 0，缓存key和session id混在一起，轻则查不到数据，重则Cache::flush()把用户登录态全删了。
Redis 缓存和数据结构管理技能。通过自然语言操作 Redis，支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。
方法一：修改config/database.php
在'redis' → 'connections'下添加专用cache连接块：'cache' => [ 'host' => env('REDIS_HOST', '127.0.0.1'), 'password' => env('REDIS_PASSWORD'), 'port' => env('REDIS_PORT', 6379), 'database' => env('REDIS_CACHE_DB', 1),],
方法二：同步更新config/cache.php
找到'stores' → 'redis'配置项，将'connection'值改为'cache'。
方法三：确认.env中REDIS_CACHE_DB=1与config/database.php中database值严格一致。
配置队列驱动并隔离命名空间
队列和缓存若共用同一Redis数据库，任务积压时会拖垮缓存响应，必须物理隔离。
① 打开.env，设置三项为强制项：QUEUE_CONNECTION=redisREDIS_HOST=10.0.0.5REDIS_PORT=6380
注意：不要写REDIS_PASSWORD=空值，若无密码请删掉该行或设为REDIS_PASSWORD=null；设为空字符串会导致认证失败。
② 编辑config/database.php中的redis配置块，确保'default'连接包含'database' => 2（缓存用db1，队列用db2），并显式声明'timeout' => 5和'read_write_timeout' => -1。
③ 进入config/queue.php，找到'redis'配置段，将'queue'改为带命名空间的值：'queue' => 'prod:notifications'。这样能防止开发队列与生产队列互相干扰。
创建可队列任务并分发
第一步：使用Artisan命令创建任务类：php artisan make:job SendEmailJob。
第二步：打开生成的app/Jobs/SendEmailJob.php，确认类顶部实现了ShouldQueue接口——没实现这个接口的任务，哪怕写了::dispatch()，也会被Laravel当作普通PHP对象同步执行，根本不会进Redis队列。
第三步：在控制器中调用分发逻辑：dispatch(new SendEmailJob());。这一步操作起来很简单，直接把任务对象传进去就行。
第四步：执行php artisan config:clear。Laravel会缓存配置，改了.env不清缓存等于白改。
启动监听器并用Supervisor守护进程
方法一：开发调试时快速验证
运行php artisan queue:work redis --verbose，看控制台是否输出Processing或Failed日志。终端关闭后进程就停，仅限临时测试。
方法二：生产环境必须用Supervisor守护
创建Supervisor配置文件/etc/supervisor/conf.d/laravel-worker.conf，内容如下：[program:laravel-worker]process_name=%(program_name)s_%(process_num)02dcommand=php /var/www/your-app/artisan queue:work redis --sleep=3 --tries=3 --max-time=3600autostart=trueautorestart=trueuser=www-datanumprocs=8redirect_stderr=truestdout_logfile=/var/www/your-app/storage/logs/worker.log
保存后执行：supervisorctl reread → supervisorctl update → supervisorctl start laravel-worker:*。
