升级.NET 5后ComplexTypeModelBinder过时无法继承实现自定义绑定器如何解决

.NET 5 之后官方将ComplexObjectModelBinder设计为密封类，目的是减少继承带来的版本兼容风险，推荐使用组合模式+自定义绑定器提供器替代原有继承方案，可完全实现相同的自定义实例创建逻辑：

1. 实现自定义模型绑定器 #

不再继承ComplexTypeModelBinder，改为内置ComplexObjectModelBinder处理属性填充逻辑，仅在外部完成自定义实例创建：

public class MyModelBinder : IModelBinder
{
    private readonly ComplexObjectModelBinder _innerBinder;

    public MyModelBinder(IDictionary<ModelMetadata, IModelBinder> propertyBinders, ILoggerFactory loggerFactory)
    {
        _innerBinder = new ComplexObjectModelBinder(propertyBinders, loggerFactory);
    }

    public async Task BindModelAsync(ModelBindingContext bindingContext)
    {
        // 此处放置原CreateModel方法中的自定义实例创建逻辑
        var customModel = new 你的目标模型类();

        // 预赋值实例到绑定上下文，内置绑定器会直接使用该实例填充属性，不会走默认创建逻辑
        bindingContext.Model = customModel;
        bindingContext.Result = ModelBindingResult.Success(customModel);

        // 调用内置绑定器完成后续的属性绑定工作
        await _innerBinder.BindModelAsync(bindingContext);
    }
}

2. 实现绑定器提供器，针对特定模型类型生效 #

public class MyModelBinderProvider : IModelBinderProvider
{
    public IModelBinder GetBinder(ModelBinderProviderContext context)
    {
        // 仅对需要自定义绑定的目标类型生效
        if (context.Metadata.ModelType == typeof(你的目标模型类))
        {
            var propertyBinders = context.Metadata.Properties
                .ToDictionary(prop => prop, prop => context.CreateBinder(prop));
            return new MyModelBinder(propertyBinders, context.LoggerFactory);
        }
        return null;
    }
}

3. 注册自定义绑定器 #

在服务配置中插入自定义绑定器提供器，优先级高于内置提供器：

// .NET 6+ Program.cs 写法
builder.Services.AddControllers(options =>
{
    options.ModelBinderProviders.Insert(0, new MyModelBinderProvider());
});

// .NET 5 Startup.cs 写法
services.AddControllers(options =>
{
    options.ModelBinderProviders.Insert(0, new MyModelBinderProvider());
});

补充说明 #

如果仅需要控制实例创建逻辑，不需要修改绑定流程，也可以通过重写IModelActivator实现，但上述组合方案完全兼容原有重写CreateModel的所有场景，改动量最小。

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