Blazor处理Non-nullable误报警告的最佳实践

C# 启用可空引用类型检查后，Blazor 组件中通过[Inject]标记的依赖注入属性、[Parameter]标记的组件参数属性，会触发CS8618警告：Non-nullable property must contain a non-null value when exiting constructor。这类警告属于静态检查的误报——属性值由Blazor框架在组件初始化阶段完成赋值，运行时不会为null，不需要为了消除警告写冗余判空代码，按优先级推荐以下处理方式：

• 首选方案：单属性null!初始化（零副作用）
  对框架保证赋值的注入属性、参数属性，直接用null!（null原谅运算符）初始化即可，明确告知编译器该属性运行时必然非空，无需做未初始化检查。这个方案仅作用于单个属性，不会影响其他代码的可空检查逻辑，也没有任何运行时开销，是最推荐的做法。
  示例代码：

  [Inject] private IStringLocalizer<Element> L { get; set; } = null!;
  

  对于C# 11及以上版本，必填的组件参数可以直接加required修饰符，既可以消掉CS8618警告，还能让编译器在父组件漏传参数时直接报错，比null!更严谨：

  [Parameter] public required string ConfirmText { get; set; }
  

• 多属性场景：文件级定向屏蔽警告
  如果单个组件内注入的依赖数量较多，不想逐属性写null!，可以在当前文件内定向屏蔽CS8618警告，注意屏蔽范围仅限当前类，不要扩大到整个项目，避免漏掉真实的未赋值bug：

  // 放在文件头部、类定义之前
  #pragma warning disable CS8618
  public partial class Element
  {
      [Inject] private IStringLocalizer<Element> L { get; set; }
      [Inject] private NavigationManager NavigationManager { get; set; }
      [Inject] private IJSRuntime JsRuntime { get; set; }
      // 其他框架自动赋值的属性
  }
  #pragma warning restore CS8618
  

不推荐的做法 #

• 不要把这类属性声明为可空类型（如IStringLocalizer<Element>? L），后续每次调用属性都需要加!或者做null判断，会产生大量无意义的冗余代码
• 不要在项目配置（.csproj文件）中直接关闭可空引用类型检查，或者全局屏蔽CS8618警告，会彻底丢失可空检查对普通业务代码的bug防护能力
• 不要在构造函数里给这些属性塞空实现的默认值，既增加无意义代码，也可能掩盖依赖注入失败的真实问题

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