WebStorm HTTP Client无法运行，主因是文件路径、后缀、格式或变量配置错误：必须用.http/.rest后缀、置于项目目录内、首行顶格合法请求、紧接空行、Content-Type与JSON严格规范、变量定义位置正确、OAuth2需http-client.env.json配置。
WebStorm内置HTTP Client跑不起来，八成是文件没放对地方
WebStorm的.http或.rest文件不是“写完就能发”，它靠后缀+路径双重识别。不满足条件，连语法高亮都没有，更别说绿色运行按钮。
- 后缀只能是
.http或.rest——右键 → New → HTTP Request 新建，别用普通文本改后缀，IDE 可能根本没注册该类型 - 文件必须放在 WebStorm 当前打开的项目目录内（含子目录），不能丢在桌面、Downloads 或任意外部路径
- 首行必须顶格写合法请求行：
GET https://httpbin.org/get✅；get https://...❌（小写方法）、GET https://... #comment❌（后面带内容） - 请求行后必须紧接一个**空行**（不能缩进、不能多空行），否则静默失败或返回
400
Content-Type 和 JSON body 格式错一个字符就 400
HTTP Client 解析极严格，不报错、不提示，只返回错误状态码。问题几乎全出在格式上，跟后端无关。
-
Content-Type: application/json必须单独成行，前后无空格，大小写敏感 - JSON body 必须顶格、UTF-8 无 BOM、所有字符串用双引号：
{"id":123}✅；{id:123}❌（单引号或省略引号） - 中文或特殊字符 URL 必须手动 URL 编码：
GET https://api.com/%E7%94%A8%E6%88%B7✅；GET https://api.com/用户❌
@base_url 和 {{base_url}} 不生效？变量作用域不是全局的
Cannot resolve variable 几乎从不是拼写错误，而是变量定义位置错了。变量只在定义它的块及之后生效，且作用域由分隔符控制。
- 全局变量写在文件最顶部，独立一行：
@base_url = https://api.dev.example.com - 环境变量需用
### @env dev这类块分隔：### @env dev\n@token = abc123，只对该块及后续请求生效 - 变量名只允许字母、数字、下划线：
@auth_token✅；@auth-token❌；@auth.token❌ - 引用时必须严格匹配：
{{base_url}}✅；{{base_url}}}❌；{{base.url}}❌
OAuth2 调用失败，大概率缺了 http-client.env.json 配置文件
HTTP Client 的 OAuth2 支持不支持在 .http 文件里填 client_id 就完事，它依赖外部 JSON 配置文件驱动。
- 必须在项目根目录放
http-client.env.json，结构扁平，不能嵌套过深 - 示例内容：
{"dev": {"Security": {"Auth": {"my-api": {"Type": "OAuth2", "Grant Type": "Authorization Code", "Client ID": "xxx"}}}}} - 请求中调用写法必须带双美元：
Authorization: Bearer {{$auth.token("my-api")}}—— 少一对$或括号，就是Unresolved variable - 首次运行会弹非模态浏览器窗口，可切回 IDE 操作，但别关掉它，否则 token 获取中断，后续全
401
实际对接 API 时最易忽略的是：变量定义位置和 http-client.env.json 的存在性。这两点不出错，其余格式问题基本都能靠反复检查空行、引号、大小写和编码快速定位。
