直接原因是oss sdk类未被正确加载；需安装兼容tp5.1的aliyuncs/oss-sdk-php:2.5.2版本，确认自动加载生效，并安装think-filesystem-oss扩展及正确注册服务提供者。
直接原因是 OSS SDK 类未被正确加载，不是配置写错或网络问题。TP5.1 默认不自带 OSS 驱动，必须手动安装兼容版本并确保类能被自动加载。
确认是否已安装适配的 SDK 版本
TP5.1 常用 PHP 7.2–7.4，而阿里云新版 OSS SDK（v2.6+）要求 PHP 8.0+，强行安装会导致 Class not found。必须锁定旧版：
- 执行
composer require aliyuncs/oss-sdk-php:2.5.2（这是最后一个支持 PHP 7.3+ 的稳定版） - 检查
vendor/aliyuncs/oss-sdk-php/src/OSS/OssClient.php是否存在 - 避免使用
^2.6或latest，否则类加载会失败
验证自动加载是否生效
TP5.1 依赖 Composer 的 autoload 机制，常见断点在入口或扩展加载环节：
- 确认
public/index.php中已包含require __DIR__ . '/../vendor/autoload.php'; - 若曾手动修改过
composer.json的 autoload 配置，需运行composer dump-autoload - 在控制器中临时加一行：
var_dump(class_exists('OSS\OssClient'));，返回false即说明加载失败
检查文件系统驱动是否注册成功
即使 SDK 存在，ThinkPHP 仍需通过 thinkphp-filesystem-oss 扩展桥接。该扩展不是官方内置，需额外安装：
- 执行
composer require topthink/think-filesystem-oss（TP5.1 兼容版） - 确认
config/filesystem.php中'type' => 'oss'拼写全小写，不能是OSS或aliyun_oss - 检查该扩展的 Service Provider 是否被引入——TP5.1 需在
application/provider.php中手动添加：think ilesystemOssServiceProvider::class
排除配置干扰项
错误提示为 “not found”，说明尚未走到配置解析阶段，但以下问题可能掩盖真实原因：
- 误把 SDK 当作配置项，在
config/filesystem.php里写了'oss' => [...]却没装驱动包 - 在
.env中定义了OSS_ACCESS_KEY_ID等变量，但未在配置中用env()读取，导致驱动初始化时因缺失参数抛出异常，部分环境会退化为类未找到提示 - 清空一次配置缓存：
php think clear，避免旧缓存干扰类加载判断
