Cloud Run中Laravel用GCS传图：Staging正常Production失效

API 探路者

2026-6-15

Laravel Cloud Run部署下GCS图片上传生产环境失败问题

我在Cloud Run上部署Laravel应用，使用Google Cloud Storage（GCS）存储上传的图片，依赖spatie/laravel-google-cloud-storage包实现功能。staging环境（普通服务器）上传正常，但production环境（Cloud Run）上传失败，配置和代码完全一致。

代码片段

if ($request->hasFile('image')) {
    $imagePath = $request->file('image')->store('images', 'gcs');
    $validatedData['image'] = Storage::disk('gcs')->url($imagePath);
}

附加信息

GCS存储桶已配置统一存储桶级权限
GOOGLE_CLOUD_PROJECT、GOOGLE_CLOUD_STORAGE_BUCKET及其他相关环境变量在两个环境中均已正确配置
两个环境的服务账号拥有相同角色（roles/storage.objectAdmin和roles/storage.objectViewer）
Laravel文件系统配置（config/filesystems.php）在staging与production环境中完全一致
未在日志中发现与GCS或文件上传相关的错误，但图片上传静默失败（有时无法返回预期URL）

已尝试操作

验证production服务账号拥有访问GCS存储桶的足够权限
反复确认production环境使用与staging相同的.env配置

问题

该问题是否与spatie/laravel-google-cloud-storage包在production环境中与GCS的交互方式有关？
我可以尝试哪些调试步骤或配置调整来定位问题？

关于包的交互问题可能性

不能直接排除，但更大概率是Cloud Run的运行环境特性导致的，而非包本身的环境差异。spatie的包本质是封装了Google官方的Storage SDK，标准环境下行为一致，Cloud Run的容器化、临时存储、服务账号挂载方式可能是核心差异点。

调试与配置调整建议

1. 强制开启详细日志

在production环境临时开启更细致的日志排查：

在.env中设置LOG_LEVEL=debug
在config/filesystems.php的GCS磁盘配置中添加调试选项：

'gcs' => [
    'driver' => 'gcs',
    'project_id' => env('GOOGLE_CLOUD_PROJECT_ID'),
    'key_file' => env('GOOGLE_CLOUD_KEY_FILE'),
    'bucket' => env('GOOGLE_CLOUD_STORAGE_BUCKET'),
    'path_prefix' => env('GOOGLE_CLOUD_STORAGE_PATH_PREFIX', ''),
    'storage_api_uri' => env('GOOGLE_CLOUD_STORAGE_API_URI', null),
    'visibility' => 'public',
    'debug' => true, // 开启SDK底层调试日志
],

同时查看Cloud Run的容器日志（不仅限于Laravel应用日志），Cloud Run会捕获容器内所有输出，包括SDK的底层错误信息。

2. 检查Cloud Run服务账号挂载逻辑

Cloud Run默认使用自身绑定的服务账号，而非你手动配置的key_file。如果.env中配置了GOOGLE_CLOUD_KEY_FILE，在Cloud Run环境中可能被自动忽略：

确认Cloud Run服务使用的默认服务账号是否拥有GCS的对应权限
若要强制使用自定义密钥文件，需将密钥文件打包进镜像，或通过Secret Manager挂载，确保容器内可正常读取该文件

3. 验证临时文件存储状态

Cloud Run的本地存储是临时的，Laravel上传文件时会先写入临时目录，再同步到GCS。可添加日志确认临时文件状态：

use Illuminate\Support\Facades\Log;

if ($request->hasFile('image')) {
    $tempFile = $request->file('image');
    Log::debug('临时文件路径：'.$tempFile->getRealPath().', 存在状态：'.file_exists($tempFile->getRealPath()));
    
    $imagePath = $tempFile->store('images', 'gcs');
    Log::debug('GCS存储路径：'.$imagePath);
    
    $validatedData['image'] = Storage::disk('gcs')->url($imagePath);
    Log::debug('生成的访问URL：'.$validatedData['image']);
}

通过日志确认临时文件是否正常生成，避免因临时目录权限不足导致上传中断。

4. 检查GCS对象可见性配置

若上传成功但URL无法访问，可能是对象默认权限问题：

在store方法中显式指定可见性：

$imagePath = $request->file('image')->store('images', ['disk' => 'gcs', 'visibility' => 'public']);

或在config/filesystems.php中设置GCS磁盘的默认visibility为public。

5. 绕过spatie包直接测试Google SDK

用Google官方SDK直接测试上传，排除包的问题：

use Google\Cloud\Storage\StorageClient;
use Illuminate\Support\Facades\Log;

$client = new StorageClient([
    'projectId' => env('GOOGLE_CLOUD_PROJECT'),
]);
$bucket = $client->bucket(env('GOOGLE_CLOUD_STORAGE_BUCKET'));

if ($request->hasFile('image')) {
    $file = $request->file('image');
    $destination = 'images/' . $file->getClientOriginalName();
    
    $bucket->upload(fopen($file->getRealPath(), 'r'), [
        'name' => $destination,
        'predefinedAcl' => 'publicRead'
    ]);
    
    $url = $bucket->object($destination)->publicUrl();
    Log::debug('SDK直接生成的URL：'.$url);
}

如果该测试成功，说明spatie包的配置存在问题；若失败，问题出在Cloud Run与GCS的环境交互上。

6. 检查Cloud Run网络配置

若Cloud Run配置了私有VPC，可能无法访问GCS公共端点：

确认Cloud Run服务允许访问外部网络（默认允许）
若使用私有VPC，需配置VPC访问连接器，确保能访问GCS的内部IP或公共端点

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

Cloud Run中Laravel用GCS传图：Staging正常Production失效

代码片段 #

附加信息 #

已尝试操作 #

问题 #

关于包的交互问题可能性 #

调试与配置调整建议 #