ASP.NET Core多项目引用属性路由歧义问题咨询

添加项目引用后，ASP.NET Core MVC默认的控制器发现逻辑会自动扫描所有引用程序集中的控制器类，将两个项目中路由模板完全相同的属性路由端点同时注册到路由表。UseRouting()中间件执行端点匹配时，同一路径匹配到多个有效端点就会抛出歧义异常，这和复用DbContext本身没有直接关系，只是项目引用触发了跨程序集的控制器自动发现。

不需要冗余复制DbContext，不需要手动给每个控制器加路由前缀，也不需要自定义中间件（路由歧义发生在端点匹配阶段，自定义中间件执行时机无法介入该逻辑），直接用框架内置的应用部件、应用模型约定能力即可解决，分两种场景选择：

场景1：仅需复用第二个项目的DbContext/服务，不需要在主应用中承载第二个项目的接口 #

这种场景最省事，直接把第二个项目的程序集从MVC控制器发现列表中移除即可，框架根本不会加载第二个项目的控制器路由，从根源消除冲突：

// 传入第二个项目中任意一个类的Type获取对应程序集，比如你要复用的DbContext
var secondProjectAssembly = typeof(SecondProjectNamespace.AppDbContext).Assembly;

builder.Services.AddControllers()
    .ConfigureApplicationPartManager(apm =>
    {
        var targetPart = apm.ApplicationParts
            .OfType<AssemblyPart>()
            .FirstOrDefault(p => p.Assembly == secondProjectAssembly);
        if (targetPart != null)
        {
            apm.ApplicationParts.Remove(targetPart);
        }
    });

长期最优实践：把DbContext、通用服务、公共模型等共享代码抽成独立的纯类库项目，不要直接引用另一个Web项目，从架构层面避免跨程序集扫描到控制器的问题，后续多项目复用代码也不会出现同类问题。

场景2：需要在同一个应用中同时承载两个项目的所有接口 #

这种场景用框架内置的IApplicationModelConvention实现自动路由前缀注入即可，不需要修改第二个项目中任何现有控制器的属性路由配置，零侵入：

1. 先实现自定义路由约定类，仅针对目标程序集的控制器自动拼接路由前缀：

public class AssemblyScopeRoutePrefixConvention : IApplicationModelConvention
{
    private readonly string _prefix;
    private readonly Assembly _targetAssembly;

    public AssemblyScopeRoutePrefixConvention(string prefix, Assembly targetAssembly)
    {
        _prefix = prefix;
        _targetAssembly = targetAssembly;
    }

    public void Apply(ApplicationModel application)
    {
        var targetControllers = application.Controllers
            .Where(c => c.ControllerType.Assembly == _targetAssembly)
            .ToList();
        
        foreach (var controller in targetControllers)
        {
            foreach (var selector in controller.Selectors)
            {
                if (selector.AttributeRouteModel == null) continue;
                // 给原有属性路由自动拼接前缀，不改动原路由特性的配置
                selector.AttributeRouteModel = AttributeRouteModel.CombineAttributeRouteModel(
                    new AttributeRouteModel(new RouteAttribute(_prefix)),
                    selector.AttributeRouteModel
                );
            }
        }
    }
}

2. 在Program.cs中注册该约定即可：

var secondProjectAssembly = typeof(SecondProjectNamespace.HomeController).Assembly;
builder.Services.AddControllers()
    // 显式添加第二个项目的应用部件，避免环境差异导致漏扫
    .AddApplicationPart(secondProjectAssembly)
    .AddMvcOptions(options =>
    {
        // 第二个项目下所有控制器路由自动添加/proj2前缀，主项目路由保持原有逻辑不变
        options.Conventions.Add(new AssemblyScopeRoutePrefixConvention("proj2", secondProjectAssembly));
    });

配置完成后，第二个项目原有的Home/Index路由会自动映射为/proj2/Home/Index，和主项目的/Home/Index完全隔离，不会出现匹配歧义。

• 复制DbContext：会产生多份数据访问逻辑，后续迭代极易出现配置不一致、逻辑不同步的问题，完全不推荐
• 手动给所有控制器加路由前缀：侵入性强，后续新增控制器容易遗漏前缀配置，维护成本高
• 自定义Middleware：无法介入UseRouting()阶段的端点匹配逻辑，解决不了根本问题

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