.NET 6添加API控制器报错：无法解析DbContextOptions服务

核心错误原因 #

DI容器无法解析DbContextOptions<OdeToFood.Data.OdeToFoodDbContext>，导致无法激活你的数据上下文类，以下是针对性排查步骤：

1. 验证连接字符串配置 #

确保appsettings.json中存在正确的连接字符串节点，键名必须和Program.cs中调用的OdeToFoodDb完全一致（大小写敏感）：

{
  "ConnectionStrings": {
    "OdeToFoodDb": "Server=(localdb)\\mssqllocaldb;Database=OdeToFoodDb;Trusted_Connection=True;MultipleActiveResultSets=true"
  }
}

如果使用远程SQL Server，替换为对应的连接字符串格式。

2. 检查数据上下文类的可访问性与命名空间 #

• 确认OdeToFoodDbContext类是public修饰的，DI容器只能解析公共类。
• 核对类的命名空间是否为OdeToFood.Data，必须和错误提示中的命名空间完全匹配，避免拼写错误。

3. 统一NuGet包版本 #

6.0.11和6.0.12的小版本差异虽不必然引发此问题，但版本不一致可能导致潜在兼容性问题，建议统一所有EF Core相关包的版本：

• 右键项目 → 管理NuGet程序包
• 筛选所有Microsoft.EntityFrameworkCore.*开头的包，将版本统一为6.0.12或6.0.11，点击安装完成更新。

4. 确认Program.cs中服务注册顺序 #

确保AddDbContextPool的注册代码在builder.Build()之前，且位于控制器注册代码之前（.NET6默认模板中AddControllers()在DbContext注册之后即可），正确示例：

var builder = WebApplication.CreateBuilder(args);

// 先注册数据上下文
builder.Services.AddDbContextPool<OdeToFoodDbContext>(options =>
{
    options.UseSqlServer(builder.Configuration.GetConnectionString("OdeToFoodDb"));
});

// 再注册控制器服务
builder.Services.AddControllers();

var app = builder.Build();

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

app.MapControllers();

app.Run();

5. 验证控制器的依赖注入方式 #

确保API控制器通过构造函数注入OdeToFoodDbContext，禁止手动实例化：

[ApiController]
[Route("api/[controller]")]
public class RestaurantsController : ControllerBase
{
    private readonly OdeToFoodDbContext _dbContext;

    // 构造函数注入，由DI容器自动实例化
    public RestaurantsController(OdeToFoodDbContext dbContext)
    {
        _dbContext = dbContext;
    }

    // 后续API动作方法...
}

6. 清理重建项目 #

• 右键项目 → 清理
• 手动删除项目目录下的bin和obj文件夹
• 右键项目 → 生成，重新编译项目

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