如何在带[ApiController]的控制器中动态添加路由与HTTP方法？

你希望通过自定义代码自动生成默认路由、默认POST方法，无需硬编码[HttpPost]/[Route]等属性，但添加[ApiController]时会触发路由验证错误——原因是ApiController要求Action必须使用属性路由，而默认IActionModelConvention的执行时机晚于ApiBehavior的验证逻辑。以下是可行的解决方案：

核心思路：提前在模型构建阶段添加路由与方法约束 #

通过实现IApplicationModelProvider并设置更高的执行优先级（早于ApiBehavior的验证），在ApiController的路由检查之前，为每个Action动态添加属性路由和HTTP方法约束。

步骤1：实现自定义IApplicationModelProvider #

using Microsoft.AspNetCore.Mvc.ApplicationModels;
using Microsoft.AspNetCore.Mvc.Routing;
using System.Linq;

public class DefaultRouteAndMethodProvider : IApplicationModelProvider
{
    // 设置优先级为-1001，比ApiBehaviorApplicationModelProvider的-1000更早执行
    public int Order => -1001;

    public void OnProvidersExecuted(ApplicationModelProviderContext context) { }

    public void OnProvidersExecuting(ApplicationModelProviderContext context)
    {
        foreach (var controller in context.Result.Controllers)
        {
            // 为控制器添加基础路由前缀：api/[控制器名]
            var controllerRoute = new AttributeRouteModel(new RouteAttribute($"api/{controller.ControllerName}"));

            foreach (var action in controller.Actions)
            {
                // 为Action添加路由模板：[Action名]
                var actionRoute = new AttributeRouteModel(new RouteAttribute(action.ActionName));
                // 合并控制器与Action的路由，形成完整属性路由
                var combinedRoute = AttributeRouteModel.CombineAttributeRouteModel(controllerRoute, actionRoute);

                // 给Action添加Selector（包含路由和方法约束）
                var selector = new SelectorModel { AttributeRouteModel = combinedRoute };
                
                // 如果Action没有显式指定HTTP方法，默认添加POST约束
                if (!action.Selectors.Any(s => s.ActionConstraints.OfType<HttpMethodActionConstraint>().Any()))
                {
                    selector.ActionConstraints.Add(new HttpMethodActionConstraint(new[] { "POST" }));
                }

                action.Selectors.Add(selector);
            }
        }
    }
}

步骤2：注册自定义Provider #

在Program.cs中注册这个Provider到MVC选项：

var builder = WebApplication.CreateBuilder(args);

// 添加控制器并注册自定义Provider
builder.Services.AddControllers(options =>
{
    options.ModelMetadataDetailsProviders.Add(new DefaultRouteAndMethodProvider());
});

// 注册Swagger（用于OpenAPI文档生成）
builder.Services.AddEndpointsApiExplorer();
builder.Services.AddSwaggerGen();

var app = builder.Build();

// 启用Swagger中间件
if (app.Environment.IsDevelopment())
{
    app.UseSwagger();
    app.UseSwaggerUI();
}

app.UseHttpsRedirection();
app.UseAuthorization();
app.MapControllers();

app.Run();

验证效果 #

现在控制器只需添加[ApiController]，无需任何路由或HTTP方法属性：

[ApiController]
public class UserController : ControllerBase
{
    // 自动生成路由：api/User/Create，默认POST方法
    public IActionResult Create(UserDto model)
    {
        // 业务逻辑
        return Ok();
    }

    // 如果需要指定其他方法，直接添加属性即可，会覆盖默认值
    [HttpGet]
    public IActionResult GetById(int id)
    {
        // 业务逻辑
        return Ok(new UserDto());
    }
}

关键说明 #

1. 优先级设置：Order = -1001确保自定义Provider在ApiBehaviorApplicationModelProvider（Order=-1000）之前执行，路由和方法约束会在ApiController的验证逻辑运行前被添加，避免触发"无属性路由"的错误。
2. 属性路由要求：ApiController强制要求使用属性路由，因此我们通过AttributeRouteModel构建路由，而非传统全局路由表。
3. OpenAPI兼容性：Swashbuckle.AspNetCore会自动读取ApplicationModel中的路由和方法约束信息，生成正确的OpenAPI文档，完全满足JS SPA客户端自动生成代码的需求。
4. 灵活性：如果需要为某些Action指定不同的HTTP方法，直接添加[HttpGet]/[HttpPut]等属性即可，自定义Provider会跳过已显式设置方法的Action。

替代方案：调整IActionModelConvention的执行顺序 #

如果更倾向于使用IActionModelConvention，可以通过实现IOrderedFilter设置优先级，但IApplicationModelProvider的控制更直接，不易受版本变更影响。

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