构建NLog时Roslyn分析器抛出类型转换异常求助

原因分析 #

这个错误是ILLink.RoslynAnalyzer.RequiresUnreferencedCodeAnalyzer分析器的内部Bug：

• 分析器在处理代码中的泛型类型参数（TypeParameterSymbol）时，错误地尝试将其强制转换为INamedTypeSymbol类型，但泛型参数本身不属于命名类型符号的范畴，直接触发了类型转换异常。
• 切换VS版本（2019/2022）或升级.NET Framework版本（4.6→4.8）后问题仍存在，是因为项目始终启用了这个带Bug的分析器——它可能随NLog的NuGet包、或.NET SDK默认引入，和目标框架版本没有直接关联。

解决办法 #

1. 直接禁用问题分析器 #

在项目的.csproj文件中添加以下配置，移除触发错误的分析器：

<ItemGroup>
  <Analyzer Remove="ILLink.RoslynAnalyzer.RequiresUnreferencedCodeAnalyzer" />
</ItemGroup>

如果找不到具体分析器名称，也可以全局移除ILLink分析器：

<ItemGroup>
  <Analyzer Remove="ILLink.RoslynAnalyzer.dll" />
</ItemGroup>

2. 调整NLog版本 #

尝试切换到未引入该问题分析器的NLog版本：

• 查看NLog版本更新日志，回退到某个稳定的旧版本（比如部分5.x之前的版本，具体可根据实际测试确认）；
• 或升级到修复了该依赖问题的最新NLog版本。

3. 关闭不必要的剪裁分析选项 #

在Visual Studio中打开项目属性：

• 进入「生成」→「高级」；
• 检查是否启用了「启用剪裁分析」相关选项，若启用则关闭（.NET Framework项目通常不需要该功能）。

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