.NET SDK升级至9.0.300+后MetaLama与Razor.Compiler编译报错求助

问题概述 #

升级.NET SDK至9.0.300+版本后，Blazor或RCL（类库）项目中所有与MetaLama相关的库编译时会触发以下错误：

An instance of analyzer Microsoft.CodeAnalysis.Razor.Compiler.Analyzers.ComponentParameterNullableWarningSuppressor cannot be created from C:\Program Files\dotnet\sdk\9.0.301\Sdks\Microsoft.NET.Sdk.Razor\source-generators\Microsoft.CodeAnalysis.Razor.Compiler.dll

进一步排查确认核心错误原因：

Method 'get_SupportedSuppressions' in type 'Microsoft.CodeAnalysis.Razor.Compiler.Analyzers.ComponentParameterNullableWarningSuppressor' from assembly 'Microsoft.CodeAnalysis.Razor.Compiler, Version=9.0.0.0, Culture=neutral, PublicKeyToken=adb9793829ddae60' does not have an implementation.

该问题由设备中原有文件与新版SDK的Razor编译器组件存在版本不匹配/冲突导致，旧版本组件未实现新版SDK要求的接口方法。

临时解决方案 #

• 清理NuGet全局缓存：删除%USERPROFILE%\.nuget\packages目录下所有与Microsoft.CodeAnalysis.Razor.Compiler相关的旧版本文件夹，避免缓存文件干扰编译。
• 强制绑定组件版本：在项目.csproj文件中显式指定与当前SDK版本匹配的Microsoft.CodeAnalysis.Razor.Compiler版本，示例配置：

<ItemGroup>
  <PackageReference Include="Microsoft.CodeAnalysis.Razor.Compiler" Version="9.0.301" PrivateAssets="all" />
</ItemGroup>

• 修复SDK安装：重新运行.NET SDK 9.0.301安装程序，选择「修复」选项，确保SDK文件完整无损坏、版本统一。
• 临时禁用冲突分析器：若需快速恢复编译，可在项目文件中移除出错的分析器：

<ItemGroup>
  <Analyzer Remove="Microsoft.CodeAnalysis.Razor.Compiler.Analyzers.ComponentParameterNullableWarningSuppressor" />
</ItemGroup>

长期兼容建议 #

• 保持项目依赖与.NET SDK版本同步，避免跨大版本混合使用NuGet包。
• 使用global.json锁定SDK版本，确保团队开发环境一致：

{
  "sdk": {
    "version": "9.0.301",
    "rollForward": "latestMinor"
  }
}

• 关注MetaLama官方更新，等待适配.NET 9.0.300+版本的正式发布，从根源解决兼容性问题。

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