Flask 接收 POST 请求数据为 None 怎么正确获取表单参数

Flask 后端接收 POST 数据为空或 None，通常是因为客户端发送的 Content-Type 请求头与后端使用的解析方法不一致。表单数据应配合 request.form 使用 application/x-www-form-urlencoded，JSON 数据应配合 request.get_json() 使用 application/json。

先说结论：Flask 解析请求体依赖 Content-Type 头部，类型不匹配会导致 request.form 为空或 request.get_json() 返回 None。

先确认：检查客户端请求头 Content-Type 是否为 application/json 或 form-data。
先处理：根据内容类型选择 request.form 或 request.get_json() 方法。
再验证：使用 curl 或 Postman 重发请求并打印接收到的数据。

快速处理思路

根据业务数据类型选择对应的读取方式，不要混用解析方法。

# 场景 1：接收表单数据 (Content-Type: application/x-www-form-urlencoded)
from flask import request
value = request.form.get('key')

# 场景 2：接收 JSON 数据 (Content-Type: application/json)
from flask import request
data = request.get_json()
value = data.get('key') if data else None

为什么会这样

Flask 基于 Werkzeug 构建，Werkzeug 根据请求头 Content-Type 自动决定如何解析请求体。如果发送的是 JSON 但后端查 request.form，解析器不会处理 JSON 负载，导致获取不到数据。request.form 本质是 MultiDict，通常不会为 None 但可能为空；request.get_json() 在类型不匹配或解析失败时默认返回 None。

分步处理

按顺序检查客户端发送格式与后端接收代码，确保两者协议一致。

步骤 1：检查客户端请求头
在浏览器开发者工具 Network 面板或 Postman 中查看请求头。确认 Content-Type 字段。表单提交通常为 application/x-www-form-urlencoded 或 multipart/form-data，API 调用通常为 application/json。

步骤 2：调整 Flask 接收代码
如果客户端发 JSON，后端必须用 request.get_json()。如果客户端发表单，后端必须用 request.form。不要尝试用 request.form 读取 JSON 数据。

@app.route('/api', methods=['POST'])
def handle_post():
    # 安全获取 JSON
    json_data = request.get_json(silent=True)
    if json_data:
        return json_data
    # 安全获取表单
    form_data = request.form
    if form_data:
        return dict(form_data)
    return 'No data', 400

步骤 3：处理 PUT/PATCH 请求特殊情况
部分 Werkzeug 版本对 PUT 请求的表单数据解析支持不完善。如果 PUT 请求 request.form 为空，尝试使用 request.get_json() 或手动解析 request.data。

怎么验证是否生效

使用命令行工具 curl 模拟请求，观察后端日志输出或响应内容。

# 测试表单提交
curl -X POST -d "key=value" http://127.0.0.1:5000/api

# 测试 JSON 提交
curl -X POST -H "Content-Type: application/json" -d "{\"key\":\"value\"}" http://127.0.0.1:5000/api

验证结果：后端日志应打印出对应的字典数据，响应状态码应为 200。如果仍为空，检查 Flask 应用是否启用了请求体日志中间件。

常见坑

以下场景容易导致数据读取失败，开发时需谨慎处理。

Content-Type 拼写错误：如写成 application/json; charset=utf-8 有时会影响解析，建议保持标准格式。
嵌套表单数据：request.form 不支持嵌套 JSON 结构，复杂数据建议直接用 JSON 传输。
silent 参数默认值：request.get_json() 在内容类型不是 JSON 时默认返回 None，设置 force=True 可强制解析但可能引发错误。
文件上传混淆：上传文件时 Content-Type 为 multipart/form-data，此时文件对象在 request.files 中，普通字段仍在 request.form 中。

常见问题

request.form 和 request.args 有什么区别

request.form 获取 POST 请求体中的表单数据，request.args 获取 URL 查询参数。POST 数据用 form，URL 问号后的参数用 args。

request.get_json() 总是返回 None 怎么办

检查请求头是否包含 Content-Type: application/json。如果客户端无法设置头部，可在后端使用 request.get_json(force=True) 强制解析，但需确保数据确实是 JSON 格式。

为什么 PUT 请求无法获取表单数据

Werkzeug 默认仅对 POST 请求自动解析表单数据。PUT 请求建议直接使用 JSON 格式传输数据，或通过 request.data 手动解析。

参考来源

Flask Official Documentation, "Request Data", https://flask.palletsprojects.com/en/latest/api/#flask.Request
Werkzeug Documentation, "Request Data", https://werkzeug.palletsprojects.com/en/latest/datastructures/#werkzeug.datastructures.ImmutableMultiDict