0002-00000228

问题描述

使用V4签名认证时,URL签名中身份凭证(Credential)指定的签名地域信息不合法。该错误表示签名时Credential参数中使用的地域无效,可能是不存在的地域,或者与Bucket所属地域不匹配。

问题原因

您发起了一个使用V4认证的请求,但出现以下情况之一:

  • URI中包含的区域标识不正确或不被支持

  • 签名中的地域与Bucket实际所在地域不一致

  • 使用了不存在的地域标识

问题示例

示例1:使用了无效的地域标识

GET /oss.jpg HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Sun, 01 Jun 2025 16:38:30 GMT
Authorization: OSS4-HMAC-SHA256 Credential=YourAccessKeyID/20250601/InvalidRegion/oss/aliyun_v4_request, SignedHeaders=host;x-amz-date, Signature=YourSignature

由于 InvalidRegion 不是阿里云支持的 OSS 区域,请求将返回此错误。

示例2:地域与Bucket所在地域不匹配

GET /oss.jpg HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Sun, 01 Jun 2025 16:38:30 GMT
Authorization: OSS4-HMAC-SHA256 Credential=YourAccessKeyID/20250601/cn-beijing/oss/aliyun_v4_request, SignedHeaders=host;x-amz-date, Signature=YourSignature

Bucket位于杭州地域(cn-hangzhou),但签名中使用了北京地域(cn-beijing),导致地域不匹配。

解决方案

请确保在使用Auth V4的请求中:

  • 签名的地域标识必须与Bucket所在地域一致

  • 使用正确的地域标识格式(如:cn-hangzhou、cn-beijing等)

  • 确认Bucket实际所在地域,可通过OSS控制台查看

修改后的正确请求示例:

GET /oss.jpg HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Sun, 01 Jun 2025 16:38:30 GMT
Authorization: OSS4-HMAC-SHA256 Credential=YourAccessKeyID/20250601/cn-hangzhou/oss/aliyun_v4_request, SignedHeaders=host;x-amz-date, Signature=YourSignature

Credential中的地域(cn-hangzhou)必须与Host中的地域保持一致。