AutoMapper ForMember方法致映射失效，如何正确使用该方法？

一、正确使用ForMember的配置步骤 #

先明确实体与DTO的定义（确保属性名拼写正确）：

// 实体模型
public class User
{
    public int Id { get; set; }
    public string FirstName { get; set; }
    public string LastName { get; set; }
    // 其他业务属性
}

// DTO记录类型
public record UserDTO(int Id, string FullName);

1. 配置MappingProfile #

创建继承自Profile的映射配置类，在构造函数中通过ForMember指定FullName的映射规则，注意处理空值避免空引用异常：

public class UserMappingProfile : Profile
{
    public UserMappingProfile()
    {
        CreateMap<User, UserDTO>()
            // 拼接FirstName和LastName，Trim去除首尾空格，空值替换为空字符串
            .ForMember(dest => dest.FullName, opt => opt.MapFrom(src => 
                $"{src.FirstName ?? string.Empty} {src.LastName ?? string.Empty}".Trim()))
            // 同名属性（如Id）会自动映射，无需额外配置
            .ReverseMap(); // 不需要反向映射可删除
    }
}

2. 注册AutoMapper服务 #

在Program.cs中注册AutoMapper，指定包含映射配置类的程序集：

var builder = WebApplication.CreateBuilder(args);

// 注册AutoMapper，自动扫描当前程序集下的Profile类
builder.Services.AddAutoMapper(typeof(UserMappingProfile));

// 注册其他服务（如Controllers、DbContext等）
builder.Services.AddControllers();
builder.Services.AddDbContext<YourDbContext>(options => 
    options.UseSqlServer(builder.Configuration.GetConnectionString("DefaultConnection")));

var app = builder.Build();

// 中间件配置
app.UseHttpsRedirection();
app.UseAuthorization();
app.MapControllers();

app.Run();

3. 业务代码中使用映射 #

在服务或控制器中注入IMapper，执行映射操作：

[ApiController]
[Route("api/users")]
public class UsersController : ControllerBase
{
    private readonly IMapper _mapper;
    private readonly YourDbContext _dbContext;

    public UsersController(IMapper mapper, YourDbContext dbContext)
    {
        _mapper = mapper;
        _dbContext = dbContext;
    }

    [HttpGet]
    public async Task<ActionResult<List<UserDTO>>> GetAllUsers()
    {
        var users = await _dbContext.Users.ToListAsync();
        // 执行实体到DTO的映射
        var userDTOs = _mapper.Map<List<UserDTO>>(users);
        return Ok(userDTOs);
    }
}

常见错误排查：

• 检查ForMember中源属性名（FirstName/LastName）是否与实体类一致，拼写错误会导致映射失败
• 未处理空值：如果FirstName或LastName为null，直接拼接会抛出空引用异常，需用??替换为空字符串
• 确认目标成员FullName的类型为string，与拼接结果类型匹配

二、ForMember方法是否过时？ #

ForMember方法并未过时，在AutoMapper 12.x版本中仍是自定义成员映射的核心API，官方文档依然将其作为推荐方案用于处理非自动映射的字段场景。

三、替代方案 #

1. EF Core投影查询（ProjectTo） #

如果是从EF Core数据库直接查询并映射，使用ProjectTo可以将拼接逻辑转换为SQL查询，提升性能：

[HttpGet]
public async Task<ActionResult<List<UserDTO>>> GetAllUsers()
{
    // 直接在查询阶段完成映射，无需先查询实体再映射
    var userDTOs = await _dbContext.Users
        .ProjectTo<UserDTO>(_mapper.ConfigurationProvider)
        .ToListAsync();
    return Ok(userDTOs);
}

此方式依然依赖之前的MappingProfile配置。

2. 自定义值解析器（ValueResolver） #

当拼接逻辑复杂或需要复用时，可定义独立的值解析器类：

public class FullNameResolver : IValueResolver<User, UserDTO, string>
{
    public string Resolve(User source, UserDTO destination, string destMember, ResolutionContext context)
    {
        // 复杂逻辑可在此扩展，比如添加中间名处理、格式转换等
        return $"{source.FirstName ?? string.Empty} {source.LastName ?? string.Empty}".Trim();
    }
}

然后在MappingProfile中配置使用该解析器：

CreateMap<User, UserDTO>()
    .ForMember(dest => dest.FullName, opt => opt.MapFrom<FullNameResolver>());

3. DTO内置计算属性 #

如果允许在DTO中暴露FirstName和LastName，可直接在record中定义计算属性，无需AutoMapper配置：

public record UserDTO(int Id, string FirstName, string LastName)
{
    // 自动计算FullName
    public string FullName => $"{FirstName ?? string.Empty} {LastName ?? string.Empty}".Trim();
}

此时AutoMapper会自动映射Id、FirstName、LastName三个属性，FullName由DTO自行计算。

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