使用Python REST API上传二进制STL至Windchill时文件损坏问题

问题根源 #

你用格式化字符串处理二进制文件内容的方式是错误的。当你把bytes类型的文件内容直接塞进格式化字符串时，Python会自动将其转换为字符串表示形式（带b''包裹、转义字符被处理），而不是发送原始二进制流，这直接导致了字节篡改、内容截断，最终文件损坏。

正确解决方案 #

方案1：使用Requests原生files参数（推荐）

Requests内置了对multipart/form-data请求的支持，无需手动构造payload，直接传入文件对象即可保证二进制数据正确传输：

import requests

# 替换为你的Windchill上传接口URL
upload_url = "你的上传接口地址"
stl_file_path = files[0]

# 构造files参数，key需与Windchill接口要求的字段名匹配
with open(stl_file_path, 'rb') as stl_file:
    request_files = {
        # 格式：(文件名, 文件对象, MIME类型)
        'uploadFile': ('model.stl', stl_file, 'application/octet-stream')
    }
    response = requests.post(upload_url, files=request_files)

# 验证响应状态
if response.status_code == 200:
    print("文件上传成功")
else:
    print(f"上传失败，状态码：{response.status_code}")

方案2：用requests-toolbelt构造复杂multipart请求

如果接口需要额外表单字段，或有特殊格式要求，使用requests-toolbelt的MultipartEncoder来处理：

import requests
from requests_toolbelt.multipart.encoder import MultipartEncoder

upload_url = "你的上传接口地址"
stl_file_path = files[0]

# 构造包含文件和其他字段的multipart表单
encoder = MultipartEncoder(
    fields={
        'uploadFile': ('model.stl', open(stl_file_path, 'rb'), 'application/octet-stream'),
        'additional_field': '额外参数值'  # 如有其他表单字段可添加
    }
)

# 发送请求，需指定Content-Type为encoder生成的类型
response = requests.post(
    upload_url,
    data=encoder,
    headers={'Content-Type': encoder.content_type}
)

错误方式的本质 #

你之前的代码中，content = f.read()得到的是bytes对象，将其传入格式化字符串时，相当于执行了str(content)，这会把原始二进制转成类似b'\x00\x00...'的ASCII字符串。上传时实际发送的是这个字符串的字节，而非原始二进制数据，必然导致文件损坏。

验证方法 #

上传前后对比文件哈希值，确认数据完整性：

import hashlib

def calculate_file_hash(file_path, algorithm='md5'):
    hash_obj = hashlib.new(algorithm)
    with open(file_path, 'rb') as f:
        while chunk := f.read(4096):
            hash_obj.update(chunk)
    return hash_obj.hexdigest()

# 原文件哈希
original_hash = calculate_file_hash(stl_file_path)
# 下载上传后的文件，计算哈希
uploaded_hash = calculate_file_hash("下载的上传后文件路径")

print(f"原文件哈希: {original_hash}")
print(f"上传后文件哈希: {uploaded_hash}")
print(f"文件是否完整: {original_hash == uploaded_hash}")

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