.NET Core控制器路由属性与默认路由配置导致404问题求助

碰到这种属性路由和传统默认路由冲突导致的404问题太常见了，我帮你一步步排查解决：

1. 先搞清楚属性路由的优先级 #

ASP.NET（包括Core）里，属性路由的优先级远高于你配置的默认传统路由。也就是说，当你给AdminController加上[Route("api/v1/Admin/Keys")]后，这个控制器的所有方法都会走属性路由规则，你原来配置的routes.MapRoute默认路由对它完全失效了——这是你踩的第一个坑！

2. 检查控制器方法的路由配置 #

属性路由需要控制器和方法的路由属性配合使用，光给控制器加[Route]还不够，方法上必须要有对应的HTTP动词属性（比如[HttpGet]、[HttpPost]）或者具体路由片段：

[Route("api/v1/Admin/Keys")]
public class AdminController : Controller 
{
    // 情况1：方法用[HttpGet]，对应控制器路由的根路径
    // 访问地址：http://localhost:60907/api/v1/Admin/Keys
    [HttpGet]
    public IActionResult GetAllKeys()
    {
        return Ok("所有密钥数据");
    }

    // 情况2：方法指定具体路由片段，拼接在控制器路由后面
    // 访问地址：http://localhost:60907/api/v1/Admin/Keys/GetAllKeys
    [HttpGet("GetAllKeys")]
    public IActionResult GetAllKeys()
    {
        return Ok("所有密钥数据");
    }
}

如果方法上没加这些属性，属性路由的控制器根本不知道该怎么匹配你的请求，自然返回404。

3. 验证访问地址是否正确 #

你现在访问http://localhost:60907/肯定不对，得对应属性路由的规则：

• 如果是情况1，访问 http://localhost:60907/api/v1/Admin/Keys
• 如果是情况2，访问 http://localhost:60907/api/v1/Admin/Keys/GetAllKeys

要是你想回到默认路由的逻辑（比如直接访问根路径命中GetAllKeys），那直接去掉控制器上的[Route("api/v1/Admin/Keys")]属性，这样默认路由就会生效，访问http://localhost:60907/或者http://localhost:60907/Admin/GetAllKeys都能命中方法。

4. 检查中间件配置（针对ASP.NET Core） #

如果是ASP.NET Core 3.0及以上版本，建议用MapControllers()替代传统的UseMvc配置，它对属性路由的支持更友好：

// 替代原来的app.UseMvc(...)
app.MapControllers();

同时确保这个中间件的顺序正确，要放在UseStaticFiles()之后，不要被其他拦截请求的中间件（比如认证授权）挡住。

5. 开启路由调试（终极排查手段） #

如果还是找不到问题，就开启路由调试日志，看看请求到底在匹配哪些路由：
在Program.cs（.NET 6+）里添加日志配置：

builder.Logging.AddDebug();
builder.Logging.SetMinimumLevel(LogLevel.Debug);

运行程序后，查看控制台的调试日志，里面会详细列出每个请求尝试匹配的所有路由规则，你就能一眼看出为什么没命中你的控制器方法了。

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