ASP.NET Core带参数的HttpDelete路由返回404，参数配置问题排查

看起来你遇到的问题核心是路由匹配与HTTP请求方法的不匹配，或者是路由绑定的细微问题，下面我会一步步拆解：

最可能的原因：HTTP请求方法错误 #

当你配置了[HttpDelete("{dateRangeId}")]，这个方法只会响应DELETE类型的请求。如果你的测试方式是直接在浏览器地址栏输入/api/candidate/free/123，浏览器默认发送的是GET请求，服务器找不到对应的GET端点，自然返回404。

而当你改成无参的[HttpDelete]方法后，如果你是用正确的DELETE请求访问/api/candidate/free/，自然能匹配到对应的方法；但如果你还是用GET请求访问这个路径，理论上也应该返回404——这说明你测试无参接口时可能用对了请求方法，但测试带参接口时用了错误的方法（比如GET）。

其他可能的原因与排查步骤 #

如果确认请求方法是DELETE，那可以检查以下几点：

• 路由参数名称匹配问题：确保路由模板里的{dateRangeId}和方法参数int dateRangeId的名称完全一致（虽然ASP.NET Core路由参数名称不区分大小写，但保持一致能避免潜在问题）。
• 路由冲突：检查项目中是否有其他控制器/方法的路由与api/candidate/free/{dateRangeId}重叠。比如另一个控制器有[Route("api/candidate/free/{id}")]的GET方法，且路由优先级更高，会导致DELETE请求被错误匹配，最终返回404。
• 启用路由调试验证：可以添加一段代码查看所有注册的路由，确认你的DELETE方法的路由是否正确注册：

  // .NET 6+ 在 Program.cs 中添加
  app.MapGet("/debug/routes", (IActionDescriptorCollectionProvider provider) =>
  {
      var routes = provider.ActionDescriptors.Items
          .Select(descriptor => new
          {
              Template = descriptor.AttributeRouteInfo?.Template,
              Methods = descriptor.ActionConstraints?
                  .OfType<HttpMethodActionConstraint>()
                  .FirstOrDefault()?
                  .HttpMethods
          });
      return Results.Json(routes);
  });
  

  访问/debug/routes后，检查是否存在Template: "api/candidate/free/{dateRangeId}"且Methods包含DELETE的条目。

解决建议 #

1. 确保使用DELETE请求：用Postman、curl等工具发送DELETE请求到/api/candidate/free/123，而不是浏览器地址栏的GET请求。
2. 验证路由注册：通过上述调试代码确认路由是否正确注册。
3. 检查路由冲突：排查项目中是否有其他路由与目标路由重叠，调整路由模板或优先级。

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