You need to enable JavaScript to run this app. 使用XHR POST向Python服务端传Excel文件与参数时,BaseHTTPRequestHandler下如何单独读取上传文件
优惠活动
大模型
产品
解决方案
定价
更多

使用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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.27 14:24:03