.NET Standard项目中Microsoft.XmlSerializer.Generator序列化生成失败求助

一、System.Span引用错误根源 #

Microsoft.XmlSerializer.Generator 8.0.0是适配.NET 8的包，而.NET Standard 2.0本身不支持System.Span相关API（该API需.NET Core 2.1+或.NET Framework 4.7.2+以上版本支持），版本不兼容是触发错误的核心原因。

解决方法：将Microsoft.XmlSerializer.Generator版本降级到2.1.0或更低版本，这类版本专门适配.NET Standard 2.0，不会引入高版本框架专属API。

二、sgen引入无关程序集问题处理 #

高版本生成器会自动加载目标框架不兼容的依赖集，导致冗余引用。降级包版本后，可在.csproj中添加以下配置优化：

<PropertyGroup>
  <GenerateSerializationAssemblies>On</GenerateSerializationAssemblies>
  <SGenUseProxyTypes>false</SGenUseProxyTypes>
  <SGenReferences>$(TargetPath)</SGenReferences>
</PropertyGroup>

• SGenUseProxyTypes设为false，仅生成指定类型的序列化代码，避免扫描全部依赖；
• SGenReferences指定仅引用当前项目输出，减少无关程序集加载。

三、多依赖项目版本解析错误修复 #

多项目（.NET Standard + .NET Framework）场景下，版本不一致会触发解析冲突：

1. 确保所有涉及XML序列化的项目（包括CommonInterface.Transfer）统一使用适配.NET Standard 2.0的Microsoft.XmlSerializer.Generator版本（如2.1.0）；
2. 在解决方案根目录创建Directory.Build.props文件，统一配置包版本，避免各项目版本混乱：

<Project>
  <PropertyGroup>
    <XmlSerializerGeneratorVersion>2.1.0</XmlSerializerGeneratorVersion>
  </PropertyGroup>
  <ItemGroup>
    <PackageReference Include="Microsoft.XmlSerializer.Generator" Version="$(XmlSerializerGeneratorVersion)" PrivateAssets="all" />
  </ItemGroup>
</Project>

3. 清理解决方案的NuGet缓存（删除packages文件夹及各项目的obj/bin目录），重新编译。

四、手动生成序列化程序集的兜底方案 #

若上述配置仍无效，可手动执行sgen命令指定目标类型生成：

sgen /assembly:YourProject.dll /types:YourNamespace.Foo

该命令仅针对指定的Foo类生成序列化程序集，避免自动扫描无关依赖。

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