config:cache 只缓存 config/ 目录下返回纯数组的 PHP 文件，跳过含 env()、运行时逻辑、.env 文件、第三方包动态注册及 Config::set() 修改的配置。

config:cache 会跳过哪些配置文件？

php artisan config:cache 只会缓存 config/ 目录下由 PHP 返回数组的配置文件，比如 app.php、database.php。它**不会**处理以下几类：

• 包含动态逻辑的配置文件（例如调用 env()、$_SERVER 或条件判断的）——缓存后这些逻辑会被“冻结”，导致环境变量变更失效
• .env 文件本身（它根本不会被读入缓存）
• 第三方包中通过服务提供者在运行时注册的配置（如某些包的 boot() 方法里修改配置）
• 使用 Config::set() 在请求中动态修改的值（缓存后该调用仍生效，但下次请求又重载缓存，无法持久）

常见踩坑：在 config/services.php 里写 'stripe' => ['key' => env('STRIPE_KEY')] 是安全的；但如果写成 'debug_mode' => app()->environment('local')，缓存后永远是生成时的环境判断结果。

route:cache 要求所有路由定义必须是闭包吗？

不是闭包，而是要求所有路由定义必须「可序列化」且「不依赖运行时上下文」。Laravel 的 php artisan route:cache 本质是把路由注册逻辑固化为静态数组，因此：

• ✅ 允许：普通控制器方法路由（Route::get('/users', [UserController::class, 'index'])）
• ✅ 允许：命名路由、中间件数组、where 约束等静态声明
• ❌ 禁止：闭包路由（Route::get('/', function () { return 'hi'; })）——因为闭包无法被 PHP 序列化
• ❌ 禁止：在路由定义中调用 request()、session()、auth() 等运行时服务
• ❌ 禁止：使用 Route::middleware(...)->group(...) 中嵌套了动态中间件解析逻辑（如基于请求头判断中间件）

如果项目用了 Laravel 9+ 的「函数式路由」或自定义宏，务必确认其底层未引入不可序列化的依赖。

缓存命令在部署流水线中怎么安全执行？

这两个命令不能在本地开发环境随意运行，必须作为部署步骤集成进 CI/CD，并满足几个硬性前提：

• 确保 .env 已正确部署到目标环境（config:cache 依赖当前环境下的 env() 值来生成缓存）
• 先运行 php artisan config:clear 和 php artisan route:clear，避免旧缓存干扰
• 必须在 composer install --no-dev --optimize-autoloader 之后执行，否则可能因类未加载而报错
• 若使用 Forge / Envoyer / Laravel Vapor，注意它们默认不自动执行缓存命令，需显式添加部署钩子
• 缓存失败时（如路由含闭包），命令会直接退出并返回非零状态码 —— 流水线必须捕获该错误，而不是静默忽略

示例部署脚本片段：

php artisan config:clear
php artisan route:clear
composer install --no-dev --optimize-autoloader
php artisan config:cache
php artisan route:cache

缓存后调试变困难，怎么快速临时绕过？

缓存生效后，dd()、dump() 放在配置或路由文件里不再触发，日志也看不到原始注册过程。临时排查建议：

• 删掉 bootstrap/cache/config.php 和 bootstrap/cache/routes-v7.php（Laravel 9+ 是 routes-v9.php），然后清空 OPcache（opcache_reset() 或重启 PHP-FPM）
• 用 php artisan route:list --no-cache 查看未经缓存的路由列表（仅 Laravel 10.28+ 支持）
• 对配置调试，改用 php -r "print_r(require 'config/app.php'

  

  );" 直接加载源文件，绕过 ConfigRepository
• 上线后不要长期禁用缓存；调试完立刻重新生成，否则启动性能损失明显（尤其当 config/ 下有 20+ 文件时）

最易被忽略的一点：缓存文件是 PHP 脚本，一旦权限不对（如被 root 写入、web 用户无读取权），会导致 500 错误且错误日志里只显示「failed to open stream」，实际是权限问题而非语法错误。