.NET 8中EF Core主构造函数注入DbContext时出现Null异常问题求助

看起来你在.NET 8控制器中使用主构造函数注入DataContext时遇到了null异常，但普通构造函数却能正常工作，我来帮你排查可能的原因并给出解决方案：

一、先排查代码中的明显问题 #

1. 修正DataContext的笔误 #

你的DataContext代码中有一个拼写错误：

// 错误：DbTSet → 正确：DbSet
public DbTSet<Lesson> Lessons { get; set; }

这个编译错误会导致DataContext无法正常实例化，即使你在普通构造函数场景下能运行，也大概率是实际代码中已经修正了这个笔误，建议先确认所有实体集的定义正确。

二、分析依赖注入的核心问题 #

可能的原因及对应解决方案 #

1. EF Core包版本与.NET 8不匹配

.NET 8的主构造函数注入要求EF Core相关包必须是8.x版本，如果混用了7.x或更早版本，会导致注入异常。

检查并修正.csproj中的包版本：

<PackageReference Include="Microsoft.EntityFrameworkCore" Version="8.0.0" />
<PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="8.0.0" />
<PackageReference Include="Microsoft.EntityFrameworkCore.Tools" Version="8.0.0">
  <PrivateAssets>all</PrivateAssets>
  <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
</PackageReference>

2. 服务注册顺序问题

你的Program.cs中AddControllers在AddDbContext之前注册，虽然理论上顺序不影响，但部分场景下会导致控制器激活时无法解析后续注册的服务。

调整注册顺序，先注册DbContext：

// 先注册DataContext
builder.Services.AddDbContext<DataContext>(options =>
    options.UseSqlServer(builder.Configuration.GetConnectionString("DefaultConnection"))
);

// 再注册控制器及其他服务
builder.Services.AddControllers();
builder.Services.AddIdentityService(builder.Configuration);
builder.Services.AddAutoMapper(AppDomain.CurrentDomain.GetAssemblies());

3. 强制将控制器注册为DI服务

.NET 8默认支持控制器主构造函数注入，但如果存在自定义控制器激活器或配置冲突，可强制将控制器注册为DI服务来解决：

在Program.cs中修改AddControllers配置：

builder.Services.AddControllers()
    .AddControllersAsServices(); // 将控制器注册为DI服务，使用标准注入逻辑

4. 验证依赖注入的正确性

在启动时添加依赖验证代码，提前发现注入失败的问题，避免到请求时才暴露null异常：

var app = builder.Build();

// 新增：验证依赖注入是否正常
using var scope = app.Services.CreateScope();
var serviceProvider = scope.ServiceProvider;
try
{
    var context = serviceProvider.GetRequiredService<DataContext>();
    var testController = serviceProvider.GetRequiredService<SubjectsController>();
    var logger = serviceProvider.GetRequiredService<ILogger<Program>>();
    logger.LogInformation("所有依赖项解析成功");
}
catch (Exception ex)
{
    var logger = serviceProvider.GetRequiredService<ILogger<Program>>();
    logger.LogError(ex, "依赖项解析失败：{Message}", ex.Message);
    throw; // 启动失败，终止程序
}

// 后续中间件配置
app.UseApplicationIdentity();
app.MapControllers();
// ...

5. 排查自定义控制器激活器影响

如果你在AddIdentityService或其他配置中使用了自定义IControllerActivator，请确保它支持.NET 8的主构造函数注入逻辑，或者暂时移除自定义激活器进行测试。

三、快速测试验证 #

创建一个极简测试控制器，排除业务逻辑干扰，验证主构造函数注入是否正常：

[ApiController]
[Route("api/test")]
public class TestController(DataContext context) : ControllerBase
{
    [HttpGet]
    public async Task<IActionResult> TestDbContext()
    {
        if (context == null) return BadRequest("DataContext is null");
        var studentCount = await context.Students.CountAsync();
        return Ok($"学生总数：{studentCount}");
    }
}

如果这个测试控制器能正常返回数据，说明问题出在SubjectsController的业务代码或属性配置中；如果依然返回null，问题则在全局DI配置层面。

备注：内容来源于stack exchange，提问作者Shinchoku