`response = requests.post` 请求返回 400 错误如何排查？

Question

在使用 `response = requests.post` 发送 POST 请求时，若返回 400 错误，通常表示客户端发送的请求有误，服务器无法处理。常见原因包括：请求头（headers）缺失或错误、请求体（body）格式不正确、参数缺失或非法、URL 编码问题等。 排查时应首先打印并检查 `response.text` 或 `response.json()` 获取具体错误信息，再依次验证请求参数、数据格式（如 JSON）、Content-Type 设置是否与接口要求一致。同时可借助 Postman 或 curl 验证请求是否正确，辅助定位问题所在。

Answer 1

一、400错误概述

`requests.post` 是 Python 中用于发送 POST 请求的常用方法。当服务器返回 HTTP 状态码 400（Bad Request）时，通常意味着客户端发送的请求存在格式或内容上的问题。

常见的原因包括：

• 请求头（headers）缺失或配置错误
• 请求体（body）格式不正确（如 JSON 格式错误）
• 参数缺失、非法或类型不符
• URL 编码不正确导致路径解析失败
• 请求体大小超过服务器限制

二、排查流程与分析步骤

为了高效定位 400 错误的原因，可以按照以下流程进行排查：

# 示例代码：打印 response 内容
response = requests.post(url, headers=headers, json=data)
print("Status Code:", response.status_code)
print("Response Text:", response.text)
try:
    print("Response JSON:", response.json())
except ValueError:
    print("Response is not in JSON format")
  

通过输出 `response.text` 或 `response.json()`，可以获得服务器返回的具体错误信息，有助于快速判断是哪一部分出错。

三、常见错误及解决方案

错误类型	可能原因	解决方案
Headers 错误	缺少 Content-Type、Authorization 等关键头部	检查并设置正确的 headers，如 {"Content-Type": "application/json"}
Body 格式错误	JSON 格式不合法，键值对不匹配	使用 json.dumps(data) 验证数据结构，确保无语法错误
参数缺失或非法	必填字段未提供，或传入了非法值	对照接口文档逐项验证参数，使用 try-except 捕获异常
URL 编码问题	特殊字符未编码，影响 URL 解析	使用 urllib.parse.quote() 对参数进行编码处理
请求体过大	POST 数据超出服务器接收限制	减少单次请求的数据量或联系服务端调整限制

四、辅助工具与调试建议

在排查过程中，推荐使用如下工具帮助定位问题：

1. Postman：模拟请求，快速测试接口是否正常
2. cURL 命令：命令行方式复现请求，便于日志记录
3. Logging 日志记录：将请求 URL、headers、data 记录到日志中
4. Mock Server：搭建本地 mock server 测试请求响应逻辑

五、进阶排查思路

对于复杂场景，可考虑以下扩展排查方向：

import logging

logging.basicConfig(level=logging.DEBUG)

response = requests.post(
    url,
    headers=headers,
    json=data,
    timeout=5
)
  

启用 logging 可以看到完整的请求过程，包括 DNS 查询、SSL 握手等底层细节。

六、Mermaid 流程图展示排查逻辑

graph TD
      A[开始] --> B{状态码 == 400?}
      B -- 是 --> C[打印 response.text]
      C --> D[解析错误信息]
      D --> E{是否有 JSON 报错?}
      E -- 是 --> F[检查 JSON 格式]
      E -- 否 --> G[检查 headers]
      F --> H[验证参数合法性]
      G --> H
      H --> I{是否成功?}
      I -- 是 --> J[结束]
      I -- 否 --> K[使用 Postman/curl 验证]