无法将appsettings.json中邮箱地址加载到List<MailAddress>，求排查

你遇到的加载失败问题主要由三个核心错误导致，下面逐一说明并给出修复方法：

1. 配置键名拼写不匹配 #

你的配置类Setting中属性名为MailAddresses，但appsettings.json里对应的键是Mailadresses（缺少字母r）。.NET配置绑定会严格匹配键名（尽管大小写不敏感，但拼写错误会导致无法映射），这是最直接的原因。

2. MailAddress的配置格式错误 #

.NET配置系统无法直接将数组格式["邮箱", "显示名"]绑定到MailAddress对象，原因是：

• MailAddress的核心属性（如Address、DisplayName）是只读的，依赖构造函数初始化，而非公共可写属性；
• 配置系统默认不支持数组到复杂对象的构造函数绑定。
  同时你第二个和第三个邮箱项的格式错误：把邮箱和显示名合并到了同一个字符串中，变成了单元素数组，完全不符合预期结构。

修复方案 #

方案一：使用MailAddress原生支持的字符串格式（推荐） #

直接用"显示名 <邮箱地址>"的标准格式配置，同时修正键名，配置系统可以自动解析为MailAddress对象：

修改后的appsettings.json：

{
  "Settings": {
    "MailAddresses": [
      "DisplayName 1 <first@domain.com>",
      "DisplayName 2 <second@domain.com>",
      "DisplayName 3 <third@domain.com>"
    ]
  }
}

你的原有代码无需修改，即可正常绑定到List<MailAddress>。

方案二：使用清晰的对象结构配置 #

如果你需要更明确的键值对结构，可以先定义一个DTO类，再转换为MailAddress：

1. 修改appsettings.json为对象格式：

{
  "Settings": {
    "MailAddresses": [
      {
        "Address": "first@domain.com",
        "DisplayName": "DisplayName 1"
      },
      {
        "Address": "second@domain.com",
        "DisplayName": "DisplayName 2"
      },
      {
        "Address": "third@domain.com",
        "DisplayName": "DisplayName 3"
      }
    ]
  }
}

2. 调整配置类与转换逻辑：

// 中间DTO类，用于接收配置
public class MailAddressDto
{
    public string Address { get; set; }
    public string DisplayName { get; set; }
}

public class Setting
{
    public List<MailAddressDto> MailAddresses { get; set; }

    // 转换为实际的MailAddress列表
    public List<MailAddress> ToMailAddressList()
    {
        return MailAddresses?.Select(dto => new MailAddress(dto.Address, dto.DisplayName))
                             .ToList() ?? new List<MailAddress>();
    }
}

额外检查 #

确保appsettings.json的复制到输出目录属性设置为「如果较新则复制」或「始终复制」，否则程序运行时无法读取到配置文件。

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