.NET6升级OData v8过程中依赖注入配置报错求助

问题根因 #

OData v8 相对于v7版本存在大量破坏性API变更，你遇到的两个编译错误均为直接沿用v7旧写法导致，非EDM模式下无需复杂配置，按以下步骤调整即可正常运行。 #

1. 修正服务层OData注册逻辑 #

你当前的配置存在两个问题：一是重复注册控制器相关服务，二是OData功能配置位置错误。将原有SetupOData扩展方法替换为以下代码：

public static void SetupOData(this IServiceCollection services)
{
    services.AddControllers()
        .AddOData(options =>
        {
            // 非EDM模式直接开启查询能力，无需提前配置EDM模型
            options.Select().Filter().OrderBy().Count();
            options.RouteOptions.EnableControllerNameCaseInsensitive = true;
        });

    // Swagger兼容配置可直接保留，无需调整
    services.AddMvcCore(options =>
    {
        foreach (OutputFormatter outputFormatter in options.OutputFormatters.OfType<OutputFormatter>().Where(x => x.SupportedMediaTypes.Count == 0))
        {
            outputFormatter.SupportedMediaTypes.Add(new MediaTypeHeaderValue("application/prs.odatatestxx-odata"));
        }

        foreach (InputFormatter inputFormatter in options.InputFormatters.OfType<InputFormatter>().Where(x => x.SupportedMediaTypes.Count == 0))
        {
            inputFormatter.SupportedMediaTypes.Add(new MediaTypeHeaderValue("application/prs.odatatestxx-odata"));
        }
    });
}

注意：如果你的项目其他位置已经调用过AddControllers()，不要重复调用，直接把.AddOData()链式追加到原有AddControllers()语句后即可。

2. 清理端点路由中的无效OData配置 #

OData v8 已完全移除EnableDependencyInjection()扩展方法，原v7版本中写在UseEndpoints里的Filter()/Select()/Count()/OrderBy()等查询能力配置，也全部迁移到了服务注册阶段的AddOData委托中。直接将端点配置里的OData相关代码全部删除，仅保留控制器映射即可：

app.UseEndpoints(endpointRouteBuilder =>
{
    endpointRouteBuilder.MapControllers();
    // 原有OData相关配置代码全部删除
});

3. 接口层适配 #

非EDM模式下不需要给控制器加OData专属路由特性，正常沿用Web API路由即可，需要支持OData查询的接口直接返回IQueryable类型，标记[EnableQuery]特性：

[ApiController]
[Route("api/[controller]")]
public class TestController : ControllerBase
{
    private readonly DbContext _dbContext;
    public TestController(DbContext dbContext)
    {
        _dbContext = dbContext;
    }

    [HttpGet]
    [EnableQuery]
    public IQueryable<TestEntity> GetList()
    {
        return _dbContext.Set<TestEntity>().AsQueryable();
    }
}

常见避坑提示 #

• 清理项目中所有旧版Microsoft.AspNet.OData相关包引用，仅保留Microsoft.AspNetCore.OData 8.x稳定版，避免多版本混装引发类型加载异常
• 如果升级后Swagger无法正常加载接口列表，将Swashbuckle.AspNetCore包升级到6.0及以上版本，低版本无法兼容OData v8的格式化器规则
• 非EDM模式不需要配置EDM模型、不需要调用MapODataRoute指定OData专属路由，所有接口沿用原有Web API路由规则即可正常使用OData查询能力

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