ASP.NET Core服务构造失败求助：DbContext实现类无法转换为服务类型

核心错误 #

启动应用时抛出System.AggregateException，包含两个关键问题：

• LearnMUSIC.Data.AppDbContext无法转换为服务类型LearnMUSIC.Core.Application._Interfaces.IAppDbContext
• MediatR的CreateSongSheetCommandHandler激活时无法解析LearnMUSIC.Interfaces.IAppDbContext服务

错误堆栈信息 #

System.AggregateException
  HResult=0x80131500
  Message=Some services are not able to be constructed (Error while validating the service descriptor 'ServiceType: LearnMUSIC.Core.Application._Interfaces.IAppDbContext Lifetime: Scoped ImplementationType: LearnMUSIC.Data.AppDbContext': Implementation type 'LearnMUSIC.Data.AppDbContext' can't be converted to service type 'LearnMUSIC.Core.Application._Interfaces.IAppDbContext') (Error while validating the service descriptor 'ServiceType: MediatR.IRequestHandler`2[LearnMUSIC.Application.SongSheets.Commands.CreateSongSheet.CreateSongSheetCommand,System.Int64] Lifetime: Transient ImplementationType: LearnMUSIC.Application.SongSheets.Commands.CreateSongSheet.CreateSongSheetCommandHandler': Unable to resolve service for type 'LearnMUSIC.Interfaces.IAppDbContext' while attempting to activate 'LearnMUSIC.Application.SongSheets.Commands.CreateSongSheet.CreateSongSheetCommandHandler'.)
  Source=Microsoft.Extensions.DependencyInjection
  StackTrace:
   at Microsoft.Extensions.DependencyInjection.ServiceProvider..ctor(ICollection`1 serviceDescriptors, ServiceProviderOptions options)
   at Microsoft.Extensions.DependencyInjection.ServiceCollectionContainerBuilderExtensions.BuildServiceProvider(IServiceCollection services, ServiceProviderOptions options)
   at Microsoft.Extensions.Hosting.Internal.ServiceFactoryAdapter`1.CreateServiceProvider(Object containerBuilder)
   at Microsoft.Extensions.Hosting.HostBuilder.CreateServiceProvider()
   at Microsoft.Extensions.Hosting.HostBuilder.Build()
   at LearnMUSIC.Program.Main(String[] args) in D:\Importants\Programming 101\Web Personal Projects\LearnMUSIC\LearnMUSIC\Program.cs:line 16

  This exception was originally thrown at this call stack:
    [External Code]

Inner Exception 1:
InvalidOperationException: Error while validating the service descriptor 'ServiceType: LearnMUSIC.Core.Application._Interfaces.IAppDbContext Lifetime: Scoped ImplementationType: LearnMUSIC.Data.AppDbContext': Implementation type 'LearnMUSIC.Data.AppDbContext' can't be converted to service type 'LearnMUSIC.Core.Application._Interfaces.IAppDbContext'

Inner Exception 2:
ArgumentException: Implementation type 'LearnMUSIC.Data.AppDbContext' can't be converted to service type 'LearnMUSIC.Core.Application._Interfaces.IAppDbContext'

相关代码片段 #

Startup.cs #

namespace LearnMUSIC
{
  public class Startup
  {
    public Startup(IConfiguration configuration)
    {
      Configuration = configuration;
    }

    public IConfiguration Configuration { get; }

    // This method gets called by the runtime. Use this method to add services to the container.
    public void ConfigureServices(IServiceCollection services)
    {
      services.AddControllers();
      services.AddCors();

      services.AddAuthentication(JwtBearerDefaults.AuthenticationScheme)
    .AddJwtBearer(JwtBearerDefaults.AuthenticationScheme,
        options => Configuration.Bind("JwtSettings", options))
    .AddCookie(CookieAuthenticationDefaults.AuthenticationScheme,
        options => Configuration.Bind("CookieSettings", options));

      services.AddEndpointsApiExplorer();
      services.AddSwaggerGen(c =>
      {
        c.SwaggerDoc("v1", new OpenApiInfo { Title = "WebAPIv5", Version = "v1" });
      });
      services.AddDbContext<AppDbContext>(options =>
          options.UseSqlServer(Configuration.GetConnectionString("LearnMUSICDbConnectionString"))
                  .UseLazyLoadingProxies());

      //services.AddHostedService<MembershipStatusUpdateService>();

      // Configure DI
      this.ConfigureDI(services);
    }

    // This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
    public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
    {
      if (env.IsDevelopment())
      {
        app.UseDeveloperExceptionPage();
        app.UseSwagger();
        app.UseSwaggerUI(c => c.SwaggerEndpoint("/swagger/v1/swagger.json", "WebAPIv5 v1"));
      }

      app.UseHttpsRedirection();

      app.UseRouting();

      app.UseCors(policy => policy.AllowAnyHeader().AllowAnyMethod().WithOrigins("http://localhost:4200"));

      //app.UseAuthentication();

      app.UseAuthorization();

      app.UseEndpoints(endpoints =>
      {
        endpoints.MapControllers();
      });
    }

    private void ConfigureDI(IServiceCollection services)
    {
      //DbContext
      //services.AddScoped(typeof(IAppDbContext), typeof(AppDbContext));
      services.AddScoped(typeof(IAppDbContext), typeof(AppDbContext));

      services.AddMediatR(typeof(Startup).GetTypeInfo());

      // AutoMapper
      services.AddAutoMapper(typeof(AutoMapperProfile));

      // Fluent Validation
      services.AddTransient(typeof(IPipelineBehavior<,>), typeof(RequestValidationBehavior<,>));
    }
  }
}

AppDbContext.cs #

namespace LearnMUSIC.Data
{
    public class AppDbContext : DbContext, IAppDbContext
    {
        public DbSet<SongSheet> SongSheets { get; set; }

        public AppDbContext() { }

        public AppDbContext(DbContextOptions options) : base(options)
        {
        }

        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
        {
          base.OnConfiguring(optionsBuilder);
        }

        protected override void OnModelCreating(ModelBuilder modelBuilder)
        {
          base.OnModelCreating(modelBuilder);

          //modelBuilder.RemovePluralizingTableNameConvention();

          modelBuilder.ApplyConfigurationsFromAssembly(typeof(AppDbContext).Assembly);
        }
  }
}

IAppDbContext.cs #

namespace LearnMUSIC.Interfaces
{
    public interface IAppDbContext
    {
        DbSet<SongSheet> SongSheets { get; set; }

        EntityEntry Remove(object entity);

        void RemoveRange(IEnumerable<object> entities);

        int SaveChanges();

        Task<int> SaveChangesAsync(CancellationToken cancellationToken);
    }
}

问题根源与解决步骤 #

问题根源 #

1. 命名空间冲突：错误日志中提到的服务类型是LearnMUSIC.Core.Application._Interfaces.IAppDbContext，但实际定义的接口位于LearnMUSIC.Interfaces命名空间下，说明项目中存在重复的IAppDbContext接口，导致DI注册时引用了错误的接口类型。
2. DI注册不匹配：MediatR处理器依赖的是LearnMUSIC.Interfaces.IAppDbContext，若DI容器中注册的是其他命名空间的接口，就会出现无法解析的问题。

解决步骤 #

1. 清理重复接口：检查项目中是否存在LearnMUSIC.Core.Application._Interfaces.IAppDbContext这个重复接口，若存在则删除，确保整个项目只有LearnMUSIC.Interfaces.IAppDbContext这一个定义。
2. 确认命名空间引用：在Startup.cs文件顶部添加正确的命名空间引用：

   using LearnMUSIC.Interfaces;
   

   确保ConfigureDI方法中注册的IAppDbContext来自LearnMUSIC.Interfaces。
3. 验证DbContext实现：确认AppDbContext确实实现了LearnMUSIC.Interfaces.IAppDbContext（当前代码已实现，需检查引用是否正确）。
4. 清理并重建项目：清理项目的bin/obj目录，重新生成解决方案，避免缓存导致的类型不匹配问题。

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