IDEA REST Client 接口调试与协作实战指南

前言

接口调试是软件开发中的高频工作，一个项目的完成过程中，接口测试调试的时间往往比实际编码还要多。工欲善其事必先利其器，在深入使用 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"