.NET 5.0升级到.NET 7.0后OData路由空参数异常求助

问题根源 #

.NET7的ASP.NET Core路由模型和.NET5差异较大，OData 7.5.7对.NET7的兼容有限，加上UseMvc在.NET6+已处于兼容模式，容易引发参数null异常；另外异常提示的Arg_ParamName_Name大概率是Edm模型中存在未指定名称的实体集，或者GetEdmModel方法返回了null。

方案一：基于现有OData 7.5.7版本修复 #

1. 先排查GetEdmModel方法 #

调试确认该方法返回的IEdmModel不为null，且所有EntitySet都指定了有效名称，示例：

private IEdmModel GetEdmModel(IServiceProvider serviceProvider)
{
    var builder = new ODataConventionModelBuilder(serviceProvider);
    // 确保EntitySet的名称不为空字符串或null
    builder.EntitySet<Product>("Products"); 
    builder.EntitySet<Order>("Orders");
    return builder.GetEdmModel();
}

2. 替换过时的UseMvc路由配置 #

.NET7推荐使用端点路由模式，修改Startup.cs：

• 在ConfigureServices中注册OData服务：

public void ConfigureServices(IServiceCollection services)
{
    services.AddControllers()
            .AddOData(options =>
            {
                // 启用需要的OData功能
                options.Select().Filter().OrderBy().Expand().Count().SetMaxTop(100);
                // 注册OData路由组件
                options.AddRouteComponents("odata", GetEdmModel(services.BuildServiceProvider()));
            });
}

• 在Configure中使用端点路由替代UseMvc：

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    // 其他中间件（如异常处理、静态文件等）
    app.UseRouting();
    app.UseAuthorization();

    app.UseEndpoints(endpoints =>
    {
        endpoints.MapControllers();
        // 映射OData路由
        endpoints.MapODataRoute("odata", "odata", GetEdmModel(app.ApplicationServices));
    });
}

方案二：升级到OData 8.x适配.NET7 #

如果要彻底适配.NET7，建议升级到OData 8.x版本（完全支持.NET6+），步骤如下：

1. 清理旧包并安装新版本 #

卸载所有旧的Microsoft.AspNetCore.OData包，安装最新版：

Install-Package Microsoft.AspNetCore.OData -Version 8.2.3

2. 修改Edm模型构建（API有变化） #

OData 8.x对模型构建的API做了调整，示例：

private IEdmModel GetEdmModel()
{
    var builder = new ODataConventionModelBuilder();
    builder.EntitySet<Product>("Products");
    // 若需要自定义实体属性，使用EntityTypeConfiguration
    builder.EntityType<Product>().HasKey(p => p.Id);
    return builder.GetEdmModel();
}

3. 更新路由配置 #

// ConfigureServices中
services.AddControllers()
        .AddOData(options =>
        {
            options.EnableQueryFeatures(100);
            options.AddRouteComponents("odata", GetEdmModel());
        });

// Configure中
app.UseEndpoints(endpoints =>
{
    endpoints.MapControllers();
    // OData 8.x也支持直接在AddRouteComponents中配置路由，这里保持端点映射也可
    endpoints.MapODataRoute("odata", "odata", GetEdmModel());
});

关键排查点 #

• 确认GetEdmModel返回的模型不为null，且所有实体集/实体类型都有有效名称；
• 若升级OData 8.x后出现引用问题，检查项目中是否有其他依赖旧OData包的类库，需同步升级或清理冲突引用。

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