基于AutoMapper的WebAPI中间件实现默认映射可行性问询

当然可行！这个思路不仅能帮你干掉大量重复的映射代码，还能通过自定义属性灵活控制规则，完全符合WebAPI的扩展设计思路。下面我来详细拆解怎么实现：

我们可以利用Action过滤器（比纯中间件更贴合WebAPI的场景，能精准获取Action的元数据、参数和返回值）来自动处理请求模型→业务模型、业务响应模型→视图响应模型的映射，再配合自定义特性标记不需要自动映射的端点。

1. 定义禁用自动映射的自定义特性 #

先创建一个特性类，用来标记不需要自动映射的控制器或Action：

[AttributeUsage(AttributeTargets.Method | AttributeTargets.Class)]
public class DisableAutoMappingAttribute : Attribute
{
    // 不需要额外逻辑，仅作为标记用
}

2. 实现自动映射的Action过滤器 #

这里假设你用的是AutoMapper做映射（如果是自定义的MapTo方法，替换成你的映射逻辑即可）：

public class AutoMappingActionFilter : IAsyncActionFilter
{
    private readonly IMapper _mapper;

    public AutoMappingActionFilter(IMapper mapper)
    {
        _mapper = mapper;
    }

    public async Task OnActionExecutionAsync(ActionExecutingContext context, ActionExecutionDelegate next)
    {
        // 第一步：检查当前Action是否标记了禁用属性，是的话直接跳过
        var hasDisableAttr = context.ActionDescriptor.EndpointMetadata
            .Any(meta => meta is DisableAutoMappingAttribute);
        if (hasDisableAttr)
        {
            await next();
            return;
        }

        // 第二步：自动处理请求模型→业务模型的映射
        foreach (var (paramKey, paramValue) in context.ActionArguments.ToList())
        {
            if (paramValue == null) continue;
            var paramType = paramValue.GetType();
            // 这里可以根据你的命名规则判断，比如后缀是RequestViewModel
            if (paramType.Name.EndsWith("RequestViewModel"))
            {
                // 推断对应的业务模型类型（比如把RequestViewModel后缀去掉）
                var modelTypeName = paramType.Name.Replace("RequestViewModel", "");
                var modelType = Type.GetType($"{paramType.Namespace}.{modelTypeName}");
                
                if (modelType != null)
                {
                    var mappedModel = _mapper.Map(paramValue, paramType, modelType);
                    context.ActionArguments[paramKey] = mappedModel;
                }
            }
        }

        // 执行原Action逻辑
        var resultContext = await next();

        // 第三步：自动处理业务响应模型→视图响应模型的映射
        if (resultContext.Result is ObjectResult objectResult && objectResult.Value != null)
        {
            var responseModelType = objectResult.Value.GetType();
            // 同样根据命名规则推断视图模型类型
            if (responseModelType.Name.EndsWith("ResponceModel"))
            {
                var viewModelTypeName = responseModelType.Name.Replace("ResponceModel", "ResponceViewModel");
                var viewModelType = Type.GetType($"{responseModelType.Namespace}.{viewModelTypeName}");
                
                if (viewModelType != null)
                {
                    var mappedViewModel = _mapper.Map(objectResult.Value, responseModelType, viewModelType);
                    objectResult.Value = mappedViewModel;
                }
            }
        }
    }
}

3. 注册过滤器和映射服务 #

在Program.cs中把过滤器和AutoMapper（如果用的话）注册到服务容器：

var builder = WebApplication.CreateBuilder(args);

// 注册AutoMapper（指定你的映射Profile所在的程序集）
builder.Services.AddAutoMapper(typeof(Program));

// 添加MVC并注册自定义过滤器
builder.Services.AddControllers(options =>
{
    options.Filters.Add<AutoMappingActionFilter>();
});

var app = builder.Build();

// 后续的管道配置...
app.MapControllers();
app.Run();

4. 使用示例 #

简化后的控制器方法 #

现在你的控制器方法可以去掉重复的映射代码，直接接收业务模型、返回业务响应模型：

[Route("test"), HttpPost]
public ResponceModel Test(Model model)
{
    // 直接用业务模型调用服务
    return service.DoWork(model);
    // 过滤器会自动把ResponceModel映射为ResponceViewModel返回给前端
}

禁用自动映射的端点 #

如果某个端点需要手动处理映射，只需要加上自定义特性：

[Route("custom-mapping"), HttpPost, DisableAutoMapping]
public ResponceViewModel CustomMapping(RequestViewModel model)
{
    // 这里完全手动处理映射，不受过滤器影响
    Model data = model.MapTo<Model>();
    ResponceModel response = service.DoWork(data);
    return response.MapTo<ResponceViewModel>();
}

1. 映射规则的可靠性：上面的示例用命名规则推断类型，如果你有更复杂的映射关系，建议在AutoMapper的Profile中显式配置映射，这样过滤器直接调用_mapper.Map即可，不需要依赖命名规则，更稳定。
2. 异常处理：要在过滤器中添加try-catch块，处理映射失败（比如类型找不到、映射配置缺失）的情况，避免整个请求崩溃。
3. 特殊场景兼容：如果你的控制器方法有多个参数、返回值不是ObjectResult（比如FileResult、EmptyResult），需要在过滤器中增加判断逻辑，跳过这些场景的映射。
4. 性能考量：自动映射会带来微小的性能开销，但对于绝大多数WebAPI场景来说可以忽略；如果是超高并发的核心接口，建议手动映射或禁用自动映射。

这个方案完全可行，既实现了代码复用、消除重复逻辑，又通过自定义特性保留了灵活性，是优化WebAPI控制器代码的优秀方案。

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