发布.NET项目时报AD0001警告NullReferenceException无法解决

问题原因 #

该报错是跨框架引用场景下Microsoft.AspNetCore.Mvc.Analyzers分析器组件版本不匹配导致的编译时异常，本地运行默认跳过部分发布编译校验所以不会触发，发布时执行全量编译校验就会抛出错误。

可落地解决方案（按优先级排序） #

方案1：快速禁用出问题的分析器（无功能影响，立即生效） #

在UI层项目的.csproj文件的<PropertyGroup>节点中添加如下配置即可：

<DisableImplicitAspNetCoreAnalyzers>true</DisableImplicitAspNetCoreAnalyzers>

如果不需要完全禁用所有AspNetCore分析器，仅跳过本次AD0001报错，可在项目根目录的.editorconfig文件中添加规则：

dotnet_diagnostic.AD0001.severity = none

注：该分析器仅用于开发时校验MVC路由参数命名规范，禁用后不会影响项目运行逻辑，对生产环境无任何副作用

方案2：统一组件版本（根源修复） #

检查类库层和UI层所有项目引用的Microsoft.AspNetCore.Mvc.AnalyzersNuGet包版本，确保所有项目使用完全相同的版本，且适配.NET 5.0的最高兼容版本为2.2.x，不要引用3.0及以上版本的该包，避免版本冲突。

方案3：发布时跳过分析器执行 #

如果仅在发布阶段触发报错，可以直接调整发布配置跳过分析器校验，执行发布命令时添加参数：
dotnet publish -c Release /p:RunAnalyzersDuringBuild=false
也可以直接写入UI层.csproj文件固定配置：

<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Release|AnyCPU'">
  <RunAnalyzersDuringBuild>false</RunAnalyzersDuringBuild>
</PropertyGroup>

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