使用XHR POST向Python服务端传Excel文件与参数时,BaseHTTPRequestHandler下如何单独读取上传文件
基于BaseHTTPRequestHandler拆分FormData请求的实现方法
核心说明
BaseHTTPRequestHandler是非常底层的HTTP请求实现,本身没有内置multipart/form-data格式的解析能力,完全不需要从零手写字节切割逻辑,直接用Python标准库的二进制安全解析能力就能把普通输入参数、上传文件完全分开,全程不用装任何第三方依赖。
实现步骤
- 从请求的
Content-Type头里把对应格式的boundary分隔符抠出来,记得处理掉分隔符前后带的引号,不然解析的时候百分百错位 - 按照请求头里
Content-Length的长度,一次性把全量二进制请求体读出来存好,别边读边切,容易遇到TCP拆包读不全的问题 - 用标准库自带的
email消息解析器处理请求体,这个解析器是二进制安全的,能彻底避开手动切割时,把文件流里刚好和boundary重复的字节误判成分隔线的大坑 - 遍历拆分出来的每个消息片段,靠片段里的
Content-Disposition头判断类型:- 带
filename属性的就是上传的文件,直接拿二进制内容就行 - 不带
filename属性的就是普通输入框的参数,解码成文本就能用
- 带
核心实现代码
from email.parser import BytesParser from email.policy import default import io import json class CustomHTTPRequestHandler(BaseHTTPRequestHandler): def do_POST(self): # 校验请求格式 content_type = self.headers.get('Content-Type', '') if not content_type.startswith('multipart/form-data'): self.send_error(400, "仅支持multipart/form-data格式的请求") return # 提取并清洗boundary boundary_raw = content_type.split('boundary=')[1] boundary = boundary_raw.strip('"').encode('utf-8') # 读取全量请求体 content_length = int(self.headers.get('Content-Length', 0)) request_body = self.rfile.read(content_length) # 构造符合解析器要求的原始消息结构 raw_message = io.BytesIO() raw_message.write(f"Content-Type: {content_type}\r\n".encode('utf-8')) raw_message.write(b"\r\n") raw_message.write(request_body) raw_message.seek(0) # 开始拆分内容 msg = BytesParser(policy=default).parse(raw_message) form_params = {} uploaded_files = {} for part in msg.iter_parts(): if part.get_content_disposition() != 'form-data': continue # 获取表单字段名 field_name = part.get_param('name', header='content-disposition') # 判断是否是文件 filename = part.get_filename(header='content-disposition') if filename: # 直接提取二进制流,不做编码转换 file_stream = part.get_payload(decode=True) uploaded_files[field_name] = { "filename": filename, "content": file_stream } else: # 普通参数解码为UTF-8文本 param_value = part.get_payload(decode=True).decode('utf-8') form_params[field_name] = param_value # 后续直接调用即可,比如处理上传的Excel: # if "excelUpload" in uploaded_files: # excel_bytes = uploaded_files["excelUpload"]["content"] # df = pandas.read_excel(io.BytesIO(excel_bytes)) # 返回响应 self.send_response(200) self.send_header('Content-Type', 'application/json') self.end_headers() response_data = json.dumps({"status": "success"}) self.wfile.write(response_data.encode('utf-8'))
常见踩坑提醒
- 别图省事自己写字符串切割逻辑拆请求体:Excel是二进制文件,内容里指不定哪个位置就出现和boundary完全一样的字符序列,手动切完文件直接碎成渣,根本没法正常读取
- 处理上传文件的时候千万别提前做文本编码转换,必须保留原始bytes类型,不然文件会损坏,openpyxl、pandas这些库读的时候直接报错
- 普通参数统一用UTF-8解码就行,和前端FormData的默认编码规则对齐,不会出现乱码
- 如果要传超大文件,可以把逻辑改成流式读取分块处理,避免一次性把大文件读进内存占满资源,常规大小的Excel用上面的逻辑完全够用
内容的提问来源于stack exchange,提问作者Kim Kardashian
相关产品推荐
相关产品推荐

