ThinkPHP配置阿里云OSS失败主因是配置位置、字段名、路径格式或环境变量不匹配：必须将OSS配置写入config/filesystem.php的disks数组，字段type='oss'、endpoint、access_id、access_secret、bucket须严格准确，上传路径不能以/开头，敏感信息须通过.env+env()读取。
ThinkPHP 配置阿里云 OSS 存储失败，常见问题不是代码写错，而是配置路径、字段名、环境变量或路径格式不匹配。修复重点在 配置位置必须对、字段名必须准、路径开头不能斜杠、环境变量要生效。
OSS 配置必须写在 config/filesystem.php
ThinkPHP 6/7/8 的文件系统只认 config/filesystem.php 中的 disks 数组。写在 config/aliyun.php、.env 外部文件或自定义配置里，框架完全不加载。
- 打开
config/filesystem.php，找到'disks' => [ ... ]数组 - 在其中新增一个键（如
'oss'），值为完整配置数组 - 不要删掉原有的
'local'和'public'，否则Storage::disk('public')会报错
四个核心字段名和值必须严格正确
OSS 驱动（thinkphp-filesystem-oss）对字段名大小写和拼写极度敏感，错一个就静默回退到 local 驱动，或直接报 Invalid argument: endpoint。
-
'type' => 'oss'（小写，字符串，不能是'OSS'或'aliyun_oss'） -
'endpoint'：必须是地域 Endpoint，例如'https://oss-cn-hangzhou.aliyuncs.com'；不能带 bucket 名，不能用内网地址（除非同地域且已开通） -
'access_id'和'access_secret'：来自 RAM 子账号的 AccessKey，绝不可用主账号 AK -
'bucket'：仅填存储空间名（如'my-app-bucket'），不加域名、不加https://
上传路径开头不能带 /
OSS 的 Object Key 不允许以 / 开头。如果调用 Storage::disk('oss')->put('/avatar/123.jpg', $content)，SDK 会原样发送，OSS 返回 400 错误，但 ThinkPHP 不抛异常，url() 返回空字符串，调试极难定位。
立即学习“PHP免费学习笔记（深入）”；
- 所有
put()、get()、url()的路径参数，必须去掉开头的/ - 正确写法：
Storage::disk('oss')->put('avatar/123.jpg', $content) - 可统一封装路径处理逻辑，避免业务层误传
环境变量和敏感信息要显式读取
硬编码 AK/SK 极不安全，也违反部署规范。应通过 .env 管理，并在配置中用 env() 显式读取。
- 在
.env中写：ALIYUN_OSS_ENDPOINT=https://oss-cn-hangzhou.aliyuncs.com等 - 在
filesystem.php中写：'endpoint' => env('ALIYUN_OSS_ENDPOINT') - 确保
env()函数可用（TP6+ 默认支持；TP5.1 需确认已加载 dotenv） - 若
env()返回空，检查.env是否被 Git 忽略、是否放在项目根目录、是否被其他配置覆盖
