如何彻底解决C#编译警告CS8618？

问题背景 #

当声明以下Cat类时：

public class Cat
{
    public string Name { get; set; }
}

会触发编译警告：

CS8618 - 非空变量在退出构造函数时必须包含非空值。请考虑将其声明为可空类型。

由于业务规则要求Name是必填属性，尝试过的几种方案均存在不足：

• 构造函数/属性初始化空字符串：
  两种实现本质是语法糖，允许Cat cat = new ();直接实例化，但会用空字符串这类无效值初始化，可能因未覆盖赋值导致对象不符合规则：

  // 构造函数赋值
  public class Cat
  {
      public Cat()
      {
          Name = string.Empty;
      }
      public string Name { get; set; }
  }
  
  // 属性直接初始化
  public class Cat
  {
      public string Name { get; set; } = string.Empty;
  }
  

• 声明可空类型：
  违背业务规则，允许对象在无Name的情况下被创建：

  public class Cat
  {
      public string? Name { get; set; }
  }
  

• 使用required关键字：
  仅在编译阶段强制初始化，通过AutoMapper等反射工具创建对象时，仍可能出现Name未赋值或为null的情况：

  public class Cat
  {
      public required string Name { get; set; }
  }
  

以上方案均未从根本上避免对象被赋予无效值，如何真正解决该问题？

解决方案：从对象创建源头保证有效性 #

核心思路是强制通过构造函数传入必填参数，并在运行时验证参数有效性，同时限制属性的修改权限（按需），确保对象从创建到生命周期内都符合业务规则。

1. 只读属性+构造函数强制注入（推荐） #

如果业务规则中Name不需要被修改，直接将属性设为只读，通过构造函数传入并验证参数：

public class Cat
{
    public string Name { get; }

    public Cat(string name)
    {
        // 运行时验证：确保Name非null、非空、非空白
        if (string.IsNullOrWhiteSpace(name))
        {
            throw new ArgumentException("名称不能为空、空白或null", nameof(name));
        }
        Name = name;
    }
}

• 编译时：必须通过new Cat("Mittens")的方式创建对象，无参构造被隐式禁用，避免遗漏赋值。
• 运行时：通过参数验证杜绝无效值，确保对象创建时就处于有效状态。
• 生命周期内：Name为只读属性，无法被修改，避免后续被设为无效值。

2. 可修改属性+Setter验证（按需） #

如果业务允许修改Name，可以保留set方法，但在Setter中添加验证逻辑，同时仍通过构造函数强制初始化：

public class Cat
{
    private string _name;

    public string Name
    {
        get => _name;
        set
        {
            if (string.IsNullOrWhiteSpace(value))
            {
                throw new ArgumentException("名称不能为空、空白或null", nameof(value));
            }
            _name = value;
        }
    }

    public Cat(string name)
    {
        // 复用Setter的验证逻辑
        Name = name;
    }
}

这样既保证了创建时的有效性，也能在修改Name时防止无效值被设置。

3. 处理AutoMapper场景 #

AutoMapper默认会尝试使用无参构造函数创建对象，需要手动配置映射规则，指定使用带参数的构造函数：

var mapperConfig = new MapperConfiguration(cfg =>
{
    cfg.CreateMap<CatDto, Cat>()
        .ConstructUsing(dto => new Cat(dto.Name));
});

同时要确保源CatDto的Name字段是有效的，或在映射前添加源数据验证，避免传入无效值。

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