先给结论:阿里云OSS V1签名下线、强制V4签名,直接导致大量旧版OSS插件彻底报错/无法上传/无法访问 。下面按影响、表现、如何处理三部分讲清楚。
一、官方时间线(必须重视)
– 2025-03-01:新用户(新UID)不再支持V1签名 。
– 2025-09-01:停止维护V1,新增Bucket必须用V4 。
– 2026-05-18现在:旧Bucket虽暂时可用V1,但随时可能被关停,新Bucket完全无法用旧插件 。
二、对OSS插件的影响(WordPress/宝塔/各类面板)
1)旧插件(最常见)
– 特征:2024年前未更新、依赖旧版PHP SDK、无V4配置项。
– 现象:
– 上传失败:报 SignatureDoesNotMatch 、 InvalidSignature 。
– 图片裂图:URL生成用V1签名,新Bucket直接拒绝访问 。
– 配置报错:Region/Endpoint填了也无效,提示签名错误 。
– 典型:OSS Upload、旧版WP-OSS、宝塔官方下架的OSS插件、各类“一键OSS”老插件。
2)新插件/适配版
– 特征:2025年后更新、基于PHP SDK ≥2.7.0、支持V4签名+Region填写 。
– 现象:正常上传、正常访问,新老Bucket都能用 。
– 典型:Image Auto Sync To OSS(1.0.3+)、增强版OSS Upload、子比优化版、官方SDK重构的插件 。
3)核心差异(V1 vs V4)
– V1:只需AK/SK/Endpoint,无Region,已淘汰 。
– V4:必须填AK/SK/Endpoint/Region(如cn-hangzhou),签名算法升级为 OSS4-HMAC-SHA256 。
三、你现在该怎么做(分场景)
✅ 场景1:WordPress网站(最常见)
1. 先查插件是否支持V4:
– 看设置页有没有Region/地域输入框 → 有=支持V4;无=旧版,必换 。
2. 直接换适配插件(二选一,稳):
– Image Auto Sync To OSS(免费):支持V4、PHP8+、自动上传 。
– 增强版OSS Upload(推荐):兼容PHP8+、修复签名问题、保留旧功能。
3. 配置要点(V4必填):
– Endpoint: oss-cn-xxx.aliyuncs.com (内网/外网对应) 。
– Region: cn-xxx (如杭州=cn-hangzhou) 。
– 签名版本:选V4(插件里一般叫“新版签名”) 。
✅ 场景2:宝塔面板/服务器备份插件
– 官方插件已下架,旧版社区插件不支持V4,新Bucket无法用。
– 方案:
– 改用七牛云/腾讯云COS插件(面板官方仍维护)。
– 或手动装适配V4的第三方OSS插件(如bt-oss增强版)。
✅ 场景3:自己开发/二次修改插件
– 升级PHP SDK到2.7.0+ 。
– 初始化客户端时强制V4+Region:
php
$client = new OssClient($ak, $sk, $endpoint);
$client->setSignatureVersion(OssClient::OSS_SIGNATURE_VERSION_V4);
$client->setRegion($region); // 如cn-hangzhou
“`[[__LINK_ICON]](https://help.aliyun.com/zh/oss/developer-reference/initialization-6?f_link_type=f_linkinlinenote&flow_extra=eyJpbmxpbmVfZGlzcGxheV9wb3NpdGlvbiI6MCwiZG9jX3Bvc2l0aW9uIjowLCJkb2NfaWQiOiJiMzEzMmVhMTFiNTcwMTBiLTM3NmM1OWFkOWY2MzNhYWMifQ%3D%3D&inline_doc_id=b3132ea11b57010b-376c59ad9f633aac)
—
### 四、快速自检(30秒搞定)
1. 看插件设置:**有无Region框** → 无=危险,必换[[__LINK_ICON]](https://help.aliyun.com/zh/oss/developer-reference/initialization-6?f_link_type=f_linkinlinenote&flow_extra=eyJpbmxpbmVfZGlzcGxheV9wb3NpdGlvbiI6MCwiZG9jX3Bvc2l0aW9uIjowLCJkb2NfaWQiOiJiMzEzMmVhMTFiNTcwMTBiLTM3NmM1OWFkOWY2MzNhYWMifQ%3D%3D&inline_doc_id=b3132ea11b57010b-376c59ad9f633aac)。
2. 抓包看请求头:`Authorization`开头是`OSS4-HMAC-SHA256`=V4;`OSS `=V1(淘汰)[[__LINK_ICON]](https://developer.aliyun.com/ask/697726?f_link_type=f_linkinlinenote&flow_extra=eyJpbmxpbmVfZGlzcGxheV9wb3NpdGlvbiI6MCwiZG9jX3Bvc2l0aW9uIjowLCJkb2NfaWQiOiJlNzdkMzY2ODlhNDU2OWI4LTNhOGU5YTIwMTRlYmI3OWUifQ%3D%3D&inline_doc_id=e77d36689a4569b8-3a8e9a2014ebb79e)。
3. 新Bucket测试:旧插件**完全无法上传**,直接报错[[__LINK_ICON]](https://www.alibabacloud.com/zh/notice/notice_on_the_discontinuation_of_the_oss_v1_signature_algorithm_40f?_p_lc=1&f_link_type=f_linkinlinenote&flow_extra=eyJkb2NfcG9zaXRpb24iOjAsImRvY19pZCI6IjQxNzFlYTdjMTA4MWY0ZDgtY2M1NTE4YmQzNTdlNTViYyIsImlubGluZV9kaXNwbGF5X3Bvc2l0aW9uIjowfQ%3D%3D&inline_doc_id=4171ea7c1081f4d8-cc5518bd357e55bc)。
—
### 五、一句话总结
**旧OSS插件=已死刑,新Bucket彻底不能用;必须换2025年后更新、支持V4+Region的插件**[[__LINK_ICON]](https://www.alibabacloud.com/zh/notice/notice_on_the_discontinuation_of_the_oss_v1_signature_algorithm_40f?_p_lc=1&f_link_type=f_linkinlinenote&flow_extra=eyJpbmxpbmVfZGlzcGxheV9wb3NpdGlvbiI6MCwiZG9jX3Bvc2l0aW9uIjowLCJkb2NfaWQiOiI0MTcxZWE3YzEwODFmNGQ4LWNjNTUxOGJkMzU3ZTU1YmMifQ%3D%3D&inline_doc_id=4171ea7c1081f4d8-cc5518bd357e55bc)。

