如何让IConfigurationBuilder.Bind()绑定失败时抛出错误？

这个问题确实是.NET配置绑定默认行为的一个小坑——当遇到不合法的枚举值时，绑定器会默默跳过错误，既不抛出异常，也不会给你任何提示，导致你根本不知道有配置项绑定失败了。下面给你几个实用的解决思路：

1. 绑定后手动校验列表 #

这是最直接的方案，绑定完成后遍历整个列表，检查每个项的枚举值是否合法：

List<myObject> myObjectList = new List<myObject>();
config.GetSection("Objects").Bind(myObjectList);

// 筛选出绑定失败的项（默认非法值会被设为枚举的默认值，比如CustomEnum.One）
var invalidItems = myObjectList
    .Select((item, index) => (Item: item, Index: index + 1)) // 索引从1开始方便定位配置项
    .Where(x => !Enum.IsDefined(typeof(CustomEnum), x.Item.myEnum))
    .ToList();

if (invalidItems.Any())
{
    var errorMsg = $"发现{invalidItems.Count}个非法配置项：\n" +
                   string.Join("\n", invalidItems.Select(x => $"第{x.Index}项的myEnum值无效"));
    throw new InvalidOperationException(errorMsg);
}

这种方式简单直接，不需要改动太多现有代码，适合快速解决问题。

2. 用Options模式+自定义验证器 #

如果你的项目用了依赖注入和Options模式，可以注册一个自定义验证器，让配置绑定后自动触发校验：

首先创建验证类：

public class MyObjectListValidator : IValidateOptions<List<myObject>>
{
    public ValidateOptionsResult Validate(string name, List<myObject> options)
    {
        if (options == null)
            return ValidateOptionsResult.Fail("配置列表不能为空");

        var invalidEntries = options
            .Select((item, idx) => (Item: item, Position: idx + 1))
            .Where(entry => !Enum.IsDefined(typeof(CustomEnum), entry.Item.myEnum))
            .ToList();

        if (invalidEntries.Any())
        {
            var errorDetails = string.Join("\n", invalidEntries
                .Select(e => $"第{e.Position}个配置项的myEnum值无效，请检查是否为One/Two"));
            return ValidateOptionsResult.Fail($"配置验证失败：\n{errorDetails}");
        }

        return ValidateOptionsResult.Success;
    }
}

然后在服务注册时添加这个验证器：

services.Configure<List<myObject>>(config.GetSection("Objects"));
services.AddSingleton<IValidateOptions<List<myObject>>, MyObjectListValidator>();

之后当你通过IOptions<List<myObject>>获取配置时，系统会自动执行验证，一旦发现非法值就会抛出包含详细信息的异常。

3. 改用字符串存储枚举值（业务层转换） #

如果不想依赖配置绑定的校验逻辑，也可以把配置类里的枚举字段改成字符串，在业务逻辑中手动转换并处理错误：

修改配置类：

public class myObject{ public string MyEnumValue { get; set; } }

业务层转换时：

foreach (var item in myObjectList)
{
    if (!Enum.TryParse<CustomEnum>(item.MyEnumValue, ignoreCase: false, out var enumValue))
    {
        throw new InvalidOperationException($"配置项中的枚举值「{item.MyEnumValue}」无效，合法值为One/Two");
    }
    // 使用转换后的enumValue进行后续逻辑
}

这种方式把校验逻辑完全掌握在自己手里，灵活性更高，也能更精准地提示错误信息。

补充说明 #

目前.NET的默认配置绑定确实没有提供直接的开关，让枚举绑定失败时立即抛出异常。所以上面这些手动校验或自定义验证的方案，是当前比较可行的解决办法。

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