如何通过PhpStorm的REST Client模块进行接口测试，查看HTTP请求与响应？

本文共计972个文字，预计阅读时间需要4分钟。

《PhpStorm 内置 HTTP Client 可直接发送请求、查看响应，但若不按它认可的格式编写，连发送按钮都按不亮——并非功能坏了，是文件没被识别。》

怎么写 .http 文件才能被 PhpStorm 正确识别

它只认 .http 或 .rest 后缀的纯文本文件，且必须放在项目目录内（桌面或临时文件夹里无效）。首行必须是大写方法 + 空格 + 完整 URL，比如 GET https://httpbin.org/get，不能写成 get 或 Get，也不能在 URL 后加空格或注释。

• 请求头要顶格写，Content-Type: application/json 前后不能有缩进或空格
• Header 和 Body 之间必须有一行**空行**，否则 Body 被当成 Header 处理
• JSON Body 必须合法：{ "key": "value" } 可以，{ key: "value" }（缺引号）会报 Unexpected token
• 别把 .php 文件重命名为 .http —— 内容结构不匹配，PhpStorm 直接静默忽略

POST 请求发不出去？先检查这三处

90% 的 “点了没反应” 或返回 400 Bad Request 都卡在这儿：Body 格式、编码、Header 不匹配。它不会自动补 Content-Length，也不会根据 Body 类型推断 Content-Type。

• 发 JSON：必须显式加 Content-Type: application/json 头，Body 顶格写，无空行
• 发表单（application/x-www-form-urlencoded）：Header 设对，Body 写成 username=%E5%BC%A0%E4%B8%89&password=123，值要 URL 编码
• URL 中含中文或特殊字符（如空格、/、?）：必须手动 UTF-8 编码，https://api.com/用户 得写成 https://api.com/%E7%94%A8%E6%88%B7

怎么带 Token、Cookie 和环境变量

不传鉴权信息，401 或跳登录页是常态。HTTP Client 不读浏览器 Cookie，Token 也不自动注入，全得自己填。

立即学习“PHP免费学习笔记（深入）”；

• Bearer Token：Authorization: Bearer {{token}}，注意 Bearer 后有空格；变量 @token = xxx 要定义在文件顶部 ### 块里
• Cookie：Cookie: "sessionid=abc123; path=/;"，值含等号或分号时建议用双引号包住，避免截断
• 环境变量：在项目根建 env.json，内容如 {"dev": {"api_base_url": "http://localhost:8000"}}；引用写成 {{api_base_url}}/users，变量名禁用点号和短横线（api.base_url 会解析失败）

响应太大卡死或中文乱码怎么办

默认会把整个响应体加载进内存并尝试渲染，二进制流（如 Excel）、超长日志、未声明编码的中文响应都容易出问题。

• 大响应：加 Accept: text/plain 头，或在请求末尾加 ### 分隔，再写一个新请求做对比
• 中文显示为 你好：服务端返回的是 UTF-8，但响应头没设 Content-Type: text/plain; charset=utf-8，可手动加该头再试
• 二进制内容（如 PDF、ZIP）：HTTP Client 不支持预览，只能右键 → Save Response As... 保存后用外部工具打开

最容易被忽略的是 URL 末尾的不可见字符（比如全角空格）、变量未定义就引用、以及 POST 时漏掉空行分隔 header 和 body —— 这些地方一错，请求根本不会发出，而不是发出去再失败。