ThinkPHP 6 的 filesystem.php 默认路径是 config/filesystem.php，必须在此文件 disks 数组中配置 OSS 驱动，确保 type='oss'、endpoint、access_id、access_secret、bucket 四字段准确且不带开头斜杠；url() 返回空需检查 is_cname、cdn 或 timeout 配置。
ThinkPHP 6 的 filesystem.php 配置文件在哪
默认路径是 config/filesystem.php，不是 app/config/ 或其他子目录。改错位置会导致配置完全不生效，连本地磁盘驱动都可能报 Driver [local] not supported 错误。
常见错误：把 OSS 配置写进 config/aliyun.php 或自己新建的配置文件，但没在 filesystem.php 里引用 —— ThinkPHP 的文件系统只认这个入口文件里的 disks 数组。
- 确保
disks数组里新增一个键（比如'oss'），值为完整驱动配置 - 不要删掉原有的
'local'和'public'，否则Storage::disk('public')->put(...)会直接报错 - 如果用了多环境（如
.env），优先从环境变量读取敏感字段：env('ALIYUN_OSS_ENDPOINT')，别硬编码
阿里云 OSS 驱动配置必须填对的四个字段
ThinkPHP 官方扩展 thinkphp-filesystem-oss 要求这四个键名严格匹配，拼错一个（比如写成 access_key_id 而非 access_id）就会抛出 Invalid argument: endpoint 或静默 fallback 到 local 驱动。
-
type必须是'oss'（小写，字符串） -
endpoint是地域 Endpoint，形如'https://oss-cn-hangzhou.aliyuncs.com'，不能带 bucket 名，也不能用内网地址（除非服务器和 OSS 同地域且开了内网） -
access_id和access_secret来自阿里云 RAM 子账号的「AccessKey」，**绝不能用主账号 AK** -
bucket是你的存储空间名（如'my-app-bucket'），注意它不包含域名，也不带https://
示例片段：
'oss' => [
'type' => 'oss',
'endpoint' => env('ALIYUN_OSS_ENDPOINT', 'https://oss-cn-hangzhou.aliyuncs.com'),
'access_id' => env('ALIYUN_OSS_ACCESS_ID'),
'access_secret' => env('ALIYUN_OSS_ACCESS_SECRET'),
'bucket' => env('ALIYUN_OSS_BUCKET', 'my-app-bucket'),
],
上传文件时路径开头多出 / 导致 404
OSS 的 object key 不允许以 / 开头，但 ThinkPHP 的 Storage::disk('oss')->put('avatar/123.jpg', $content) 如果传入的是 '/avatar/123.jpg'（开头带斜杠），OSS SDK 会原样发送，结果返回 400 Bad Request，控制台看不到明显报错，只提示“文件不存在”。
- 所有
put()、get()、url()的路径参数，开头不能有/ - 用
ltrim($path, '/')预处理是稳妥做法，尤其当路径来自表单或 URL 参数时 -
url()返回的链接默认不带域名，需手动拼接；若要自动带域名，得在配置里加'cdn' => env('ALIYUN_OSS_CDN')并确保扩展版本 ≥ 2.0.3
为什么 Storage::disk('oss')->url() 返回空字符串
不是代码写错了，大概率是两个原因：一是没在 OSS 配置里设 'is_cname' => true 且没配 'cdn'，二是 bucket 权限为私有但没配签名有效期（'timeout' => 3600）。
- 公开读 bucket：加
'is_cname' => true+'cdn' => 'https://static.example.com'，url()才返回 CDN 地址 - 私有 bucket：必须加
'timeout' => 3600，否则url()返回空；生成的临时链接有效期单位是秒，别写成毫秒 - 检查 OSS 控制台的 bucket 读写权限 —— “公共读”才能直接返回可访问 URL，“私有”必须走签名，且签名链接 15 分钟后失效
复杂点在于：同一个配置，在开发环境（本地测试）可能跑通，上线后因网络策略或 CDN 缓存导致 URL 无法访问，得查 OSS 访问日志和 CloudMonitor。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
