使用AutoMapper映射EF Core Training对象到含关联员工的DTO报错如何解决

三个配置错误叠加触发了运行时异常：

• 所有实体、DTO中的导航集合仅暴露getter访问器，无公开setter，AutoMapper无法完成成员赋值
• 原Profile中EmployeeTrainings成员的映射源错误指向整个Training对象，而非Training实例自身的EmployeeTrainings集合属性
• 未为关联实体EmployeeTraining定义对应的DTO转换规则，且原DTO直接复用EF Core实体作为集合成员类型，破坏了映射隔离要求

1. 重构DTO结构，解耦EF实体依赖 #

弃用直接引用EF实体的集合定义，单独定义关联DTO，同时为所有集合属性补上可访问的setter，初始化空集合避免null引用：

// 关联关系对应的DTO，仅保留接口需要输出的字段
public class EmployeeTrainingDTO
{
    public Guid EmployeeId { get; set; }
    public string EmployeeDesignation { get; set; }
    public Guid TrainingId { get; set; }
}

public class TrainingDTO
{
    public string Host { get; set; }
    public string Name { get; set; }
    // 补全setter，替换为自定义DTO类型
    public ICollection<EmployeeTrainingDTO> EmployeeTrainings { get; set; } = new List<EmployeeTrainingDTO>();
}

注意：EF Core实体的导航集合同理需要补全setter，通常会在定义时直接初始化为空集合，避免新增关联时触发空引用：

// 修正后的EF实体定义
public class Training
{
     public Guid Id { get; set; }
     public string Host { get; set; }
     public string Name { get; set; }
     // 补全setter，初始化空集合
     public ICollection<EmployeeTraining> EmployeeTrainings { get; set; } = new List<EmployeeTraining>();
}

2. 修正AutoMapper Profile规则 #

补全所有嵌套类型的映射定义，修正错误的映射源指向：

public class TrainingProfile: Profile
{
    public TrainingProfile()
    {
        // 先定义关联实体到对应DTO的映射，指定嵌套字段的取值逻辑
        CreateMap<EmployeeTraining, EmployeeTrainingDTO>()
            .ForMember(
                dest => dest.EmployeeDesignation, 
                opt => opt.MapFrom(src => src.Employee.Designation)
            );

        // 定义Training到TrainingDTO的映射，修正集合属性的映射源
        CreateMap<Training, TrainingDTO>()
            .ForMember(
                dest => dest.EmployeeTrainings, 
                opt => opt.MapFrom(src => src.EmployeeTrainings)
            );

        // 如果需要DTO回写实体的双向映射，补上反向规则
        CreateMap<EmployeeTrainingDTO, EmployeeTraining>();
        CreateMap<TrainingDTO, Training>();
    }

3. 确保EF查询加载完整导航链路 #

在查询Training数据时，需要把关联的EmployeeTraining和对应的Employee实体一起加载，避免映射时遇到未加载的null导航属性：

// 正确的查询链路：连表加载多层导航属性
var training = dbContext.Trainings
    .Where(t => t.Id == trainingId)
    .Include(t => t.EmployeeTrainings)
    .ThenInclude(et => et.Employee)
    .FirstOrDefault();

• 不要在DTO中直接引用EF Core实体类型，会把实体自带的循环引用（比如EmployeeTraining中的Training属性反向指向Training本身）直接带到序列化流程中，触发无限递归的序列化异常
• 所有需要被AutoMapper赋值的成员，必须具备可访问的setter，仅定义getter的自动属性会直接触发“Destination Member”的映射异常
• 嵌套的复杂类型集合，必须在Profile中显式定义从源集合元素类型到目标集合元素类型的映射规则，AutoMapper不会自动隐式完成嵌套类型的转换

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