OCI预认证请求（PAR）创建报错：元数据过大问题排查

一、查找OCI存储桶/对象的元数据 #

1. 通过OCI控制台查看 #

• 登录OCI控制台，进入对象存储服务，定位到目标Compartment下的桶。
• 查看桶级元数据：进入桶详情页，切换至元数据标签页，可查看自定义元数据与系统元数据。
• 查看对象元数据：进入桶内对象列表，点击目标对象，在详情页的元数据标签页查看对应内容。

2. 使用OCI CLI命令查询 #

• 查询桶元数据：

  oci os bucket get --bucket-name <桶名称> --compartment-id <Compartment OCID> --query 'data.metadata'
  

• 查询对象元数据：

  oci os object get --bucket-name <桶名称> --name <对象名称> --query 'data.metadata'
  

二、解决MetadataTooLarge错误 #

1. 清理过大的元数据 #

• 排查桶或对象的自定义元数据，删除冗余键值对，或缩短元数据的值，确保所有元数据编码为UTF-8 JSON后总大小不超过3500字节。
• 注意：OCI自动生成的系统元数据（如opc-meta-*开头的条目）无法修改，问题基本出在自定义元数据上。

2. 批量清理（针对Compartment下全量桶的情况） #

若整个Compartment下的桶都存在该问题，大概率是批量设置了统一的自定义元数据，可通过OCI CLI批量处理：

1. 获取Compartment下所有桶的列表：

   oci os bucket list --compartment-id <Compartment OCID> --query 'data[*].name'
   

2. 遍历桶列表，逐个检查并清理元数据：

   for bucket in $(oci os bucket list --compartment-id <Compartment OCID> --query 'data[*].name' --output text); do
     echo "Processing bucket: $bucket"
     # 获取当前元数据
     metadata=$(oci os bucket get --bucket-name $bucket --compartment-id <Compartment OCID> --query 'data.metadata' --output json)
     # 可添加逻辑判断元数据大小，或直接删除指定元数据键
     # 示例：删除某个特定元数据键
     # oci os bucket update --bucket-name $bucket --metadata '{"<目标键名>": null}'
   done
   

3. 验证修复结果 #

修改完成后，再次尝试创建预认证请求确认错误是否消失，也可通过以下命令验证元数据大小：

# 检查桶元数据的JSON编码字节数
oci os bucket get --bucket-name <桶名称> --compartment-id <Compartment OCID> --query 'data.metadata' --output json | wc -c

内容的提问来源于stack exchange，提问作者Aishwarya