---
title: "02-Postman"
created: 2025-12-02
tags:
  - 项目
aliases:
  - Postman
---
# Postman

Postman 是一个非常流行的 API 调试工具，它可以帮助你在没有前端界面的情况下直接测试后端的 API。以下是使用 Postman 的基本步骤和一些常见的操作。

### 一、安装和初步设置

1. **安装 Postman**: 访问 [Postman 官网](https://www.postman.com/)，下载并安装适用于你的操作系统的版本。

   <https://www.postman.com/downloads/>
2. **注册和登录**: 安装完成后，可以选择注册一个 Postman 账户（也可以选择跳过）。

### 二、创建和发送请求

1. **创建一个新请求**:
   - 打开 Postman，点击左上角的 **“+”** 按钮，创建一个新的请求。
   - 选择请求类型（GET、POST、PUT、DELETE等），在左上角的下拉菜单中选择。
   - 在请求栏输入 API 的 URL，例如 `http://localhost:3000/user/account/token/`。
2. **设置请求参数**:
   - **GET 请求**: 直接在 URL 后面添加查询参数，例如 `?id=1`。
   - **POST 请求**: 在 **“Body”** 选项卡中选择 **“raw”**，并选择 **JSON 格式**，输入请求体数据，例如：

     ```
     {

       "username": "zw",

       "password": "123456"

     }
     ```
3. **添加请求头（Headers）**:
   - 在 **“Headers”** 选项卡中，你可以设置请求头，例如 Content-Type 和 Authorization。示例：
     - Key: `Authorization`
     - Value: `Bearer your_token_here`
   - 你还可以设置 `Content-Type` 为 `application/json`。
4. **发送请求**:
   - 设置完成后，点击 **“Send”** 按钮，Postman 将发送请求到服务器。
   - 你可以在下方看到服务器返回的响应数据、状态码、时间等信息。

### 三、查看和分析响应

1. **响应数据**:
   - 在下方的响应区，你可以查看服务器返回的响应数据。Postman 会自动格式化 JSON 数据，便于查看。
   - 你还可以看到响应的状态码（例如 200 OK、404 Not Found）以及响应时间。
2. **响应头（Headers）**:
   - 点击 **“Headers”** 选项卡可以查看服务器返回的响应头，了解服务器的返回信息。

### 四、高级功能

1. **环境变量**:
   - 你可以创建环境变量（Environment Variables）来管理不同环境的 URL、Token 等配置。点击右上角的 **齿轮图标**，选择 **“Manage Environments”**，然后添加环境变量，例如：
     - 变量名：`baseUrl`
     - 值：`http://localhost:3000`
   - 在请求的 URL 中，可以使用变量，如：`{{baseUrl}}/user/account/token/`。
2. **Postman Collections**:
   - 你可以将多个请求保存到一个 **Collection（集合）** 中，便于组织和管理项目。点击左侧 **“Collections”**，创建一个新集合，然后将请求添加进去。
   - 通过集合，你可以快速回顾和执行多个请求。
3. **Pre-request Script 和 Tests**:
   - 在每个请求中，你可以编写 JavaScript 脚本来执行前置操作或测试。例如，在发送请求之前，你可以自动生成 Token，或者在接收到响应后，验证返回数据。

### 五、实战操作示例

**示例：测试登录接口**

1. 创建一个 POST 请求，URL 设置为 `http://localhost:3000/user/account/login/`。
2. 在 Body 中选择 raw，并选择 JSON 格式，输入以下内容：

   ```json
   {

     "username": "zw",

     "password": "123456"

   }
   ```
3. 设置 Headers 中的 Content-Type 为 `application/json`。
4. 点击 Send 发送请求，并查看下方的响应结果。

### 六、使用 Postman 调试常见问题

1. **请求失败**：检查 URL 是否正确、端口号是否一致。
2. **404 Not Found**：确认路由路径是否正确，API 路径拼写无误。
3. **500 Internal Server Error**：查看响应中的错误信息，或在后端查看日志进行排查。
4. **认证失败**：检查请求头中的 Token 是否有效，或重新获取 Token。

通过这些步骤和操作，你可以用 Postman 高效地调试后端 API，无需依赖前端连接测试。

---

**项目分区导航**： [[01-Http请求 以及 Springboot注解|Http请求 以及 Springboot注解]] ⬅️ | 02-Postman |  ➡️ [[03-JWT验证|JWT验证]]