ASP.NET Core插件系统同名ViewComponent引发的视图冲突该如何解决

该冲突的核心原因是ASP.NET Core默认的ViewComponent查找逻辑仅匹配类名的短名称，不同插件的同名ViewComponent会出现后加载的覆盖先加载的情况；同时Razor视图查找没有按插件隔离，会优先匹配到最先扫描到的同名视图文件，导致模型类型不匹配。

你可以通过以下几种方式组合解决问题：

1. 给每个插件的ApplicationPart设置唯一标识 #

修改插件程序集加载逻辑，给每个插件的程序集配置独立的名称，避免程序集层面的命名冲突：

foreach (var ext in extensionManager.Extensions)
{
    var assemblyPart = mvcBuilder.AddApplicationPart(ext.Assembly);
    // 用插件程序集名称作为唯一标识，也可以用自定义的插件ID
    assemblyPart.WithName(ext.Assembly.GetName().Name);
    
    if (ext.ViewsAssembly != null)
    {
        var viewsPart = mvcBuilder.AddApplicationPart(ext.ViewsAssembly);
        viewsPart.WithName(ext.ViewsAssembly.GetName().Name);
    }
}

2. 为ViewComponent指定唯一的调用名称 #

在每个插件的ViewComponent类上标注[ViewComponent]特性，手动指定全局唯一的名称，避免短名称冲突：

// Plugin1中定义的ViewComponent
[ViewComponent(Name = "Plugin1_MyComponent")]
public class MyViewComponent : ViewComponent
{
    // 业务逻辑
}

// Plugin2中定义的同名ViewComponent
[ViewComponent(Name = "Plugin2_MyComponent")]
public class MyViewComponent : ViewComponent
{
    // 业务逻辑
}

调用时直接使用指定的唯一名称即可：

@* 调用Plugin1的组件 *@
@await Component.InvokeAsync("Plugin1_MyComponent")

3. 隔离插件视图查找路径 #

修改Razor视图引擎的查找规则，新增插件专属的视图路径，避免跨插件匹配同名视图：

builder.Services.Configure<RazorViewEngineOptions>(options =>
{
    // 配置插件视图的查找规则，{2}对应插件名称，{1}对应控制器名，{0}对应视图名
    options.ViewLocationFormats.Add("/Plugins/{2}/Views/{0}" + RazorViewEngine.ViewExtension);
    options.ViewLocationFormats.Add("/Plugins/{2}/Views/Shared/{0}" + RazorViewEngine.ViewExtension);
    options.AreaViewLocationFormats.Add("/Plugins/{2}/Views/{1}/{0}" + RazorViewEngine.ViewExtension);
});

4. 强制Razor视图使用完全限定类型名 #

在插件的项目文件中添加如下配置，让视图编译时自动使用模型的完全限定名称，避免同名模型的类型识别错误：

<PropertyGroup>
  <RazorCompileOnBuild>true</RazorCompileOnBuild>
  <UseFullyQualifiedTypeNames>true</UseFullyQualifiedTypeNames>
</PropertyGroup>

如果需要更彻底的隔离，可以为每个插件使用独立的AssemblyLoadContext加载程序集，完全避免不同插件之间的类型串用问题。

内容的提问来源于stack exchange，提问作者Sergеу Isupov