Python requests 提交表单：data 与 json 区别详解

Python中用requests提交表单时，选择data还是json并非随意取舍，而是取决于后端接口期望的请求体格式与Content-Type：data适用于传统HTML表单（自动urlencode并设为application/x-www-form-urlencoded），后端可通过request.form或request.POST直接读取；json则用于纯API场景（自动序列化并设为application/json），需后端主动解析request.get_json()。传错会导致400错误、字段为空或解析失败等隐蔽问题，而根源往往在于Content-Type不匹配——调试时最有效的方法是打开浏览器DevTools对比真实请求的Headers和Payload，以字节级真相为准。

requests.post 用 data 还是 json？看后端要什么格式

本质区别不是“哪个更高级”，而是发出去的数据体（body）长什么样、Content-Type 是什么。后端接口通常只认一种，错一个就 400 或字段收不到。

• json=xxx 自动把 Python 对象序列化成 JSON 字符串，设 Content-Type: application/json
• data=xxx 原样发——如果传的是 dict，requests 会自动 urlencode 成 key=value&key2=value2，Content-Type 变成 application/x-www-form-urlencoded
• 如果 data 传的是字符串或 bytes，就不会自动编码，Content-Type 也不自动设，得自己加 headers

表单提交（HTML form）对应的是 data，不是 json

浏览器点「提交」按钮，默认就是 application/x-www-form-urlencoded 编码。后端框架（如 Flask 的 request.form、Django 的 request.POST）默认只从这个编码里取值。

• ✅ 正确：用 data={'username': 'alice', 'password': '123'} —— 后端能直接读到 request.form['username']
• ❌ 错误：用 json={'username': 'alice', 'password': '123'} —— 后端 request.form 是空的，得去 request.get_json() 里找，但多数表单接口根本没开这个入口
• ⚠️ 特殊情况：有些前端用 AJAX 模拟表单但手动发 JSON，那后端就得配合改逻辑，这不是标准表单行为

Content-Type 不匹配时的典型错误现象

不是所有报错都写明“类型不对”，容易卡在“参数收不到”“字段为 None”“400 Bad Request”这种模糊反馈上。

• 后端是 Flask + request.form，但你发了 json=... → request.form 为空，打印出来是 ImmutableMultiDict([])
• 后端是 Django + request.POST，你用 json=... → request.POST 是空 QueryDict，request.body 里倒是有 JSON 字符串，但不走 POST 解析流程
• 你用 data 传了一个 dict，但后端期待 JSON → 收到一串 URL 编码字符串，比如 user%5Bname%5D=alice，解析失败
• 用 data 传了 JSON 字符串但忘了设 headers → Content-Type 仍是默认的 application/x-www-form-urlencoded，后端按表单解，自然乱码

想发 JSON 又绕不开表单逻辑？检查后端是否支持 multipart 或混合解析

极少数场景（比如上传文件+JSON元数据），后端可能用 multipart/form-data 包一层。这时候既不能纯 data（没法嵌套结构），也不能纯 json（不支持二进制）。但这种情况必须看接口文档，requests 本身不帮你自动切换。

• 不要自己拼 data=json.dumps(...) + 手动设 Content-Type —— 和直接用 json=... 等价，还多写两行
• 不要对 data 传的 dict 做 json.dumps —— requests 会把它当普通对象再 urlencode 一次，结果变成 %7B%22name%22%3A+%22alice%22%7D
• 真要混用（比如带文件），老实用 files 参数，JSON 字段放 data 里作为字符串键值，别碰 json

最常被忽略的一点：很多调试者盯着 Python 代码改来改去，却没打开浏览器 DevTools 的 Network 标签页，对比「浏览器真实提交」和「requests 提交」的 Request Headers 和 Payload 差在哪——那个 Content-Type 和 body 的实际字节，才是唯一真相。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Python requests 提交表单：data 与 json 区别详解》文章吧，也可关注golang学习网公众号了解相关技术文章。