Python 3.13中cgi.FieldStorage的替代方案咨询

针对HTML表单字段的解析，根据表单编码类型不同，推荐以下几种可靠的替代方案，附实际可运行的代码示例：

1. 处理 application/x-www-form-urlencoded 表单（普通文本字段） #

这种编码是GET和POST表单的默认类型，直接用Python标准库的urllib.parse即可替代，无需额外安装依赖：

import os
from urllib.parse import parse_qs

def parse_urlencoded_form():
    form_data = {}
    request_method = os.environ.get('REQUEST_METHOD', 'GET')
    
    if request_method == 'POST':
        # 读取POST请求体
        content_length = int(os.environ.get('CONTENT_LENGTH', 0))
        post_body = os.read(0, content_length).decode('utf-8')
        form_data = parse_qs(post_body)
    else:
        # 解析GET请求的查询字符串
        query_string = os.environ.get('QUERY_STRING', '')
        form_data = parse_qs(query_string)
    
    # 与FieldStorage行为对齐：单个值的字段直接返回字符串而非列表
    for key in form_data:
        if len(form_data[key]) == 1:
            form_data[key] = form_data[key][0]
    return form_data

2. 处理 multipart/form-data 表单（含文件上传） #

如果表单包含文件上传，推荐使用multipart第三方库（需先执行pip install multipart），它专门用于解析multipart类型的请求体：

import os
from multipart import parse_form_data

def parse_multipart_form():
    env = os.environ
    content_type = env.get('CONTENT_TYPE', '')
    content_length = int(env.get('CONTENT_LENGTH', 0))
    
    # 从标准输入读取请求体
    request_body = os.read(0, content_length)
    
    # 解析表单：fields是普通字段，files是上传的文件
    fields, files = parse_form_data(
        env=env,
        stream=request_body,
        content_length=content_length
    )
    
    # 处理普通字段（转成字符串）
    form_fields = {k: v.decode('utf-8') for k, v in fields.items()}
    
    # 处理上传文件：提取文件名、类型和内容
    uploaded_files = {}
    for key, file_obj in files.items():
        uploaded_files[key] = {
            'filename': file_obj.filename,
            'content_type': file_obj.content_type,
            'content': file_obj.file.read()
        }
    
    return form_fields, uploaded_files

3. 更简洁的通用方案：使用 Werkzeug #

如果可以引入成熟的WSGI工具库，werkzeug的Request对象能自动处理所有表单类型，无需区分编码，用法更省心（需执行pip install werkzeug）：

import os
from werkzeug.wrappers import Request

def parse_form_with_werkzeug():
    # 构建WSGI环境
    wsgi_env = dict(os.environ.items())
    content_length = int(wsgi_env.get('CONTENT_LENGTH', 0))
    
    # 绑定标准输入到WSGI环境
    wsgi_env['wsgi.input'] = os.fdopen(0, 'rb')
    
    # 创建Request对象，自动解析表单
    request = Request(wsgi_env)
    
    # 获取普通表单字段（转成字典）
    form_fields = request.form.to_dict()
    
    # 获取上传文件
    uploaded_files = {}
    for key, file_storage in request.files.items():
        uploaded_files[key] = {
            'filename': file_storage.filename,
            'content_type': file_storage.content_type,
            'content': file_storage.read()
        }
    
    return form_fields, uploaded_files

关于你之前尝试失败的说明 #

• email.message：主要用于解析邮件结构，手动处理multipart表单需要自行拆分边界，容易出错，不适合替代FieldStorage；
• html.parse：是解析HTML文档结构的工具，无法处理HTTP请求体中的表单数据；
• requests：用于发送HTTP请求，而非接收和解析请求，场景不匹配。

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