AutoMapper静态类无法映射列表与嵌套实体，求故障原因及静态映射方案建议

你写的泛型静态MapperUtil<TSource, TDestination>无法处理列表和嵌套实体，核心有两个原因：

1. 泛型静态类的配置是完全隔离的
   .NET中每一组不同的TSource、TDestination组合，都会生成独立的泛型闭合类型，每个类型都持有自己独有的Mapper实例和配置。比如你用MapperUtil<User, UserDto>时，只会注册User和UserDto的映射；当你要转换列表时如果调用MapperUtil<List<User>, List<UserDto>>，这个实例的配置只会注册两个列表类型的映射，并没有注册元素类型User和UserDto的映射，更不会包含嵌套子实体的映射配置，自然无法正常转换。
2. AutoMapper本身不需要单独配置集合映射
   AutoMapper内置支持集合类型的自动转换，只要你配置了集合元素的类型映射，直接转List<>、IEnumerable<>等集合类型都不需要额外配置。你单独给List<User>和List<UserDto>加配置能跑通只是特例，遇到嵌套实体场景依然会失效。

分场景判断：

• 小型项目、不需要做单元测试、不需要依赖注入的场景，静态映射类是合理的，使用简单不需要额外注入。
• 中大型项目、有单元测试需求、使用ASP.NET Core等依赖注入框架的场景，不推荐用静态类，静态类无法Mock，会提升单元测试的成本，更推荐将IMapper注入到容器中使用。

核心思路是全局统一配置映射，所有转换共用同一个Mapper实例，不需要搞泛型静态类，示例代码如下：

using AutoMapper;
using System.Reflection;

public static class MapperUtil
{
    // 全局唯一的Mapper实例
    private static readonly IMapper _globalMapper;

    // 静态构造函数，应用运行期间只会执行一次，统一初始化所有映射配置
    static MapperUtil()
    {
        var mapperConfig = new MapperConfiguration(cfg =>
        {
            // 方案1：手动注册所有实体映射，不需要注册集合类型
            cfg.CreateMap<User, UserDto>().ReverseMap();
            cfg.CreateMap<Address, AddressDto>().ReverseMap();
            // 其他实体映射依次添加即可

            // 方案2：进阶自动注册，扫描当前程序集所有继承Profile的映射配置类，适合实体多的项目
            // cfg.AddMaps(Assembly.GetExecutingAssembly());
        });

        // 开发环境可以开启配置验证，提前发现映射不匹配的问题
        // mapperConfig.AssertConfigurationIsValid();

        _globalMapper = mapperConfig.CreateMapper();
    }

    /// <summary>
    /// 实体映射方法，支持单个实体、集合、嵌套实体转换
    /// </summary>
    public static TDestination Map<TDestination>(object source)
    {
        return _globalMapper.Map<TDestination>(source);
    }

    /// <summary>
    /// 显式指定源类型和目标类型的映射方法
    /// </summary>
    public static TDestination Map<TSource, TDestination>(TSource source)
    {
        return _globalMapper.Map<TSource, TDestination>(source);
    }
}

使用示例：

// 单个实体转换
UserDto userDto = MapperUtil.Map<UserDto>(user);
// 列表转换，不需要额外配置
List<UserDto> userDtos = MapperUtil.Map<List<UserDto>>(userList);
// 嵌套实体自动转换，只要注册了子实体的映射即可

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