Storage::disk('cos')上传后URL返回空，因COS驱动默认未注册URL生成器；需在config/filesystems.php中配置'url' => env('COS_URL')，或通过Storage::extend()手动绑定UrlGenerator闭包。
为什么 Storage::disk('cos') 上传后文件 URL 返回空？
因为腾讯云 COS 驱动默认不配置 url 生成逻辑，Storage::url() 调用会返回空字符串或报错（如 “Url generator is not supported”）。这不是权限或签名问题，而是驱动未注册 URL 构造器。
- 确认已安装
overtrue/flysystem-cos（Laravel 9+ 推荐）或官方qcloud/cos-sdk-v5+league/flysystem-aws-s3-v3适配器 - 在
config/filesystems.php的disks.cos中必须显式设置'url' => env('COS_URL')，且该环境变量需为完整域名（如https://my-bucket-1250000000.cos.ap-guangzhou.myqcloud.com） - 若用自定义驱动（非
overtrue包），需手动绑定UrlGenerator：在App\Providers\AppServiceProvider::boot()中调用Storage::extend()时传入url闭包
如何让 Storage::put() 正确上传并自动补前缀路径？
COS 桶是扁平结构，没有真正“目录”，但路径前缀（如 uploads/images/）必须显式拼接。Laravel 的 put() 第一个参数就是这个关键路径，漏掉或写错会导致文件上传到根目录甚至覆盖。
LZ Create - 多云迁移到腾讯云
下载
支持从 AWS、阿里云、GCP、华为云、Azure 向腾讯云迁移的 Landing Zone 全流程客户端。通过远程 MCP Server 自动完成：扫描源云资源(5朵云13种资源)、AI智能填充调研问卷、生成设计文档、生成Terraform代码。当用户提到云迁移、Landing Zone、Terraform、扫...
-
Storage::disk('cos')->put('images/avatar.jpg', $content)→ 上传到images/avatar.jpg -
Storage::disk('cos')->put('uploads/images/avatar.jpg', $content)→ 上传到带前缀路径，推荐用于组织资源 - 避免使用
putFile()或putFileAs()时不指定子路径：它们默认用随机哈希名+原始扩展名，但前缀仍需手动加，例如putFile('uploads/images', $request->file('avatar')) - 注意：COS 不区分
/uploads/和uploads/，但建议统一用无开头斜杠的格式（uploads/images），与 Laravel 默认行为一致
上传大文件失败、卡住或报 RequestTimeout 是什么情况？
腾讯云 COS SDK 默认使用单次 PutObject，超 5MB 就可能失败；超过 20MB 基本必现超时。必须启用分片上传（Multipart Upload），但 Laravel Storage 层不自动触发，需底层驱动支持并配置。
- 使用
overtrue/flysystem-cos时，在config/filesystems.php的disks.cos.options中添加：'timeout' => 60、'connect_timeout' => 60、'multipart' => true - 若用
qcloud/cos-sdk-v5自封装驱动，需在构造Qcloud\Cos\Client时传入'allow_redirects' => false并确保启用multipart_upload配置项 - PHP 运行时限制也要同步调整：
upload_max_filesize、post_max_size、max_execution_time均需大于目标文件尺寸和预期上传耗时
本地开发时 Storage::url() 返回 http://localhost 而不是 COS 地址？
这是 Laravel 的 local 驱动强制行为 —— 它忽略你配的 url，只走本地路径映射。哪怕你把 disk 切成 cos，如果当前 APP_ENV 是 local 且没正确加载配置，就会 fallback 到默认行为。
- 检查
config/filesystems.php中'default' => env('FILESYSTEM_DISK', 'local')，确保部署环境设为COS，且.env中FILESYSTEM_DISK=cos - 运行
php artisan config:clear，避免缓存旧配置（尤其从 local 切换过来时） - 不要在
local环境下测试 COS URL 生成逻辑；临时验证可用php artisan tinker手动调用Storage::disk('cos')->url('test.jpg') - 更稳妥的做法：在视图中统一用
Storage::disk('cos')->url($path)，而非依赖全局Storage::url()
