Laravel应用部署Cloud Run后页面空白求助

1. 检查Laravel应用日志 #

Laravel日志默认存于storage/logs/laravel.log，优先查看是否有报错信息：

# 本地容器运行时查看日志
docker exec -it [容器ID] cat storage/logs/laravel.log

# Cloud Run中通过命令行筛选日志
gcloud logging read "resource.type=cloud_run_revision AND resource.labels.service_name=[你的服务名]" --limit=100

重点排查文件权限错误（如storage/bootstrap/cache目录不可写）、环境变量缺失（如APP_KEY未配置）。

2. 验证Nginx根目录与转发规则 #

确认Nginx配置是否正确指向Laravel的public目录（这是最常见的配置失误）：

错误示例：root /var/www/html;
正确配置：root /var/www/html/public;

同时检查请求转发规则是否正确：

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

另外要确认Nginx运行用户对public目录有读取权限。

3. 核对Docker环境变量配置 #

Laravel依赖核心环境变量运行，确保部署时已正确设置：

• APP_KEY：必须配置，可通过php artisan key:generate --show生成后传入
• APP_ENV：设为production时需确保缓存已正确生成
• APP_URL：设置为Cloud Run服务的域名，避免路由生成异常
• APP_STORAGE：Cloud Run仅/tmp目录可写，需设置为APP_STORAGE=/tmp（App Engine会自动处理该配置）

4. 确认Laravel缓存生成状态 #

生产环境下需提前生成配置、路由、视图缓存，确保Docker构建过程中执行了以下命令：

php artisan config:cache
php artisan route:cache
php artisan view:cache

若构建时未执行，或容器内目录权限不足导致缓存生成失败，会直接引发空白页。

5. 检查PHP-FPM与Nginx的通信 #

确认Nginx配置中PHP-FPM的监听地址正确：

location ~ \.php$ {
    fastcgi_pass unix:/run/php/php8.2-fpm.sock; # 对应容器内PHP-FPM的sock/端口
    fastcgi_index index.php;
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    include fastcgi_params;
}

可在容器内测试PHP解析Laravel入口的能力：

docker exec -it [容器ID] php public/index.php

若执行后有正常输出，说明PHP本身无问题，问题出在Nginx转发环节。

6. 分析curl返回的响应细节 #

针对你提供的curl返回内容，重点查看：

• 响应头的Content-Length是否为0，若为0说明Laravel未输出任何内容
• 响应体是否存在隐藏的错误信息（如HTML注释中的报错）
• 检查X-Powered-By是否显示PHP版本，确认请求已到达PHP服务

7. 对比App Engine运行环境差异 #

App Engine会自动处理Laravel的部分配置（如权限、临时存储），可对比两者差异：

• 检查App Engine使用的PHP版本与Docker容器内版本是否一致，版本差异可能引发语法兼容问题
• 确认App Engine是否自动设置了额外的环境变量，需同步到Docker部署中

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