ASP.NET Core MVC：未遵循命名约定或无[Controller]的控制器为何被识别？

问题场景 #

在ASP.NET Core MVC中，控制器通常通过**命名约定（类名以Controller结尾）**或使用[Controller]特性来自动识别，示例代码如下：

[Controller]
public class HomeController : Controller
{
    // Action methods
}

但在ASP.NET Core 8环境下，移除命名约定和[Controller]特性后，如下代码仍能被app.MapControllers()识别为控制器并处理路由请求：

Program.cs代码 #

var builder = WebApplication.CreateBuilder(args);

// Add service class (reusable classes)

// 注册所有以"Controller"结尾的类作为MVC控制器
builder.Services.AddControllers(); 

var app = builder.Build();

// 检测所有控制器，将其动作方法映射到路由，并为每个动作方法设置路由
app.MapControllers(); 

app.Run();

Home类代码 #

using Microsoft.AspNetCore.Mvc;

namespace ControllersExample.Controllers
{
    public class Home : Controller
    {
        // 属性路由
        [Route("/home")] 
        [Route("/")]
        public string Index()
        {
            return " Hello from index";
        }

        // 属性路由
        [Route("/about")]
        public string About()
        {
            return " Hello from about";
        }

        // 属性路由
        [Route("/contact/{mobile:regex(^\\d{{10}}$)}")]
        public string Contact()
        {
            return " Hello from contact";
        }
    }
}

技术问题 #

1. 为何Home类未遵循默认命名约定且无[Controller]特性，仍能被识别为控制器？
2. ASP.NET Core MVC中是否存在默认或隐式约定可解释此行为？

解答 #

问题1的原因 #

在ASP.NET Core 8中，调用AddControllers()时，框架的控制器发现逻辑会将继承自Controller（或ControllerBase）的公共非抽象类判定为控制器类型。你的Home类直接继承了Controller基类，满足核心判定条件，因此即使没有命名约定后缀或[Controller]特性，依然会被识别为控制器。

问题2：默认隐式约定 #

ASP.NET Core MVC的控制器发现逻辑存在以下默认隐式规则（适用于ASP.NET Core 8）：

• 类必须是公共、非抽象的非泛型类型
• 类必须继承自Controller/ControllerBase基类，或实现IController接口（继承基类是常规使用方式）
• 类名称以Controller结尾，或者满足上述继承条件（即使名称不符合后缀约定）

你的Home类完全符合“公共非抽象、继承自Controller”的规则，因此被自动纳入控制器范畴。这种逻辑是ASP.NET Core后期版本的默认行为，相较于早期版本，继承基类已经成为控制器识别的核心判定依据之一。

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