ASP.NET Core中AutoMapper配置报错：Expression 'dest => dest'需解析为顶级成员

异常信息 #

System.Reflection.TargetInvocationException: Exception has been thrown by the target of an invocation.
---> System.ArgumentException: Expression 'dest => dest' must resolve to top-level member and not any child object's properties. You can use ForPath, a custom resolver on the child type or the AfterMap option instead. (Parameter 'lambdaExpression')
at AutoMapper.Internal.ReflectionHelper.FindProperty(LambdaExpression lambdaExpression)

现有配置代码 #

AutoMapper Profile #

public class AuthenticationMappingProfile : Profile
{
    public AuthenticationMappingProfile()
    {
        CreateMap<(RegisterRequest registerRequest, string BaseUrl, byte[] Image), RegisterCommand>()
            .ForPath(dest => dest.BaseUrl, opt => opt.MapFrom(src => src.BaseUrl))
            .ForPath(dest => dest.Avatar, opt => opt.MapFrom(src => src.Image))
            .ForPath(dest => dest.FirstName, opt => opt.MapFrom(src => src.registerRequest.FirstName))
            .ForPath(dest => dest.LastName, opt => opt.MapFrom(src => src.registerRequest.LastName))
            .ForPath(dest => dest.Email, opt => opt.MapFrom(src => src.registerRequest.Email))
            .ForPath(dest => dest.Password, opt => opt.MapFrom(src => src.registerRequest.Password))
            .ForPath(dest => dest.ConfirmPassword, opt => opt.MapFrom(src => src.registerRequest.ConfirmPassword))
            .ForPath(dest => dest.Birthday, opt => opt.MapFrom(src => src.registerRequest.Birthday))
            .ForPath(dest => dest.Gender, opt => opt.MapFrom(src => src.registerRequest.Gender))
            .ForPath(dest => dest.Avatar, opt => opt.MapFrom(src => src.Image));
    }
}

相关类定义 #

public record RegisterRequest
{
    public string FirstName { get; init; }
    public string LastName { get; init; }
    public string Email { get; init; }
    public string Password { get; init; }
    public string ConfirmPassword { get; init; }
    public DateTime Birthday { get; init; }
    public string Gender { get; init; }
    public IFormFile? Avatar { get; init; }
}

public record RegisterCommand(
    string FirstName,
    string LastName,
    string Email,
    string Password,
    string ConfirmPassword,
    DateTime Birthday,
    string Gender,
    byte[]? Avatar,
    string BaseUrl
) : IRequest<ErrorOr<AuthenticationResult>>;

问题原因 #

1. 错误使用ForPath：ForPath仅用于映射嵌套层级的属性，而目标RegisterCommand的所有成员都是顶级属性，应该使用ForMember。
2. 重复映射属性：代码中重复对Avatar进行了两次ForPath配置，会导致解析冲突。
3. 记录类型的构造函数映射歧义：RegisterCommand是记录类型，AutoMapper默认会优先尝试通过构造函数映射，但元组作为源时，自动映射逻辑会出现解析错误。

解决方案 #

方案一：使用ForMember替换ForPath并清理重复配置 #

将所有ForPath改为ForMember，删除重复的Avatar映射配置：

public class AuthenticationMappingProfile : Profile
{
    public AuthenticationMappingProfile()
    {
        CreateMap<(RegisterRequest registerRequest, string BaseUrl, byte[] Image), RegisterCommand>()
            // 映射元组直接提供的属性
            .ForMember(dest => dest.BaseUrl, opt => opt.MapFrom(src => src.BaseUrl))
            .ForMember(dest => dest.Avatar, opt => opt.MapFrom(src => src.Image))
            // 映射RegisterRequest中的属性到Command对应成员
            .ForMember(dest => dest.FirstName, opt => opt.MapFrom(src => src.registerRequest.FirstName))
            .ForMember(dest => dest.LastName, opt => opt.MapFrom(src => src.registerRequest.LastName))
            .ForMember(dest => dest.Email, opt => opt.MapFrom(src => src.registerRequest.Email))
            .ForMember(dest => dest.Password, opt => opt.MapFrom(src => src.registerRequest.Password))
            .ForMember(dest => dest.ConfirmPassword, opt => opt.MapFrom(src => src.registerRequest.ConfirmPassword))
            .ForMember(dest => dest.Birthday, opt => opt.MapFrom(src => src.registerRequest.Birthday))
            .ForMember(dest => dest.Gender, opt => opt.MapFrom(src => src.registerRequest.Gender));
    }
}

方案二：直接调用记录构造函数（更直观） #

利用记录类型的构造函数，直接手动传入所有参数，完全规避AutoMapper的自动映射歧义：

public class AuthenticationMappingProfile : Profile
{
    public AuthenticationMappingProfile()
    {
        CreateMap<(RegisterRequest registerRequest, string BaseUrl, byte[] Image), RegisterCommand>()
            .ConstructUsing(src => new RegisterCommand(
                src.registerRequest.FirstName,
                src.registerRequest.LastName,
                src.registerRequest.Email,
                src.registerRequest.Password,
                src.registerRequest.ConfirmPassword,
                src.registerRequest.Birthday,
                src.registerRequest.Gender,
                src.Image,
                src.BaseUrl
            ));
    }
}

方案对比 #

• 方案一保留了AutoMapper的自动映射能力，后续如果RegisterRequest或RegisterCommand新增名称一致的属性，无需修改映射配置。
• 方案二完全手动控制映射逻辑，适合结构简单、需要明确控制参数传递的场景，避免自动映射可能出现的意外问题。

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