Ruby脚本通过curl调用GCS签名URL上传文件失败问题求助

核心触发逻辑 #

该错误本质是GCS将你的上传请求识别为修改存储桶配置的请求，要求提交符合格式的XML配置文件，但你上传的是普通文本文件，因此触发格式校验失败。以下是Windows + Ruby 2.7环境下的常见诱因：

• 生成签名URL时指定的路径错误
  若调用signed_url方法时，目标路径为存储桶根路径（如/bucket-name/）而非具体对象路径（/bucket-name/hello_world.txt），GCS会默认将PUT请求判定为存储桶配置修改请求，触发XML格式校验。
  修复方案：生成签名时明确指定待上传的对象完整路径，参考代码：

  require "google/cloud/storage"
  # 初始化客户端
  storage = Google::Cloud::Storage.new(project_id: "你的项目ID", credentials: "密钥文件路径")
  bucket = storage.bucket "目标桶名"
  # 针对具体待上传对象生成PUT签名URL
  signed_url = bucket.signed_url "hello_world.txt", method: "PUT", expires: 3600, content_type: "text/plain"
  puts signed_url
  

• 签名声明的请求头与实际curl请求头不匹配
  若生成签名时指定了content_type: "application/xml"，但curl上传时实际传的是文本文件，GCS会按照XML格式解析上传内容，触发校验失败。
  修复方案：生成签名时声明的Content-Type与curl请求携带的Content-Type完全一致，且与上传文件格式匹配。
• Windows环境curl命令转义错误
  Windows的CMD/PowerShell与Linux的Shell转义规则不同，常见错误包括：
  1. 签名URL包含&符号时未用引号包裹，导致URL被截断，实际请求路径变为存储桶根路径
  2. 错误使用-d参数上传文件，-d会自动修改请求头为表单格式，且会对文件内容做转码处理
     修复方案：Windows下使用以下标准curl命令，注意URL必须用双引号包裹：

  curl -X PUT --upload-file hello_world.txt -H "Content-Type: text/plain" "替换为生成的签名URL"
  

• 签名URL携带了存储桶配置相关的查询参数
  若生成签名时额外传入了query_params包含storageClass、lifecycle等存储桶配置相关参数，GCS会将请求判定为配置修改请求，触发XML校验。
  修复方案：普通文件上传不需要额外添加存储桶配置相关的查询参数，生成签名时移除该类参数即可。

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