ASP.NET Core 8中能否将ODataController置于子目录？重名控制器报错

问题本质 #

你遇到的核心问题是同名控制器的路由冲突：ASP.NET Core默认按控制器名称（去掉Controller后缀）匹配路由，Controllers/ProjectsController和Controllers/OData/ProjectsController会被路由系统视为同一控制器，导致请求匹配混乱，进而触发看似授权相关的错误（实际是路由匹配错误引发的连锁问题）。

可行解决方案 #

方案1：显式绑定OData控制器的路由前缀 #

无需修改控制器名称，通过属性配置明确区分OData控制器的路由：

1. 修改Program.cs中的OData模型配置，将实体集名称改为Projects：

var modelBuilder = new ODataConventionModelBuilder();
modelBuilder.EntitySet<ProjectDto>("Projects");

builder.Services.AddControllers().AddOData(
    options => options.Select().Filter().OrderBy().Expand().Count().SetMaxTop(null)
        .AddRouteComponents("odata", modelBuilder.GetEdmModel())
);

2. 在OData子目录的ProjectsController上添加路由属性，明确绑定到OData路由组件：

[Route("odata/[controller]")]
[ODataRouteComponent("odata")]
public class ProjectsController : ODataController
{
    private readonly MyDbContext _db;
    private readonly IMapper _mapper;

    public ProjectsController(MyDbContext db, IMapper mapper)
    {
        _db = db;
        _mapper = mapper;
    }

    [HttpGet]
    [EnableQuery] // 推荐用OData原生属性自动处理查询参数，替代手动解析ODataQueryOptions
    public async Task<ActionResult<IEnumerable<ProjectDto>>> Get()
    {
        var projects = await _db.ProjectEntities
            .ProjectTo<ProjectDto>(_mapper.ConfigurationProvider)
            .ToListAsync();
        return Ok(projects);
    }
}

方案2：通过命名空间区分路由 #

利用ASP.NET Core的命名空间路由约定，让路由系统识别两个同名控制器的差异：

1. 在Program.cs中添加自定义控制器约定，为不同命名空间的控制器标记路由区分标识：

builder.Services.AddControllers(options =>
{
    options.Conventions.Add(new NamespaceRouteConvention());
})
.AddOData(options => options.Select().Filter().OrderBy().Expand().Count().SetMaxTop(null)
    .AddRouteComponents("odata", modelBuilder.GetEdmModel()));

// 自定义约定：按命名空间区分控制器
public class NamespaceRouteConvention : IControllerModelConvention
{
    public void Apply(ControllerModel controller)
    {
        if (controller.ControllerType.Namespace == "Backend.Api.Controllers")
        {
            controller.RouteValues["namespace"] = "default";
        }
        else if (controller.ControllerType.Namespace == "Backend.Api.Controllers.OData")
        {
            controller.RouteValues["namespace"] = "odata";
        }
    }
}

2. 为两个控制器分别配置路由：

• 常规Controllers/ProjectsController.cs：

[Route("[controller]")]
[ApiController]
public class ProjectsController : ControllerBase
{
    // 常规API业务逻辑
}

• ODataControllers/OData/ProjectsController.cs：

[Route("odata/[controller]")]
[ODataRouteComponent("odata")]
public class ProjectsController : ODataController
{
    // OData业务逻辑
}

错误原因说明 #

直接使用同名控制器时，路由系统无法区分两个控制器，会随机匹配其中一个。你看到的授权错误是因为匹配到的控制器带有授权属性，但当前请求未经过对应的授权中间件（或反之），本质是路由冲突导致的异常，并非真的缺少授权中间件。

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