Linux Postman如何设置接口请求体
作者：袖梨
2026-07-29
接口请求体实用设置指南：Linux下 Postman
一 基础设置流程
- 在 Linux 中安装并启动 Postman（下载 Linux 版本压缩包、解压至 /opt、创建软链，如
sudo ln -s /opt/Postman/Postman /usr/local/bin/postman，终端执行postman启动）。 - 输入 URL，并新建采用 POST/PUT/PATCH 等方法的请求。
- 数据需要填写在 Body 选项卡中，所用 Body 类型由接口要求决定。
- Headers 若未获得自动配置，需要手动加入 Content-Type；application/json 或 application/x-www-form-urlencoded 均是示例。
- 发送操作由 Send 完成；状态码、响应头及响应体随后会显示在下方 Response 区域。
- 请求若需组织和复用，应保存至 Collections；变量（如则交由 Environments 管理
{{base_url}}）。
二 常用 Body 类型及配置要点
| 类型 | 适用场景 | 关键设置 | 示例 |
|---|---|---|---|
| raw – JSON | RESTful 接口、创建或更新资源 | Content-Type: application/json 须得到保证；操作路径是 JSON ← raw ← Body | { "name": "Alice", "age": 30 } |
| x-www-form-urlencoded | 登录、传统表单提交等 | 选择 Body → x-www-form-urlencoded；Content-Type 将由 Postman 自动设置 | key: username，value: test |
| form-data | 混合字段、文件上传 | 文本字段和文件字段均能添加；对应入口为 form-data ← Body | desc: “upload”；file: 选择文件 |
| binary | 图片、PDF等纯二进制数据 | 选择 Body → binary；然后选择文件 | 选中 avatar.png |
- 说明：GET/DELETE 通常不带请求体；JSON 最常用且需保证 JSON 有效 与 Content-Type 正确。
三 Postman 配置与常见后端场景对照
| 后端接收方式 | Postman 设置 | 注意点 |
|---|---|---|
| @RequestBody Map<String, String>（Spring） | application/json 添加至 Header；Body 的路径为 raw → JSON | 不可通过 Params 传递；同时确保 JSON 语法无误 |
表单参数（如 application/x-www-form-urlencoded） | Body → x-www-form-urlencoded | 采用键值对填写；Content-Type 将由 Postman 自动设置 |
文件上传（如 multipart/form-data） | 添加文件字段，Body 类型设为 form-data | 选定文件；还可一并添加文本描述字段 |
- 提示：查询参数和表单键值对不适用于后端以 @RequestBody 接收的情况，此时 Postman 应提交 JSON 请求体。
四 使用 Newman 进行命令行与自动化运行
- 安装 Newman（Postman 命令行工具）：
npm install -g newman。 - 集合在 Postman 中以 JSON 文件（如格式 Export
collection.json）。 - 随后在 Linux 终端运行：
newman run collection.json，接口请求和测试因而能在服务器或 CI/CD 上批量执行。
五 故障排查清单
- Content-Type 和 Body 类型不匹配时会出现 415 Unsupported Media Type，需检查二者对应关系（JSON →
application/json，表单 →application/x-www-form-urlencoded）。 - 遇到 400/422 或后端不能解析时，应确认 JSON 有效且字段名、类型正确；结构化数据需用 raw – JSON 发送。
- 上传文件未成功，应正确选取文件字段，并把类型调整成 form-data。
- 需要鉴权的接口，应将 Authorization: Bearer 添加到 Headers 也可以通过环境变量管理令牌。
