怎么在 IDEA 中配置 HTTP Client 测试 RESTful 接口？

IDEA 内置的 HTTP Client 插件无需安装额外工具即可进行 RESTful 接口测试，支持图形界面和脚本文件两种模式，适合本地开发过程中快速验证接口连通性与参数。

先说结论：IDEA 内置的 HTTP Client 足够应对日常接口调试，无需额外安装 Postman 等外部工具。

适合：本地开发过程中快速验证接口连通性与参数。
先看：确认插件已启用，选择图形窗口或.http 文件模式。
建议：使用.http 文件保存测试用例，便于版本管理和切换环境。

基础请求编写

最推荐的方式是创建后缀为 .http 或 .rest 的文件，直接在项目中管理请求脚本。在文件行号左侧点击绿色三角形图标即可发送请求。

GET http://localhost:8080/api/test?name=Tom
Accept: application/json

###
POST http://localhost:8080/api/login
Content-Type: application/json

{
  "username": "admin",
  "password": "123456"
}

环境变量与多环境切换

若需区分开发、生产环境，可创建 http-client.env.json 文件定义变量，在请求中使用 {{variable}} 引用。文件需位于项目根目录或请求文件同级目录。

{
  "dev": {
    "host": "http://localhost:8080",
    "token": "dev-token-123"
  },
  "prod": {
    "host": "https://api.example.com",
    "token": "prod-token-456"
  }
}

配置完成后，在请求文件右上角的下拉菜单中选择环境（如 dev 或 prod），变量会自动替换。注意变量名区分大小写。

认证配置示例

对于需要认证的接口，可以直接在请求头中配置 Authorization。以下是 Bearer Token 的配置示例：

GET {{host}}/api/user/profile
Authorization: Bearer {{token}}
Accept: application/json

也可以配合环境变量使用，避免将敏感 token 硬编码在请求文件中。

响应查看与验证

请求发送后，IDEA 右侧会弹出 Response 工具窗口展示响应结果。检查响应状态码是否为 200，响应体内容是否符合预期 JSON 结构。

注意：响应结果仅在工具窗口展示，支持查看历史请求记录，不会直接修改或追加到 .http 源文件中，因此无需担心版本控制混乱。

常见问题排查

文件后缀错误：文件必须以 .http 或 .rest 结尾，否则无法被识别为请求文件。
请求头缺失：POST JSON 数据时忘记设置 Content-Type: application/json，导致后端无法解析。
编码问题：若响应出现乱码，需检查 IDEA 的编码设置，确保项目编码与响应编码一致（通常为 UTF-8）。
插件未启用：部分精简版 IDEA 或旧版本可能需手动在插件市场安装 HTTP Client 插件。