Laravel File Manager对接Google Cloud Storage预览失效问题求助

问题描述 #

我正在尝试让 laravel-file-manager 适配 Google Cloud Storage，但文件预览无法正常显示。右键菜单选择属性并点击「Get URL」时能获取到正确的URL，但预览界面没有显示存储桶的URL。

已在 filesystems.php 中配置了 GCS 驱动：

'gcs' => [
    'url' => 'https://storage.googleapis.com/bucket-name',
    'driver' => 'gcs',
    'key_file_path' => base_path(env('GOOGLE_CLOUD_KEY_FILE', null)), // optional: /path/to/service-account.json
    'key_file' => [], // optional: Array of data that substitutes the .json file (see below)
    'project_id' => env('GOOGLE_CLOUD_PROJECT_ID', 'your-project-id'), // optional: is included in key file
    'bucket' => env('GOOGLE_CLOUD_STORAGE_BUCKET', 'your-bucket'),
    'path_prefix' => env('GOOGLE_CLOUD_STORAGE_PATH_PREFIX', ''), // optional: /default/path/to/apply/in/bucket
    'storage_api_uri' => env('GOOGLE_CLOUD_STORAGE_API_URI', null), // see: Public URLs below
    'apiEndpoint' => env('GOOGLE_CLOUD_STORAGE_API_ENDPOINT', null), // set storageClient apiEndpoint
    'visibility' => 'public', // optional: public|private
    'visibility_handler' => null, // optional: set to \League\Flysystem\GoogleCloudStorage\UniformBucketLevelAccessVisibility::class to enable uniform bucket level access
    'metadata' => ['cacheControl'=> 'public,max-age=86400'], // optional: default metadata
],

找不到该工具对接云存储的相关文档或示例，无法定位配置问题。

当前环境版本：

• alexusmai/laravel-file-manager: ^3.0
• spatie/laravel-google-cloud-storage: ^2.2
• Laravel 9

解决步骤 #

1. 确认存储桶权限与可见性配置 #

如果存储桶启用了统一层级访问，需修改visibility_handler配置：

'visibility_handler' => \League\Flysystem\GoogleCloudStorage\UniformBucketLevelAccessVisibility::class,

同时确保存储桶的公共访问权限已正确配置，文件的visibility设置为public。

2. 修正文件管理器的URL生成规则 #

在config/file-manager.php中为GCS磁盘添加自定义URL配置：

'diskConfigs' => [
    'gcs' => [
        'url' => env('GOOGLE_CLOUD_STORAGE_URL', 'https://storage.googleapis.com/bucket-name'),
    ],
],

强制文件管理器使用GCS的公共URL生成逻辑。

3. 排查路径前缀问题 #

如果配置了path_prefix，临时移除该配置进行测试，确认是否是路径拼接错误导致预览URL失效。

4. 清除配置缓存 #

执行以下命令确保新配置生效：

php artisan config:clear
php artisan cache:clear

5. 手动验证URL生成 #

通过tinker手动生成文件URL，确认底层存储驱动的URL生成逻辑正常：

php artisan tinker

在tinker中执行：

Storage::disk('gcs')->url('your-test-file.jpg');

若输出正确的公共URL，说明问题出在laravel-file-manager的预览逻辑，需检查其前端或后端的URL拼接代码。

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