Postman的使用 - 我的学习小铺

一、Postman是什么？#

Postman是一款强大的API开发与测试工具，在Java后端开发中主要用于模拟HTTP客户端，用来调试和测试你开发的RESTful API或WebService接口。

它的重要性在于：

独立验证：不依赖前端页面，单独测试后端接口的请求、响应、业务逻辑和异常处理是否正确。
问题排查：快速定位问题是出在前端调用、网络传输还是后端服务本身。
协作与文档：生成并分享接口文档和测试用例，方便团队协作。

官网下载地址：https://www.postman.com/downloads/

二、Postman的基本使用#

1、登录#

Postman是需要登录的，如果不登录，则无法使用Postman的更多功能。比如，保存请求，创建工作空间等功能都无法使用。登录的时候会跳转默认浏览器。如果跳转的默认浏览器不是谷歌浏览器的话，可以按照下图点击 copy the URL 将登录路径复制到谷歌浏览器登录即可！

2、界面介绍#

Postman的主界面主要包含以下几个部分：

区域	功能说明
请求区	设置请求方法（GET/POST等）、URL、参数、Headers、Body等
响应区	查看服务器返回的响应数据、状态码、响应时间等
侧边栏	管理Collections（集合）、Environments(环境变量)、History（历史记录）等

3、新建工作空间#

通过新建工作空间，可以对请求接口做分类管理。比如你可以去一家公司就新建一个工作空间。当然，你也可以每一个项目就新建一个工作空间。

进入如下界面，填写，工作空间名称、描述、可见性等信息。

4、新建集合#

新建集合，也可以简单的理解就是建立目录。跟目录不同的是，集合他可以独立导出、生成文档、Mock 与自动化测试。通过合理的目录结构，可以清晰、有序地对接口请求进行分类管理。若你的工作空间以公司维度划分，则集合可直接用项目名称命名；其下再按功能模块细分子目录。若工作空间已按项目维度隔离，则集合无需再出现项目名，直接以功能模块命名即可。

5、新建请求#

出出现如下界面

注意：在 Postman 里，只要新建或修改了请求，不保存就等于“本地草稿”。不ctrl s保存，变更不会上传到云端，账号里仍是旧版本；换电脑、重新登录后，看到的只能是上次保存时的状态——新改的内容全没了。

5.1 GET请求#

GET请求用于从服务器获取数据，参数通常通过URL传递。

URL参数设置方式：

方式一：直接在URL中拼接参数

1
http://localhost:81/dev-api/system/user/list?pageNum=1&pageSize=10

方式二：使用Params面板（推荐）

点击 Params 按钮
在Key-Value表格中输入参数名和值
Postman会自动拼接到URL中

2.2 POST请求#

POST请求用于向服务器提交数据，数据通常放在请求体（Body）中。

类型	使用场景	示例
form-data	文件上传、表单提交	multipart/form-data
x-www-form-urlencoded	普通表单提交	键值对格式
raw	JSON/XML等格式数据	application/json
binary	二进制文件上传	文件流

JSON格式请求(最常用）：

文件上传，一般使用form-data：

2.3 PUT请求#

PUT请求用于更新资源，用法与POST类似，数据也放在Body中。

2.4 DELETE请求#

DELETE请求用于删除资源，通常参数通过URL传递。

6、请求Headers设置#

有些接口需要特定的请求头，如Content-Type、Authorization等。

步骤：

点击 Headers 标签
添加Key-Value对

常用请求头：

Header	说明	示例值
Content-Type	请求内容类型	application/json
Authorization	认证信息	Bearer xxxxx
Accept	期望的响应类型	application/json
Token	自定义令牌	xxxxx

7、环境变量管理#

环境变量可以让同一套请求在不同环境（开发、测试、生产）下快速切换。

7.1 创建环境#

7.2 使用环境变量#

在URL、Params、Headers中使用 {{变量名}} 格式：

1
{{baseUrl}}/api/user/list

注意：创建完环境变量之后，一定要ctrl s保存一下。否则，可能在使用该环境变量的时候出现无法使用的情况！

8、导出、导入功能#

导出、导入功能。可以让你很方便的将别人新建好的接口请求，导入到你自己的postman里面。

5.1 导出#

进入如下界面,点击 Export,便可以导出一份json文件。

5.2 导入#

拿到上一步导出的json文件，按照下图在对应工作区间导入即可！

9、代码生成#

Postman可以生成各种语言的调用代码，方便直接复制到项目中。

点击请求右侧的 </> 图标
选择目标语言（如 Java - OkHttp）
复制生成的代码

10、复制key-vlaue参数#

进入如下界面复制即可。

五、常见问题#

1、CORS跨域问题#

Postman作为独立工具，不受浏览器同源策略限制，不会出现CORS问题。这是Postman相比浏览器直接请求的优势。

2、SSL证书验证#

如果接口使用自签名证书，可以设置中关闭SSL验证

3、请求超时#

默认超时时间为0（无限），可以在设置中修改：

Settings → Request timeout in ms

4、中文乱码#

响应出现中文乱码时：

检查响应Headers中的Content-Type
确保包含 charset=utf-8

音乐