.NET 8项目SqlDbType类型重复定义编译错误解决求助

我有一个.NET 8版本的ASP.NET Core Web应用，仅包含以下依赖项：

<PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="8.0.1" />

尝试添加Exceptional类库：

<PackageReference Include="StackExchange.Exceptional.AspNetCore" Version="2.2.32" />

现有代码中引用了System.Data.SqlDbType，添加后出现编译错误：

The type 'SqlDbType' exists in both 'System.Data.Common, Version=8.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a' and 'System.Data.SqlClient, Version=4.1.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a'

解决方法 #

1. 完全限定类型名 #

在使用SqlDbType的代码处，直接指定完整命名空间，明确指定要使用的类型来源：

// 明确使用System.Data.Common中的SqlDbType
System.Data.SqlDbType paramType = System.Data.SqlDbType.NVarChar;

2. 排除冗余依赖 #

StackExchange.Exceptional.AspNetCore可能间接引入了旧版本的System.Data.SqlClient，而.NET 8中SqlDbType已整合到System.Data.Common。可以在项目文件中直接排除该冗余依赖：

<ItemGroup>
  <PackageReference Remove="System.Data.SqlClient" />
</ItemGroup>

或者在Exceptional的包引用中添加排除规则：

<PackageReference Include="StackExchange.Exceptional.AspNetCore" Version="2.2.32">
  <ExcludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</ExcludeAssets>
  <PrivateAssets>all</PrivateAssets>
</PackageReference>

3. 升级Exceptional到兼容版本 #

检查StackExchange.Exceptional.AspNetCore的最新版本，新版本通常会适配.NET 8，不再依赖旧的System.Data.SqlClient。将包引用更新到最新兼容版本即可：

<PackageReference Include="StackExchange.Exceptional.AspNetCore" Version="最新兼容版本号" />

4. 用别名区分冲突程序集（备用方案） #

如果确实需要保留两个程序集，可以在项目文件中为冲突程序集设置别名：

<ItemGroup>
  <Reference Include="System.Data.SqlClient, Version=4.1.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a">
    <Aliases>OldSqlClient</Aliases>
  </Reference>
</ItemGroup>

然后在代码文件顶部声明别名并使用：

extern alias OldSqlClient;
// 使用旧版本SqlClient中的类型
var oldType = OldSqlClient::System.Data.SqlDbType.Int;

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