Laravel使用Spatie库上传超2MB图片至GCP Bucket失败

以下是针对2MB以上文件上传失败问题的排查和解决步骤：

• 检查PHP核心配置限制
  默认PHP的upload_max_filesize和post_max_size默认值为2MB，这是大文件上传失败的最常见原因。找到你的php.ini文件，修改这两个参数：

upload_max_filesize = 10M
post_max_size = 10M

修改完成后，重启Web服务器（如Nginx、Apache）和PHP-FPM服务（如果使用的话）。

• 验证Laravel请求规则
  如果上传接口添加了请求验证，确认验证规则中的文件大小限制是否足够：

// 示例：调整max值为你需要的大小（单位KB，4096即4MB）
$request->validate([
    'file' => 'required|file|max:4096',
]);

• 确认GCS文件系统配置
  检查config/filesystems.php中的GCS配置项，确保没有额外的大小限制设置（Spatie库默认不限制上传大小）：

'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', ''),
    'visibility' => 'public',
],

• 调整Web服务器超时与大小限制
  大文件上传需要更长的处理时间，确保Web服务器配置支持：
  • Nginx：在配置文件中添加或修改client_max_body_size 10M;，同时调整fastcgi_read_timeout为合适的值（如60s）
  • Apache：修改LimitRequestBody参数，设置为允许的最大字节数（如10485760即10MB）

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