N层架构应用中AutoMapper配置：实体与领域模型映射方案咨询

问题背景 #

你的N层架构拆分得很清晰：

• MyApp.Model：EF实体模型（含EDMX）
• MyApp.DataAccess：EF仓储层
• MyApp.Domain：业务领域模型
• MyApp.Services：服务层
• MyApp.Api：Web API层

核心约束是Api层不能引用Model层，所以实体（Model层）→领域模型（Domain层）的映射不能放在Api层，而你已经在Api层完成了领域模型→DTO的映射。

解决方案思路 #

实体与领域模型的映射，完全应该放在服务层（MyApp.Services）来配置——因为服务层天然依赖MyApp.Domain和MyApp.Model（要调用仓储层获取实体，再转换成领域模型返回给Api层），刚好满足映射所需的类型访问权限。

另外推荐用AutoMapper的Profile类来做模块化配置，比静态Initialize更灵活，也方便后续扩展。

具体实现步骤 #

1. 在服务层添加AutoMapper引用 #

确保MyApp.Services项目已经通过NuGet安装了AutoMapper包：

Install-Package AutoMapper

2. 服务层创建领域映射Profile #

在MyApp.Services里新建一个Profile类，专门处理实体到领域模型的双向映射：

using AutoMapper;
using MyApp.Model;
using MyApp.Domain;

namespace MyApp.Services.Mapping
{
    public class DomainEntityProfile : Profile
    {
        public DomainEntityProfile()
        {
            // 实体→领域模型的映射
            CreateMap<State, StateModel>();
            // 领域模型→实体的映射（如果需要反向操作，比如更新数据）
            CreateMap<StateModel, State>();
            
            // 其他实体与领域模型的映射都可以加在这里
        }
    }
}

3. Api层保留DTO映射Profile #

把你原来Api层的静态配置改成Profile形式，更统一：

using AutoMapper;
using MyApp.Domain;
using MyApp.Api.Dtos;

namespace MyApp.Api.Mapping
{
    public class DomainDtoProfile : Profile
    {
        public DomainDtoProfile()
        {
            CreateMap<StateModel, StateDto>();
            CreateMap<StateDto, StateModel>();
        }
    }
}

4. 全局初始化所有映射配置 #

在Web API的启动入口（比如Global.asax.cs的Application_Start方法，或者Startup.cs的ConfigureServices），统一加载所有Profile并注册IMapper到Unity容器：

using AutoMapper;
using MyApp.Services.Mapping;
using MyApp.Api.Mapping;
using Unity;

protected void Application_Start()
{
    // 1. 构建AutoMapper配置，加载所有Profile
    var mapperConfig = new MapperConfiguration(cfg =>
    {
        // 加载服务层的实体-领域模型映射
        cfg.AddProfile<DomainEntityProfile>();
        // 加载Api层的领域模型-DTO映射
        cfg.AddProfile<DomainDtoProfile>();
    });

    // 验证映射配置是否正确（可选，但建议开启，提前发现配置错误）
    mapperConfig.AssertConfigurationIsValid();

    // 2. 将IMapper实例注册到Unity容器，方便各层注入使用
    var container = UnityConfig.Container;
    container.RegisterInstance<IMapper>(mapperConfig.CreateMapper());

    // 其他初始化工作（Web API路由、Unity配置等）
    GlobalConfiguration.Configure(WebApiConfig.Register);
}

5. 在服务层中使用映射 #

服务层从仓储层拿到实体后，通过注入的IMapper转换成领域模型返回给Api层：

using MyApp.DataAccess;
using MyApp.Domain;
using AutoMapper;

public class StateService
{
    private readonly IStateRepository _stateRepo;
    private readonly IMapper _mapper;

    // 通过Unity注入依赖
    public StateService(IStateRepository stateRepo, IMapper mapper)
    {
        _stateRepo = stateRepo;
        _mapper = mapper;
    }

    public StateModel GetStateById(int id)
    {
        // 从仓储层获取实体
        var stateEntity = _stateRepo.GetById(id);
        // 映射成领域模型返回
        return _mapper.Map<StateModel>(stateEntity);
    }
}

6. Api层使用映射返回DTO #

Api层注入IMapper，把服务层返回的领域模型转换成DTO：

using MyApp.Services;
using MyApp.Api.Dtos;
using AutoMapper;

public class StatesController : ApiController
{
    private readonly StateService _stateService;
    private readonly IMapper _mapper;

    public StatesController(StateService stateService, IMapper mapper)
    {
        _stateService = stateService;
        _mapper = mapper;
    }

    public IHttpActionResult Get(int id)
    {
        var stateModel = _stateService.GetStateById(id);
        var stateDto = _mapper.Map<StateDto>(stateModel);
        return Ok(stateDto);
    }
}

为什么这样可行？ #

• 服务层同时引用MyApp.Model和MyApp.Domain，完全有权限配置两者的映射，不会打破Api层不引用Model层的约束
• 用Profile模块化配置，每个层只负责自己相关的映射逻辑，后期维护更清晰
• 通过Unity注入IMapper，避免了静态Mapper类的耦合，更符合依赖注入的设计思想

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