Laravel默认S3驱动无法直接连接阿里云OSS，因其签名算法（v4）、Endpoint格式、Region命名及HTTP头处理与AWS存在差异；需使用ali-oss-driver包或手动配置AWS_USE_PATH_STYLE_ENDPOINT=true等参数适配。
直接用 Laravel 的 Storage 门面操作 S3 兼容存储（比如阿里云 OSS、腾讯云 COS、AWS S3）是可行的，但必须注意：Laravel 原生只内置了 AWS S3 驱动，对阿里云 OSS 等非标准 S3 接口的服务，不能直接填 oss-cn-hangzhou.aliyuncs.com 就完事——会报 InvalidAccessKeyId 或 SignatureDoesNotMatch。
为什么 Laravel 默认 S3 驱动连不上阿里云 OSS
阿里云 OSS 虽然兼容 S3 协议，但签名算法（v4）、Endpoint 格式、Region 命名规则和默认 HTTP 头处理都和 AWS 有差异。Laravel 7+ 使用的是 aws/aws-sdk-php v3，默认按 AWS 规范生成签名，而阿里云要求：
- OSS Endpoint 必须带协议且不带 bucket 名（如
https://oss-cn-hangzhou.aliyuncs.com） -
use_path_style_endpoint必须设为true（否则会拼成bucket.endpoint子域格式，OSS 不认） - Region 字段不能留空或填错（如填
oss-cn-hangzhou，不是cn-hangzhou） - 部分 SDK 版本需显式指定
endpoint和bucket_endpoint
配置 AWS S3（标准流程）
在 .env 中填写标准 AWS 参数：
AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY AWS_DEFAULT_REGION=us-east-1 AWS_BUCKET=my-bucket-name AWS_ENDPOINT=https://s3.us-east-1.amazonaws.com
然后确保 config/filesystems.php 中 s3 磁盘使用 'driver' => 's3'，并已安装 aws/aws-sdk-php（Laravel 9+ 默认已包含）。
验证命令：
php artisan tinker
>> Storage::disk('s3')->put('test.txt', 'hello oss');
>> Storage::disk('s3')->exists('test.txt');
配置阿里云 OSS（需手动适配）
阿里云 OSS 不是“换 endpoint 就能用”的简单替换。推荐两种可靠方式：
- 用社区维护的
jacobcyl/ali-oss-driver包（专为 Laravel 封装，自动处理签名、endpoint、path style） - 或强制复用 S3 驱动 + 补全关键参数（仅限 Laravel 8.77+ / 9.x，且 SDK ≥ 3.230.0）
若选后者，在 .env 中这样写：
AWS_ACCESS_KEY_ID=your_oss_access_key_id AWS_SECRET_ACCESS_KEY=your_oss_access_key_secret AWS_DEFAULT_REGION=oss-cn-hangzhou AWS_BUCKET=your-bucket-name AWS_ENDPOINT=https://oss-cn-hangzhou.aliyuncs.com AWS_USE_PATH_STYLE_ENDPOINT=true
并在 config/filesystems.php 的 s3 磁盘配置里追加：
'options' => [
'server_side_encryption' => 'AES256',
],
注意：AWS_DEFAULT_REGION 值必须与 Endpoint 中的区域一致（如 oss-cn-shanghai），且不能省略 oss- 前缀。
上传文件时常见 403 错误排查点
出现 Client error: `PUT https://xxx` resulted in a `403 Forbidden` response，优先检查：
-
AWS_ACCESS_KEY_ID和AWS_SECRET_ACCESS_KEY是否复制完整（尤其末尾换行/空格） - 阿里云 RAM 子账号是否已授权
AliyunOSSFullAccess或最小策略（含oss:PutObject、oss:GetObject） - Bucket 是否开启「公共读」？如果没开，
Storage::url()生成的预签名 URL 有效期默认只有 1 小时，直接浏览器访问会 403 - 本地时间是否严重偏差（±15 分钟以上）？OSS 签名校验依赖服务器时间，偏差大会直接拒签
调试建议：临时把 filesystems.php 中磁盘的 'throw' => true 打开，看 SDK 抛出的原始异常信息，比 Laravel 封装后的更准。
最易被忽略的是：阿里云 OSS 的 bucket name 是全局唯一的，但 Laravel 的 AWS_BUCKET 只填名字，不带域名；而有些开发者误填成 https://my-bucket.oss-cn-hangzhou.aliyuncs.com，导致 SDK 拼出双重域名，请求直接失败。
