.NET Core 3.1使用Microsoft.Xml.SgmlReader 1.8.18构建报MSB3246警告
警告触发的根本原因
- 警告的直接来源是MSBuild在解析项目程序集引用时,将无有效CLR程序集清单的非托管冗余文件当成托管依赖扫描,最终触发“模块缺少程序集清单”的校验失败报错。
- 对应到你使用的1.8.18版本NuGet包,其包结构本身存在打包缺陷:该包仅在面向.NET Framework 4.5的类库目录中,同时存放了两类文件:
SgmlReaderDll.dll:真正提供SgmlReader类库功能的托管程序集,也就是你可以通过反编译工具正常打开的文件SgmlReader.exe:独立的命令行工具,不属于类库依赖范畴,且本身没有嵌入.NET程序集清单,根本无法作为托管程序集加载
- 只有.NET Core 3.1项目会触发该警告的原因,是NuGet的版本回退逻辑存在匹配漏洞:这个包没有为.NET Core 3.1提供专属的兼容类库目录,项目在匹配引用时会自动回退到最高兼容的.NET Framework 4.5目录,且NuGet的文件匹配规则会把该目录下的所有文件(不管是dll还是exe)全部纳入引用列表;而netstandard2.0/2.1项目在回退匹配时,会优先命中更早版本的、仅存放核心dll的类库目录,不会扫到这个多余的exe文件,因此不会出现警告。
- 构建和启动VS时没有Fusion日志记录的原因也很明确:整个错误发生在MSBuild的构建时引用扫描阶段,还没进入.NET运行时的程序集加载流程,自然不会触发运行时的程序集绑定日志记录,和常见的运行时依赖缺失完全不是同一类问题。
对应修复方法
- 无功能影响的快速修复:修改项目文件显式排除无效的exe引用。在对应的
.csproj文件中加入以下构建逻辑,在MSBuild完成NuGet引用解析后,把这个多余的exe从引用列表中移除:
调整后构建时不会再扫描到这个无效文件,警告会彻底消失,且完全不影响核心dll的功能调用。<Target Name="RemoveInvalidSgmlReference" AfterTargets="ResolveAssemblyReferences"> <ItemGroup> <ReferencePath Remove="@(ReferencePath)" Condition="'%(FileName)%(Extension)' == 'SgmlReader.exe'" /> <ReferenceCopyLocalPaths Remove="@(ReferenceCopyLocalPaths)" Condition="'%(FileName)%(Extension)' == 'SgmlReader.exe'" /> </ItemGroup> </Target> - 长期维护性更好的方案:替换存在打包缺陷的依赖。当前你使用的这个官方包已经多年没有更新,同功能的类库可以选择带Sgml兼容实现的HtmlAgilityPack,或是社区维护的修正了打包问题的SgmlReader衍生包,直接替换现有依赖即可,无需额外做代码改动。
- 避坑提示:不需要在这个包的现有版本里反复调试版本号,你用到的1.8.18已经是这个官方包的最后发布版本,更低版本同样存在相同的打包缺陷,且对.NET Core的兼容性更差,换版本无法解决该问题。
内容的提问来源于stack exchange,提问作者Jørn Cornelius Olsen
相关产品推荐
相关产品推荐

