不能直接用obsclient::putobject()，因为会绕过laravel文件系统抽象层的统一路径处理、缓存、url生成等机制，导致storage::url()等方法失效；必须注册自定义flysystem驱动（如overtrue/flysystem-obs），使其实现filesysteminterface并被laravel原生识别，才能保障可维护性与功能完整性。
为什么不能直接用 ObsClient::putObject() 而要注册自定义 Flysystem 驱动
因为 Laravel 的文件系统抽象层（Storage facade）默认只认 local、s3、ftp 这类预置驱动。直接调 ObsClient::putObject() 虽然能传，但会绕过 Laravel 的统一路径处理、缓存、临时上传、URL 生成等机制，导致 Storage::url()、Storage::putFileAs() 等方法失效，后续维护成本陡增。
真正可复用的做法是让 OBS “伪装”成一个标准 Flysystem 驱动，被 Laravel 原生识别。核心在于实现 League\Flysystem\FilesystemInterface 并注入到 StorageManager。
如何注册兼容 Laravel 9+ 的 OBS Flysystem 驱动
华为云官方 PHP SDK（esdk-obs-php）本身不提供 Flysystem 适配器，需手动桥接。推荐使用社区维护的 overtrue/flysystem-obs（已支持 Laravel 9–11），它封装了 ObsClient 并实现了完整 Flysystem 接口。
- 执行
composer require overtrue/flysystem-obs（注意：不要同时装官方esdk-obs-php，该包已内置依赖） - 在
config/filesystems.php的disks数组中添加：
'obs' => [
'driver' => 'obs',
'key' => env('OBS_ACCESS_KEY', ''),
'secret' => env('OBS_SECRET_KEY', ''),
'endpoint' => env('OBS_ENDPOINT', 'https://obs.cn-east-3.myhuaweicloud.com'),
'bucket' => env('OBS_BUCKET', 'your-bucket-name'),
'region' => env('OBS_REGION', 'cn-east-3'),
'prefix' => env('OBS_PREFIX', ''),
'is_cname' => false, // 若 endpoint 是自定义域名且已配置 CNAME，请设为 true
],
- 运行
php artisan config:clear，确保环境变量加载正确 - 测试：执行
Storage::disk('obs')->put('test.txt', 'hello')，成功则返回true
Storage::url() 返回 403 或空字符串的常见原因
这不是代码 bug，而是 OBS 桶策略和 URL 构造逻辑不匹配导致的典型问题。
- 桶策略为
私有时，Storage::url()默认返回的是签名 URL（带Expires和Signature参数），但overtrue/flysystem-obs默认不启用签名；需显式配置'temporary_url' => true并设置'expires' => 3600 - 若桶策略为
公共读，应禁用签名（'temporary_url' => false），此时 URL 格式为https://<bucket>.<endpoint>/path</endpoint></bucket>；但注意：如果 endpoint 是obs.cn-east-3.myhuaweicloud.com，而桶名含英文句号（如my.bucket），DNS 解析会失败——必须改用 path-style URL：https://obs.cn-east-3.myhuaweicloud.com/<bucket>/path</bucket> - 检查
OBS_ENDPOINT是否带协议头（必须含https://）；漏写会导致底层 Guzzle 请求拼接错误 - 确认
OBS_BUCKET名称符合 DNS 规范：不含.或以-开头/结尾，否则 path-style 也无效
大文件分片上传与内存限制的实际处理点
Laravel 的 Storage::put() 默认把整个文件读入内存再上传，对 >20MB 的文件极易触发 Allowed memory size exhausted。OBS 原生支持分片上传（initiateMultipartUpload），但 Flysystem 适配器默认不启用。
-
overtrue/flysystem-obs提供了writeStream()方法，可配合fopen($file->getRealPath(), 'r')流式上传，规避内存峰值 - 更稳妥的方式是跳过 Flysystem，直接用
ObsClient::uploadPart()手写分片逻辑——尤其当需要断点续传或进度回调时 - 务必在
php.ini中调高upload_max_filesize和post_max_size，否则请求根本到不了 Laravel 层 - 前端建议用
axios分块上传 + 后端校验Content-MD5，避免网络中断导致脏数据
真正麻烦的从来不是“能不能传”，而是“怎么让上传行为稳定、可观测、可中断、可审计”。OBS 控制台里的“上传日志”开关默认关闭，记得打开；ObsClient 的 setLogger() 也要配好 Monolog 实例，否则出错时只有 ObsException 一行堆栈，查不到原始 HTTP 请求头。
