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」，实际是权限问题而非语法错误。
