请求无法命中ComplaintController内自定义的/api/Complaints/Create端点

问题根因汇总 #

1. 路由前缀重复：如果ComplaintController类上已经声明了[Route("api/[controller]")]类级别的路由特性，方法上再写[Route("api/Complaints/Create")]会自动拼接成/api/Complaints/api/Complaints/Create，和你实际请求的地址不匹配，这是这类问题最常见的诱因。
2. 请求方法不匹配：接口标记了[HttpGet]，如果Postman发起的是POST、PUT等其他类型的请求，会直接返回404或405错误。
3. 控制器未被系统识别：ComplaintController没有继承ControllerBase/Controller，或者类名没有以Controller为后缀，ASP.NET Core不会把它识别为控制器，接口自然不会被注册到路由表。
4. 路由配置冲突：项目全局配置了路由约束、重写规则，或者其他接口的路由模板和当前接口重复，导致路由匹配优先级错误。
5. 中间件拦截：授权、限流、路由重写类的中间件在请求到达控制器之前就拦截了请求，直接返回错误。

排查解决步骤 #

• 先检查控制器类的路由配置：如果ComplaintController上已经加了类级别的[Route("api/[controller]")]特性，直接把方法上的路由改成[Route("Create")]即可，无需重复写前缀。
• 核对Postman请求参数：确认请求方法选择的是GET，请求地址拼写和路由模板完全一致，没有多余的路径后缀、拼写错误。
• 开启路由调试日志：在appsettings.json中将日志级别配置调整如下，发起请求后查看控制台的路由匹配日志，可直接定位匹配失败的具体原因：

  "Logging": {
    "LogLevel": {
      "Microsoft.AspNetCore.Routing": "Debug"
    }
  }
  

• 检查Program.cs/Startup.cs配置：确认已经添加了app.MapControllers()的配置，没有全局路由规则和当前接口路由冲突。
• 简化测试验证：临时将当前接口的路由改成[Route("test_debug")]，直接请求/test_debug看是否能命中，逐步缩小问题范围。

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