LinkedIn大视频multipart上传完成时报元数据反序列化失败求助

该报错触发逻辑是：分片全部上传完成后，你调用合并完成接口时提交的元数据不符合服务端反序列化规则，和分片上传过程的文件传输逻辑无关，使用Python requests实现时按以下优先级排查：

1. 修正元数据的提交格式 #

90%的同类问题都是元数据提交格式错误导致的：不要直接把Python字典作为data参数传入requests，requests默认会将字典编码为application/x-www-form-urlencoded格式，服务端拿到的内容不是合法JSON结构，自然无法反序列化。

• 错误写法：

# 错误：直接传字典，会被自动编码为表单键值对，不是服务端要求的JSON结构
metadata = {
    "upload_id": init_resp["upload_id"],
    "parts": [{"part_number": 1, "etag": part1_etag}, {"part_number": 2, "etag": part2_etag}]
}
resp = requests.post(complete_upload_url, data=metadata, headers=auth_headers)

• 正确写法：

import json
# 先将元数据序列化为标准JSON字符串
metadata_str = json.dumps({
    "upload_id": init_resp["upload_id"],
    # part_number必须是整数类型，不要传字符串
    "parts": [{"part_number": idx+1, "etag": etag} for idx, etag in enumerate(uploaded_part_etags)]
})
# 如果接口要求元数据作为multipart表单的一个字段提交，按如下方式传，指定字段的Content-Type为application/json
form_payload = {
    "metadata": (None, metadata_str, "application/json")
}
resp = requests.post(complete_upload_url, files=form_payload, headers=auth_headers)

# 如果接口要求元数据直接放在请求体作为JSON提交，直接用json参数传字典即可，不要混用data参数
# resp = requests.post(complete_upload_url, json=json.loads(metadata_str), headers=auth_headers)

2. 校验元数据字段的合法性 #

格式正确仍报错的话，逐字段核对传值规则：

• upload_id必须和初始化分片接口返回的原始值完全一致，不要做额外的url编码、截断，不要夹带空格、换行符
• part_number必须从1开始连续编号，不能从0开始，不能缺号、跳号，类型必须是整数，不能传字符串格式的数字
• 每个分片的etag必须使用对应分片上传成功后服务端返回的etag值，注意大小写匹配，不要用本地计算的文件哈希值替代
• 不要传入接口文档未声明的额外字段，多余字段会触发服务端的反序列化校验失败

3. 回溯分片上传阶段的问题 #

以上两点都确认无误仍报错的话，检查分片上传环节的隐藏问题：

• 确认分片大小符合接口要求：除最后一个分片外，其余分片大小必须满足接口规定的最小分片阈值（通常为5MB/10MB），分片大小不统一会导致服务端元数据校验不通过
• 每个分片上传完成后必须校验返回状态码为200/201，不要将上传失败分片的返回值作为有效etag传入完成接口
• 分片上传请求不要夹带和分片无关的多余表单字段，避免服务端将冗余字段写入上传会话的元数据存储，导致合并阶段反序列化失败

4. 快速调试方法 #

如果还是找不到问题，开启requests的调试日志，打印实际发出的请求内容，和接口文档的示例逐字符对比：

import http.client
import logging
http.client.HTTPConnection.debuglevel = 1
logging.basicConfig()
logging.getLogger().setLevel(logging.DEBUG)
# 之后发起的所有requests请求都会打印实际发送的请求头、请求体，直接定位格式偏差

从报错的类路径com.linkedin.vector.utils可以判断，你对接的是LinkedIn技术栈的接口，这类接口对元数据的字段类型、格式校验极严，哪怕是数字类型传成字符串、JSON多一个尾逗号，都会直接抛出反序列化失败错误，不要忽略字段类型匹配问题。

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