Filament PHP中GCP FileUpload预览「等待大小」异常问题求助

针对你遇到的问题，RichEditor上传正常但FileUpload组件预览卡在「等待大小」，说明GCP存储的基础连通性没问题，问题集中在FileUpload组件获取文件元数据（大小）或预览URL的逻辑上，试试以下方案：

1. 确认GCP服务账号权限 #

确保Laravel应用使用的GCP服务账号拥有storage.objects.get权限——Filament的FileUpload组件需要这个权限读取文件大小等元数据，而RichEditor可能仅需读取文件内容，权限要求不同。

2. 检查Filesystem配置与组件磁盘指定 #

• 确认config/filesystems.php中GCS磁盘的visibility设置正确：公开桶设为'visibility' => 'public'；私有桶需确保签名URL生成逻辑正常。
• 给FileUpload组件明确指定GCP磁盘：

  FileUpload::make('your_field_name')
      ->disk('gcs') // 匹配你在filesystems.php里配置的GCP磁盘名
      ->directory('uploads') // 可选，指定存储目录
  

3. 手动指定预览URL与文件大小 #

如果自动获取元数据失败，手动覆盖Filament的获取逻辑：

FileUpload::make('attachment')
    ->disk('gcs')
    // 手动返回GCP文件的预览URL
    ->getUploadedFilePreviewUrlUsing(function ($file) {
        return Storage::disk('gcs')->url($file->getPathname());
    })
    // 手动获取并返回文件大小
    ->getUploadedFileSizeUsing(function ($file) {
        return Storage::disk('gcs')->size($file->getPathname());
    })

4. 配置GCP存储桶CORS策略 #

如果前端无法请求文件元数据，可能是CORS限制。在GCP控制台的存储桶「权限」→「CORS」中添加以下配置（替换为你的应用域名）：

[
  {
    "origin": ["https://your-app-domain.com"],
    "method": ["GET"],
    "responseHeader": ["Content-Type", "Content-Length"],
    "maxAgeSeconds": 3600
  }
]

该配置允许你的应用域名请求文件并获取Content-Length（用于显示文件大小）。

5. 清除缓存并检查日志 #

• 运行以下命令清除缓存：

  php artisan filament:clear-cache
  php artisan cache:clear
  php artisan config:clear
  

• 查看storage/logs/laravel.log，查找GCP相关错误日志（比如权限不足、API请求失败），快速定位具体问题。

内容的提问来源于stack exchange，提问作者Mark Willow Aldave