ASP.NET MVC项目中Web API接口方法无法正常执行如何解决？

• 检查Web API路由配置
  Web API的属性路由需要显式启用，打开App_Start/WebApiConfig.cs文件，确认存在以下配置：

  public static class WebApiConfig
  {
      public static void Register(HttpConfiguration config)
      {
          // 启用属性路由，缺少该行会导致Route特性不生效
          config.MapHttpAttributeRoutes();
  
          // 默认Web API路由配置
          config.Routes.MapHttpRoute(
              name: "DefaultApi",
              routeTemplate: "api/{controller}/{id}",
              defaults: new { id = RouteParameter.Optional }
          );
      }
  }
  

  同时确认Global.asax.cs的Application_Start方法中，Web API配置注册顺序在MVC路由之前：

  protected void Application_Start()
  {
      // 先注册Web API配置
      GlobalConfiguration.Configure(WebApiConfig.Register);
      // 再注册MVC路由
      RouteConfig.RegisterRoutes(RouteTable.Routes);
      // 其他全局配置
  }
  

• 排查路由冲突问题
  Web API路由和MVC路由容易出现匹配冲突，建议给Web API接口统一添加api前缀避免冲突，修改控制器代码如下：

  // 统一添加路由前缀
  [RoutePrefix("api/Default")]
  public class DefaultController : ApiController
  {
      [HttpGet]
      [Route("test")]
      public string test()
      {
          return "1";
      }
  }
  

  修改后接口访问地址改为https://localhost:44308/api/Default/test。
• 直接访问接口排查基础连通性
  先跳过Ajax调用，直接在浏览器地址栏输入接口地址测试访问：
  1. 原有逻辑测试地址：https://localhost:44308/Default/test
  2. 加前缀后测试地址：https://localhost:44308/api/Default/test
     如果浏览器直接访问仍报错，右键项目→「属性」→「Web」，检查服务器配置下的项目URL端口是否确实为44308。
• 确认控制器继承关系正确
  检查DefaultController继承的是System.Web.Http.ApiController，而非MVC体系下的System.Web.Mvc.Controller，两者路由体系完全独立，继承错误会导致路由无法匹配。
• 简化Ajax请求测试
  去掉非必要配置项，添加错误回调打印异常信息，修改代码如下：

  $.ajax({
      type: 'GET',
      // 用相对路径避免域名/端口拼写错误
      url: '/api/Default/test',
      success: function (returnedData) {
          console.log('返回结果：', returnedData)
      },
      error: function (xhr, err) {
          // 打印状态码和错误信息方便定位问题
          console.log('请求错误：', xhr.status, xhr.statusText)
      }
  });
  

• 跨域配置检查
  如果前端页面和Web API部署在不同端口/域名下，需要在Web API项目配置CORS：
  1. 安装NuGet包：Microsoft.AspNet.WebApi.Cors
  2. 在WebApiConfig.cs的Register方法中添加配置：

  // 生产环境请替换通配符为实际允许的域名
  config.EnableCors(new EnableCorsAttribute("*", "*", "*"));
  

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