ASP.NET Core MVC中AutoMapper无参构造函数缺失异常排查

问题根源 #

你遇到的MissingMethodException是因为AutoMapper在初始化映射配置时，尝试实例化ServiceLayer.Automapper.ContactMapper类，但该类没有定义无参数构造函数。由于AutoMapper会在首次请求（甚至启动阶段）加载所有已注册的Profile类，这个错误会在控制器代码执行前触发，所以你无法命中控制器的断点，且访问任何控制器方法都会触发相同异常。

具体解决步骤 #

1. 检查ContactMapper的构造函数 #

首先查看ContactMapper类的代码，大概率是你定义了带参数的构造函数，但没有显式添加无参构造函数（C#中如果存在自定义构造函数，默认的无参构造会被自动移除）。示例错误代码：

public class ContactMapper : Profile
{
    private readonly IContactService _contactService;
    // 仅定义了带参数的构造函数，无默认无参构造
    public ContactMapper(IContactService contactService)
    {
        _contactService = contactService;
        // 映射配置代码
    }
}

2. 根据需求选择修复方案 #

方案一：ContactMapper不需要依赖服务

如果ContactMapper的构造函数参数是多余的，或者映射逻辑不需要依赖外部服务，直接添加无参构造函数即可：

public class ContactMapper : Profile
{
    // 显式添加无参构造函数
    public ContactMapper()
    {
        // 映射配置代码
    }
}

方案二：ContactMapper需要依赖服务

如果映射逻辑确实需要依赖服务（比如构造函数中的IContactService），需要确保AutoMapper能通过依赖注入（DI）解析构造参数：

• 首先确保依赖的服务已注册到DI容器（比如在Program.cs或ServiceLayerExtensions.cs中）：

  builder.Services.AddScoped<IContactService, ContactService>();
  

• 然后使用AutoMapper的DI兼容方式注册Profile，确保AutoMapper能自动解析构造函数参数：

  // 扫描包含Profile的程序集，AutoMapper会通过DI解析构造参数
  builder.Services.AddAutoMapper(typeof(ServiceLayerExtensions).Assembly);
  

  如果你使用的是旧版本AutoMapper（低于9.x），可能需要手动注册Profile：

  builder.Services.AddAutoMapper(mapperConfig =>
  {
      var serviceProvider = builder.Services.BuildServiceProvider();
      var contactService = serviceProvider.GetRequiredService<IContactService>();
      mapperConfig.AddProfile(new ContactMapper(contactService));
      // 同时添加其他Profile，比如AboutMapper
      mapperConfig.AddProfile<AboutMapper>();
  });
  

3. 验证配置加载 #

检查ServiceLayerExtensions.cs中的AutoMapper注册代码，确认是否扫描了包含ContactMapper的程序集。如果是通过AddAutoMapper(typeof(xxx))自动扫描，会加载该程序集下所有Profile类，包括ContactMapper，这时候必须保证所有Profile都能被正常实例化。

4. 调试验证 #

• 在Program.cs的AutoMapper注册代码处添加断点，跟踪Profile的加载过程，确认问题是否确实来自ContactMapper。
• 暂时注释掉ContactMapper的注册或从扫描范围中排除，测试是否能正常访问控制器方法，以此确认问题根源。

内容的提问来源于stack exchange，提问作者Console.WL