使用VS Endpoint Explorer生成的.http文件请求ASP.NET Core API报错

常见原因及修复步骤 #

• 检查.http文件请求格式正确性
  确保Post请求的头部和体部格式符合规范：

  • 必须添加Content-Type头（比如接口接收JSON则设为application/json）。
  • 请求头与请求体之间必须空一行。
  • 请求体的JSON/表单数据结构完整（引号、括号匹配，无语法错误）。
    示例正确格式：

  POST https://localhost:5001/api/users
  Content-Type: application/json
  
  {
    "name": "test",
    "email": "test@example.com"
  }
  

• 确认请求地址与项目运行端口一致
  查看VS输出窗口中项目启动后的监听地址（如Now listening on: https://localhost:5001），确保.http文件里的请求地址端口和实际运行端口完全匹配。若使用环境变量，检查launchSettings.json中的端口配置是否正确映射。

• 处理HTTPS证书验证问题
  若项目启用HTTPS，VS的HTTP工具可能因证书未信任报错：

  • 可在.http文件开头添加@no-verify指令跳过证书验证：

    @no-verify
    POST https://localhost:5001/api/users
    ...
    

  • 或在VS的「工具」->「选项」->「环境」->「预览功能」中开启「使用现代HTTP客户端」（若该选项存在）。

• 清理VS缓存并重启
  关闭Visual Studio，删除项目根目录下的隐藏.vs文件夹，重启VS后重新生成项目，再测试.http请求，排除缓存导致的异常。

• 检查项目CORS配置（可选）
  尽管Postman能正常访问，但少数情况下VS的HTTP工具会触发CORS限制。确认项目中已正确配置CORS策略：

  builder.Services.AddCors(options =>
  {
      options.AddPolicy("AllowLocal", policy =>
      {
          policy.WithOrigins("https://localhost:5001")
                .AllowAnyMethod()
                .AllowAnyHeader();
      });
  });
  
  app.UseCors("AllowLocal");
  

内容的提问来源于stack exchange，提问作者Tikhon