Laravel生产环境必须启用配置缓存，执行php artisan config:cache前需确保APP_ENV=production、APP_DEBUG=false、OPcache启用、权限正确且配置文件无闭包或运行时函数；否则页面缓慢、配置不生效或报500错误。
将Laravel项目部署到生产环境后，页面加载缓慢、配置修改不生效、甚至直接报500错误——这些问题八成是因为没启用配置缓存，或启用方式存在致命疏漏。配置缓存不是可选项，而是生产环境启动的硬性前提。
确认生产环境基础就绪
第一步不是执行命令，而是确保PHP和框架已进入“生产模式”。打开项目根目录下的.env文件，逐行检查并强制写死以下三行：
APP_ENV=production → APP_DEBUG=false → LOG_LEVEL=error
【APP_DEBUG必须设为false且在首次访问前完成】，否则调试信息会暴露在页面上，且php artisan config:cache等命令会因环境未识别为production而拒绝执行。运行php artisan tinker → 输入config('app.debug')，返回false才算真正生效。
接着验证OPcache是否启用：php -i | grep "opcache.enable"。若输出为off，需立即修改php.ini，否则后续所有缓存命令均无效。
清理残留缓存与权限校准
从开发机同步代码后，bootstrap/cache/目录下极可能残留旧config.php、routes-v7.php等文件，它们会与新配置冲突并引发静默500错误。执行以下清空操作：
rm -f bootstrap/cache/*.php → php artisan config:clear → php artisan cache:clear → php artisan view:clear
权限问题常被忽略：storage和bootstrap/cache必须对Web服务器用户（如www或www-data）可写。在宝塔或轻量云中，先chown -R www:www /www/wwwroot/your_project，再执行chmod -R 775 storage bootstrap/cache。【在宝塔文件管理器中修改权限时，务必手动选择用户组为www，不能只改数字】。
生成配置缓存的完整路径
配置缓存不是“设个开关就生效”，必须执行php artisan config:cache才真正起作用；不运行这行命令，.env里改一百遍也没用。执行前请确保：
① 当前终端位于项目根目录（artisan文件所在位置）；
② .env中APP_KEY已存在且未被注释（若为空，先php artisan key:generate）；
③ config/目录下所有PHP文件无语法错误（可用php -l config/app.php逐个检测）；
④ 配置文件中未使用闭包、未调用尚未加载的类、未在运行时使用app()或resolve()等函数。
全部确认后，执行：php artisan config:cache
成功后检查bootstrap/cache/config.php是否存在，且内容以
验证缓存是否真实生效
方法一：终端执行php artisan tinker，输入config('app.name')，若返回值与.env中APP_NAME一致，说明缓存已接管；
方法二：临时删掉config/app.php中的'debug' => false这一行，再刷新页面——如果仍不显示错误详情，证明框架正在读取缓存而非原始文件；
方法三：在浏览器开发者工具Network面板查看首字节响应时间（TTFB），启用config:cache后应比未启用时下降30–80ms。
注意：.env变量只能在config文件里用env()读；缓存后，在控制器或Blade中直接调用env()会返回null。
配套动作必须同步完成
仅启用config:cache远远不够。它像发动机，必须配对燃料与冷却系统：
→ 将CACHE_DRIVER=redis写入.env（file驱动在高并发下因文件锁导致排队）；
→ 执行php artisan route:cache（路由缓存依赖配置缓存，顺序不可颠倒）；
→ 运行composer install --no-dev --optimize-autoloader（跳过开发包，生成扁平化类映射表）；
→ 确保DB_LOG_QUERIES=false且LOG_LEVEL=error（关掉SQL日志避免I/O拖慢）。
