Postman 里点开请求类型下拉框，请求选 PUT，教程填上 URL，请求点 Send——这事看起来简单，教程但很多人第一次用 PUT 的请求时候都会卡在同一个地方：Body 到底该怎么写？我见过不止一个同事对着 400 报错发呆，最后发现是教程 Content-Type 选错了。

PUT 和 POST 的请求区别，先搞清楚再动手

PUT 的教程语义是"把某个资源整体替换成我给你的这份数据"。注意"整体"两个字。请求你 PUT 一个用户对象，教程只传了 name 字段，请求那这个用户的教程 email、age 全没了——如果后端严格按 HTTP 规范实现的请求话。POST 则是教程"提交一份数据，具体怎么处理你看着办"。请求

实际开发中，很多后端框架对 PUT 的处理没那么严格，你传部分字段它也能跑。但别依赖这个。我自己的习惯是：PUT 请求的 Body 一定带上资源的完整字段，哪怕某些字段值没变。

在 Postman 里发一个 PUT 请求

打开 Postman，新建一个 Request。左上角的方法下拉框默认是 GET，点开换成 PUT。URL 栏填入接口地址，比如 https://api.example.com/users/1024。

切到 Body 标签页。这里有几种模式，PUT 请求最常用的是 raw + JSON：

• 选中 raw
• 右侧下拉框选 JSON（选了之后 Postman 会自动帮你加上 Content-Type: application/json 这个头）
• 在下方编辑区写 JSON 体

一个典型的 Body 长这样：

{  "name": "张伟", "email": "zhangwei@example.com", "age": 28, "role": "admin" }

点 Send。如果返回 200 或 204，基本就成了。

那些容易踩的坑

Content-Type 没设对。 如果你手动选了 raw 但下拉框还停在 Text，Postman 发出去的是 text/plain，后端解析 JSON 直接失败。返回 415 Unsupported Media Type 就是这个原因。

URL 结尾的斜杠。 /users/1024 和 /users/1024/ 在某些框架里路由到不同处理函数。我遇到过加了斜杠就 404 的情况，排查了半小时才发现是这个问题。

认证信息忘了带。 PUT 通常是修改操作，接口一般需要鉴权。切到 Authorization 标签页配好 Token，或者在 Headers 里手动加 Authorization: Bearer xxx。忘了这一步，返回 401，跟 Body 写得对不对没半点关系。

用 form-data 传 JSON。 有人在 Body 里选了 form-data，然后 key 写个 JSON 字符串——后端收到的是一串被转义的文本，不是对象。除非接口文档明确说用 form-data，否则老老实实 raw + JSON。

用环境变量让 URL 灵活起来

接口地址写死在 URL 栏，换到测试环境就得手动改一遍。用 Postman 的环境变量可以省这事。把 URL 写成 { { base_url}}/users/1024，然后在环境里定义 base_url 的值。切换环境时只改变量就行，请求本身不用动。

Body 里也能用变量。比如 "name": "{ { user_name}}"，批量测试不同数据时挺方便。

保存和复用

调通之后按 Ctrl+S 保存请求，放到对应的 Collection 里。下次直接点开就能用，不用重新填一遍。如果这个 PUT 请求需要反复跑不同数据，可以在 Collection 上配 Runner，用 CSV 文件驱动批量执行。

PUT 请求本身没什么神秘的。方法选对，Body 格式对，认证带上，九成的问题就没了。剩下那一成，看后端的返回信息，一般也能定位到。

(责任编辑：综合)