托管式Blazor WebAssembly程序集冲突问题求助

问题场景 #

基于托管式Blazor WebAssembly模板搭建的项目结构如下：

• 客户端部分：BlazorApp、ClientModel
• 服务端部分：ServerCoreApp、ServerModel
• 共享项目（无法独立编译）：SharedProject，其中的ClassA以链接项形式分别添加到ClientModel和ServerModel，通过条件编译符号AspCore区分两端行为：

#if AspCore
    Console.WriteLine("Server Project");
#else
    Console.WriteLine("Client Project");
#endif

调试阶段无异常，但发布解决方案后，服务端Razor页面出现类型冲突错误：

The type 'ClassA' exists in both 'ClientModel,Version=1.0.0.0, Culture=neutral, PublicKeyToken=null' and 'ServerModel, Version=1.0.0.2, Culture=neutral,PublicKeyToken=null'
且无法通过在Razor页面定义extern alias解决该冲突。

解决方案 #

方案1：清理服务端项目引用，避免加载客户端模型

• 服务端项目（ServerCoreApp）仅保留对ServerModel的引用，移除所有对ClientModel的直接或间接引用。若Blazor托管模板默认添加了ClientModel的引用，手动在ServerCoreApp的项目文件中删除对应的<ProjectReference>节点。
• 确保服务端Razor页面仅调用ServerModel中的ClassA，编译时只会加载服务端版本的类型，从根源避免冲突。

方案2：为两端类型设置不同命名空间

• 修改SharedProject中ClassA的命名空间，通过条件编译符号区分两端：

#if AspCore
namespace ServerModel.Models;
#else
namespace ClientModel.Models;
#endif

public class ClassA
{
    // 类逻辑实现
}

修改后，ClientModel和ServerModel中的ClassA将处于不同命名空间。服务端Razor页面通过明确指定using ServerModel.Models;来使用服务端版本的类型，彻底消除类型重名冲突。

方案3：重构共享项目为可编译类库

放弃链接项的方式，将SharedProject改为可编译的类库项目，通过项目配置控制两端逻辑：

1. 将SharedProject转换为适配两端的类库（如.NET Standard类库）。
2. 在SharedProject的项目文件中添加条件编译符号配置：

<PropertyGroup>
    <!-- 服务端目标框架下添加AspCore编译符号 -->
    <DefineConstants Condition="'$(TargetFramework)' == 'net6.0'">AspCore;$(DefineConstants)</DefineConstants>
</PropertyGroup>

3. 让ClientModel和ServerModel直接引用SharedProject，而非添加链接项。两端会各自编译出符合自身逻辑的ClassA，服务端仅加载ServerModel引用的版本，不会出现冲突。

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