Mapster无法适配含循环导航属性的模型：PartyGroups未被映射

核心问题点 #

1. ViewModel类型不匹配：GroupViewModel中的PartyGroups属性类型是List<PartyGroupModel>（实体类）而非List<PartyGroupViewModel>（视图模型），Mapster无法跨类型自动映射集合。
2. 循环引用与只读属性限制：PartyGroupViewModel的Party和Group属性是只读（仅get），且存在循环引用（Party→PartyGroup→Party、Group→PartyGroup→Group），Mapster默认无法为只读属性赋值，循环引用也可能导致映射中断。
3. 导航属性未加载（EF场景）：若使用EF Core，查询PartyModel时未显式IncludePartyGroups及关联的Group，导致导航属性为null，自然无法转换。

分步解决方案 #

1. 修正ViewModel类型定义 #

修改GroupViewModel的PartyGroups属性类型，并给只读属性添加初始化或setter：

public class GroupViewModel : ViewModel
{
    // ... 其他属性保持不变

    #region Navigation Properties
    // 修正为ViewModel类型，并添加private set支持Mapster赋值
    public List<PartyGroupViewModel> PartyGroups { get; private set; } = new List<PartyGroupViewModel>();
    #endregion Navigation Properties
}

同时调整PartyGroupViewModel的只读属性，允许Mapster赋值：

public class PartyGroupViewModel : SlaveViewModel
{
    // ... 其他属性保持不变

    #region Navigation Properties
    // 添加private set让Mapster可以赋值
    public PartyViewModel Party { get; private set; } = new();
    public GroupViewModel Group { get; private set; } = new();
    #endregion Navigation Properties
}

2. 配置Mapster处理循环引用与映射规则 #

在Mapster全局配置中显式处理循环引用，并定义必要映射规则：

// 全局配置（例如在Startup/Program.cs中）
TypeAdapterConfig.GlobalSettings.Default
    .IgnoreCycles() // 忽略循环引用，避免无限递归
    .PreserveReference(true); // 保留引用，避免重复创建对象

// 显式配置PartyGroupModel到PartyGroupViewModel的映射
TypeAdapterConfig<PartyGroupModel, PartyGroupViewModel>.NewConfig()
    .Map(dest => dest.Party, src => src.Party)
    .Map(dest => dest.Group, src => src.Group);

// 配置GroupModel到GroupViewModel的映射
TypeAdapterConfig<GroupModel, GroupViewModel>.NewConfig()
    .Map(dest => dest.PartyGroups, src => src.PartyGroups);

3. 确保EF Core查询时加载完整导航属性 #

如果使用EF Core，查询PartyModel时必须Include关联的PartyGroups及Group：

var party = await _dbContext.Parties
    .Include(p => p.PhoneNumbers)
    .Include(p => p.PartyGroups)
        .ThenInclude(pg => pg.Group) // 加载PartyGroup关联的Group
    .FirstOrDefaultAsync(p => p.Id == partyId);

// 执行转换
var viewModel = party.Adapt<PartyViewModel>();

4. 调试映射问题 #

若仍有异常，可启用Mapster调试日志排查细节：

TypeAdapterConfig.GlobalSettings.EnableDebugLogging();

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