带[HttpPost]特性的Web API无法通过浏览器调用问题求助

问题原因 #

• 浏览器地址栏直接输入URL发起的是GET请求，而你的方法标记了[HttpPost]特性，这意味着该接口仅接受POST请求，路由系统无法匹配到对应的处理方法，因此返回“Resource not found”错误。
• Postman可以手动指定请求方法为POST，因此能正常匹配到你的接口；移除[HttpPost]后，ASP.NET Web API会默认允许GET请求（当参数为简单类型且通过URL传递时），所以浏览器的GET请求就能成功调用。

解决办法 #

场景1：需要接口仅接受POST请求 #

• 禁止用浏览器地址栏直接调用，改用以下方式：
  • 通过前端表单提交POST请求：

    <form action="https://localhost:44313/SAPAPI/Happay" method="post">
      <input type="text" name="fileName" value="Payload1">
      <button type="submit">提交</button>
    </form>
    

  • 用AJAX/fetch发送POST请求：

    fetch('https://localhost:44313/SAPAPI/Happay', {
      method: 'POST',
      headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
      body: new URLSearchParams({ fileName: 'Payload1' })
    })
    .then(res => res.text())
    .then(result => console.log(result));
    

场景2：允许接口接受GET和POST请求 #

• 显式为方法添加[HttpGet]和[HttpPost]特性，让接口同时支持两种请求方式：

  [HttpGet]
  [HttpPost]
  public string Happay(string fileName) 
  {
      // some code
  }
  

• 或者仅保留[HttpGet]（如果不需要POST支持），但显式标记比依赖默认规则更清晰。

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