ThinkPHP云存储核心在于正确配置config/filesystem.php的disks数组及上传路径符合云服务object key规则；OSS配置需严格匹配type、endpoint、access_id、access_secret、bucket字段，且路径不能以/开头。
ThinkPHP 云存储不是“装个 SDK 就能用”，核心在于 config/filesystem.php 的 disks 数组是否正确定义了驱动，以及上传路径是否符合目标云服务的 object key 规则——配错一个字段、多一个斜杠、用错配置文件位置，都会导致静默失败或 400 报错。
为什么 Storage::disk('oss')->put() 没反应也不报错？
这不是代码没执行，而是驱动根本没加载成功，框架 fallback 到了默认的 local 或直接返回 false。常见原因：
-
config/filesystem.php文件被改名、挪动位置（比如放到app/config/），或根本没在项目中存在 —— ThinkPHP 只认这个固定路径 - OSS 配置写在了自定义文件如
config/aliyun.php里，但没在disks数组中引用，等于白写 -
disks数组里删掉了原有的'local'或'public'键，导致框架初始化时检测失败，Driver [local] not supported直接抛出 -
type写成'OSS'、'AliyunOSS'或漏掉，必须是小写字符串'oss'
阿里云 OSS 配置字段哪些不能拼错？
thinkphp-filesystem-oss 扩展对键名大小写和完整性极其敏感，四个字段缺一不可且命名必须完全一致：
-
type→ 必须为'oss'（小写，字符串） -
endpoint→ 形如'https://oss-cn-hangzhou.aliyuncs.com'，不能带 bucket 名，不能是内网地址（除非同地域且开通） -
access_id→ 来自 RAM 子账号的 AccessKey ID，**绝不能用主账号 AK** -
access_secret→ 对应的 AccessKey Secret -
bucket→ 纯空间名，如'my-app-bucket'，不带协议、不带域名、不加斜杠
任意一个拼错（比如写成 access_key_id 或 accessKey），SDK 就会抛出 Invalid argument: endpoint 或静默降级到 local 驱动。
上传路径开头有 / 就 400？
OSS 的 object key 不允许以 / 开头，但 ThinkPHP 的 Storage::disk('oss')->put() 不做截断校验，原样发送就会触发 400 Bad Request：
- 错误写法：
Storage::disk('oss')->put('/avatar/123.jpg', $content)→ 返回 400，控制台无明显提示 - 正确写法：
Storage::disk('oss')->put('avatar/123.jpg', $content)→ 正常上传 - 更稳妥做法：上传前用
ltrim($path, '/')清理开头斜杠，尤其当路径来自表单或 URL 参数时
这个细节在本地测试完全没问题，一上 OSS 就崩，而且错误信息极不直观，是最容易被忽略的线上故障点。
多个云存储怎么共存？
只要在 disks 数组里并列定义不同驱动，就能按需切换，无需改代码逻辑：
- 腾讯云 COS 驱动类型是
'cos'，字段用region、secret_id、secret_key - MinIO 兼容 S3，驱动类型填
's3'，必须加'use_path_style_endpoint' => true - 七牛云没有官方
filesystem驱动，需自行封装或改用 SDK 原生调用（Qiniu\Auth+Qiniu\Storage\UploadManager） - 切记：所有驱动都必须通过
Storage::disk('xxx')显式指定，default只影响未指定 disk 时的兜底行为
真正麻烦的从来不是“怎么加一个”，而是“怎么让多个互不干扰地长期跑下去”——路径清理、环境变量隔离、CDN 域名开关、SSL 开关这些细节能卡住你三天。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
