从LocalStack S3下载XML文件出现转义字符问题求助

这种情况的核心原因是上传XML时错误地将内容做了字符串转义处理（比如JSON序列化），而非直接上传原始字节流，LocalStack的S3本身不会自动修改文件内容，问题出在上传环节。以下是具体解决方案：

1. 修正上传代码（关键） #

检查你的上传逻辑，避免对XML内容做多余的转义操作，直接上传原始字节流：

• 错误示例（导致转义的常见写法）：

  import boto3
  import json
  
  s3 = boto3.client('s3', endpoint_url='http://localhost:4566')
  with open('test.xml', 'r') as f:
      xml_content = f.read()
  # 错误：用json.dumps将XML转为带转义的字符串
  s3.put_object(Bucket='my-bucket', Key='test.xml', Body=json.dumps(xml_content), ContentType='text/xml')
  

• 正确上传方式：

  import boto3
  
  s3 = boto3.client('s3', endpoint_url='http://localhost:4566')
  # 方式1：直接上传二进制文件对象
  with open('test.xml', 'rb') as f:
      s3.put_object(Bucket='my-bucket', Key='test.xml', Body=f, ContentType='text/xml')
  # 方式2：读取二进制内容后上传
  with open('test.xml', 'rb') as f:
      xml_bytes = f.read()
  s3.put_object(Bucket='my-bucket', Key='test.xml', Body=xml_bytes, ContentType='text/xml')
  

  注意：必须使用rb（二进制读取）模式，避免文本编码引发的额外转换。

2. 修复已上传的问题文件 #

如果已经上传了带转义的文件，可通过反转义恢复原始XML：

import json

# 假设从S3下载的内容是带转义的字符串
escaped_content = '"<?xml version=\"1.0\"?>\n<root>\n  <item attr=\"value\">text</item>\n</root>"'
# 用json.loads自动解析转义内容
raw_xml = json.loads(escaped_content)
# 保存原始XML
with open('fixed.xml', 'w', encoding='utf-8') as f:
    f.write(raw_xml)

或者直接字符串处理：

fixed_xml = escaped_content.strip('"').replace('\\"', '"').replace('\\n', '\n')

3. 验证LocalStack与下载逻辑 #

• 用LocalStack CLI直接查看S3文件内容，确认上传是否正确：

  awslocal s3 cp s3://my-bucket/test.xml -
  

  若输出原始XML，说明上传正常，问题出在下载工具/代码；若输出带转义内容，回到上传环节排查。
• 下载时直接读取字节流，避免多余处理：

  s3 = boto3.client('s3', endpoint_url='http://localhost:4566')
  response = s3.get_object(Bucket='my-bucket', Key='test.xml')
  # 直接保存二进制内容
  with open('downloaded.xml', 'wb') as f:
      f.write(response['Body'].read())
  

4. 排查LocalStack版本 #

确保使用最新版LocalStack，旧版本可能存在S3兼容性问题，执行localstack update更新。

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