Laravel生产环境执行php artisan config:cache后登录后页面空白无日志

从你的描述来看，核心问题非常明确：执行php artisan config:cache后，登录后页面空白且无任何日志输出，这几乎都是配置缓存后env()函数使用不当或者第三方依赖兼容问题导致的。结合Laravel 5.8的特性，给你以下针对性的排查和修复方案：

1. 检查代码中直接调用env()的场景 #

Laravel执行config:cache后，会将所有config/*.php中的配置合并到bootstrap/cache/config.php，此时.env文件会被停止加载——也就是说，只有在config目录下的文件里调用env()才会生效，如果你在控制器、模型、视图或者自定义类中直接使用env('XXX')，这些调用会返回null，进而导致页面空白（比如依赖某个环境变量的认证逻辑失效、数据库连接失败但未抛出可见错误）。

修复步骤：

• 把所有代码中直接使用的env('KEY')替换为config('file.key')，比如env('APP_URL')改成config('app.url')
• 确保对应的config/*.php文件里已经定义了该配置项，比如config/app.php里要有：'url' => env('APP_URL', 'http://localhost')
• 修改后重新执行php artisan config:cache测试

2. 排查第三方依赖的兼容问题 #

你使用的部分依赖包版本可能和Laravel 5.8的配置缓存机制存在冲突，比如：

• spatie/laravel-permission v2.12：这个版本相对较老，建议升级到Laravel 5.8兼容的最新版本（v2.38.0左右），老版本可能存在直接读取env()的情况
• igaster/laravel-theme v2.0：检查该主题包是否在配置缓存后能正确加载配置，部分主题包会依赖未缓存的配置文件路径

操作建议：

• 执行composer update spatie/laravel-permission:^2.38 igaster/laravel-theme（指定适配Laravel5.8的版本范围）
• 更新后重新执行构建命令测试

3. 手动检查缓存后的配置文件 #

执行config:cache后，打开bootstrap/cache/config.php文件，重点检查以下关键配置是否存在且值正确：

• app.key：确保不是null，这是加密会话和Cookie的关键，缺失会直接导致认证失败
• database.connections：数据库连接信息是否正确，登录后通常需要查询用户数据，连接失败会引发空白页面
• session.driver：会话驱动配置是否正常，登录状态完全依赖会话机制

如果发现某个配置项为null，回到对应的config/*.php文件，检查是否正确使用env()读取了环境变量。

4. 临时开启错误输出排查 #

虽然日志没有输出，但可以临时开启页面错误显示来定位问题：

• 在public/index.php的最顶部添加：

  ini_set('display_errors', 1);
  error_reporting(E_ALL);
  

• 注意：这只是临时排查用，生产环境测试完成后务必移除
• 重新访问页面，应该能看到具体的错误信息（比如某个配置缺失、类找不到等）

5. 调整构建命令顺序 #

你的构建命令最后执行了php artisan cache:clear再执行config:cache，这个顺序没问题，但可以优化为更合理的流程：

chmod -R 0777 storage/
composer install --prefer-dist --no-dev --no-interaction
php artisan config:cache
php artisan route:cache
php artisan migrate
php artisan storage:link
php artisan view:clear

先缓存配置，再缓存路由，因为路由缓存可能依赖配置项（比如多域名路由、主题路由规则），这样能避免依赖问题。

按照以上步骤逐一排查，应该能解决你遇到的空白页面问题。

内容的提问来源于stack exchange，提问作者Adam Copley