前言
接口调试是软件开发中的高频工作,一个项目的完成过程中,接口测试调试的时间往往比实际编码还要多。工欲善其事必先利其器,在深入使用 IntelliJ IDEA REST Client 之前,Postman 确实是一个不错的选择,具备完备的 REST 功能和请求历史记录。
但一旦习惯了 IDEA REST Client,你会发现它完全覆盖了 Postman 的功能,甚至提供了更优的开发体验。毕竟,在一个生产工具里完成开发和调试,何必频繁切换?
从 Postman 到 IDEA REST Client
IDEA REST Client 的优势主要体现在以下几个方面:
- 功能全覆盖:包含控制台、历史请求记录等核心功能。
- 开发流整合:无需离开 IDE,直接在项目中管理接口脚本。
- 环境配置支持:支持区分不同环境(如 dev、uat、pro),并可在响应中进行断言和脚本化处理。
- 团队协作友好:请求配置以文件形式描述,可随项目共享,方便成员间同步。
控制台与历史记录
通过顶部菜单 Tools -> HTTP Client -> Test RESTFUL Web Service 即可打开控制台。界面布局与主流工具类似,支持请求方式、参数及请求头的填充。
对于 Basic Auth 认证,点击对应按钮即可弹出窗口输入用户名和密码,系统会自动将其补充到 Authorization Header 中。
IntelliJ IDEA 会自动将最近执行的 50 个请求保存到项目 .idea/httpRequests/ 目录下的 http-requests-log.http 文件中。利用请求历史记录,你可以快速导航到特定响应并重新发送。再次执行后,执行信息和响应输出链接会追加到文件顶部,便于追溯。
构建 HTTP 请求脚本
历史记录本质上就是一个完整的请求脚本。如果你从控制台触发过请求,可以直接复制该文件放到项目中作为标准脚本供其他成员使用。当然,你也可以新建后缀为 .http 或 .rest 的文件,IDEA 会自动识别为 HTTP 请求脚本。
语法规范
每个请求体之间用三个井号 ### 分隔。请求 URL 和 Header 参数需紧跟其后,而请求参数无论是 POST Body 还是 GET Query,都需要换行书写。
### 演示 POST 请求
POST {{baseUrl}}/get?show_env=1
Accept: application/json
{
"name": "a"
}
### 演示 GET 请求
GET {{baseUrl}}/post
Content-Type: application/x-www-form-urlencoded
id=999&value=content
环境区分
示例代码中使用了 {{baseUrl}} 占位符而非真实地址,这正是 IDEA REST Client 的亮点之一。它支持从配置文件中读取环境变量,不仅 baseUrl,任何与环境相关的参数都可以通过配置文件区分。
在 .http 脚本同目录下创建 http-client.private.env.json 文件,定义不同环境的变量:
{
"uat": {
"baseUrl": "http://gateway.xxx.cn/",
"username": ""


