必须将xml转为字符串或io对象再传入put_object，设置content_type为application/xml，统一使用utf-8编码，上传前用nokogiri验证格式，并显式指定与bucket匹配的region。
用 Aws::S3::Client#put_object 传 XML，内容必须是字符串或 IO 对象
XML 不是特殊类型，S3 只认字节流。你不能直接传 Nokogiri::XML 或 Rexml::Document 实例——会报 ArgumentError: data must be a String or IO-like object。
- 正确做法：先调用
to_xml（Nokogiri）或to_s（REXML）转成字符串，再传给put_object - 大文件（>50MB）建议用
File.open(..., 'rb')传 IO 对象，避免内存暴涨 - 别漏设
content_type: 'application/xml'，否则 S3 默认存为binary/octet-stream，下游解析可能失败
中文字符或特殊符号导致 XML 解析失败？检查编码和 Content-MD5
Ruby 默认用 UTF-8，但如果你的 XML 声明里写了 <?xml version="1.0" encoding="GB2312"?>，而实际内容是 UTF-8 字节，S3 不校验，但下游服务一读就报 XML declaration not well-formed。
- 统一用 UTF-8：生成 XML 时确保
encoding="UTF-8"，且字符串本身是有效 UTF-8（str.valid_encoding?返回true） - 加
content_md5参数可防传输损坏：content_md5: Base64.encode64(Digest::MD5.digest(xml_str)).strip - 注意：S3 的
content_md5校验只在上传时比对，不存为元数据，也不影响后续下载
put_object 报 Aws::S3::Errors::BadRequest？大概率是 XML 格式或命名空间问题
这个错误不是权限或网络问题，而是 S3 拒绝接收——常见于 XML 中有非法字符（如控制符 U+0000）、未转义的 &、或 xmlns 前缀重复定义。
- 用
Nokogiri::XML(xml_str)在上传前验证：doc.errors.any?，比靠 S3 报错快得多 - 避免手动拼接 XML 字符串；宁可用
Nokogiri::XML::Builder构造，它自动处理转义和命名空间 - 如果 XML 含 CDATA，确认内部没嵌套
]]>——那是唯一能终结 CDATA 的序列，多一个 > 就崩
Region 不匹配导致超时或 400 错误：必须显式指定 region
哪怕你的 AWS 凭据默认 region 是 us-east-1，只要 bucket 在 cn-north-1，不传 region 就会走默认 endpoint，结果要么连不上，要么返回 AuthorizationHeaderMalformed。
- 初始化 client 时必须写明：
Aws::S3::Client.new(region: 'cn-north-1') - 不要依赖
AWS_REGION环境变量——put_object不读它，只读 client 初始化时的region - bucket 所在 region 和 client region 必须严格一致，大小写敏感（
CN-NORTH-1≠cn-north-1）
Nokogiri::XML，比上传后查 CloudTrail 日志快十倍。
