如何在C# Web API(OData V4)中配置多POST接口的控制器

一、在OData控制器中配置多个POST接口 #

要在StudentController中添加多个自定义POST接口，你需要结合[HttpPost]和[ODataRoute]属性指定唯一路由模板，确保每个接口的路由互不冲突。具体实现如下：

1. 编写自定义POST方法 #

在你的控制器中添加自定义POST方法，每个方法用[ODataRoute]指定相对于控制器前缀（student）的路由路径：

[Authorize]
[ODataRoutePrefix("student")]
public class StudentController : ApiODataControllerBase<StudentViewModel, Student>
{
    private readonly IStudentAppService _studentService;
    private readonly ISchoolAppService _schoolAppService;

    public StudentController(IStudentAppService studentService, ISchoolAppService schoolAppService)
    {
        _studentService = studentService;
        _schoolAppService = schoolAppService;
    }

    // 自定义POST：学生选课
    [HttpPost]
    [ODataRoute("EnrollInCourse")]
    public async Task<IActionResult> EnrollInCourse([FromBody] EnrollmentRequest request)
    {
        if (!ModelState.IsValid)
        {
            return BadRequest(ModelState);
        }
        await _studentService.EnrollStudentInCourseAsync(request.StudentId, request.CourseId);
        return Ok("选课成功");
    }

    // 自定义POST：分配学生到学校
    [HttpPost]
    [ODataRoute("AssignToSchool")]
    public async Task<IActionResult> AssignToSchool([FromBody] SchoolAssignmentRequest request)
    {
        if (!ModelState.IsValid)
        {
            return BadRequest(ModelState);
        }
        await _schoolAppService.AssignStudentToSchoolAsync(request.StudentId, request.SchoolId);
        return Ok("分配成功");
    }

    // 保留OData默认的POST（创建学生实体）
    public override async Task<IActionResult> Post([FromBody] StudentViewModel model)
    {
        // 你的默认创建逻辑
        return await base.Post(model);
    }
}

2. （可选）在Edm模型中注册自定义动作（符合OData规范） #

如果希望自定义接口完全遵循OData规范，可以在Edm模型构建时注册这些动作，这样OData元数据文档会包含接口定义：

private IEdmModel GetEdmModel()
{
    var builder = new ODataConventionModelBuilder();
    builder.EntitySet<StudentViewModel>("student");

    // 注册EnrollInCourse动作
    var enrollAction = builder.EntityType<StudentViewModel>().Collection.Action("EnrollInCourse");
    enrollAction.Parameter<EnrollmentRequest>("request");
    enrollAction.Returns<string>();

    // 注册AssignToSchool动作
    var assignAction = builder.EntityType<StudentViewModel>().Collection.Action("AssignToSchool");
    assignAction.Parameter<SchoolAssignmentRequest>("request");
    assignAction.Returns<string>();

    return builder.GetEdmModel();
}

二、解决"No non-OData HTTP route registered"错误 #

这个错误通常是因为项目只配置了OData路由，未注册常规Web API路由，或者调用接口时误用了非OData路由。修复方案如下：

1. 同时配置OData路由和常规API路由 #

根据你的.NET版本，在启动类中添加常规API路由配置：

.NET 6+（Program.cs）

var builder = WebApplication.CreateBuilder(args);

// 添加控制器服务并配置OData
builder.Services.AddControllers().AddOData(options =>
{
    options.Select().Filter().OrderBy().Expand().Count().SetMaxTop(100);
    options.AddRouteComponents("odata", GetEdmModel());
});

var app = builder.Build();

// 中间件顺序不能错
app.UseRouting();
app.UseAuthorization();

app.UseEndpoints(endpoints =>
{
    // 配置OData路由
    endpoints.MapODataRoute("odata", "odata", GetEdmModel());
    // 配置常规Web API路由（关键：解决非OData路由报错）
    endpoints.MapControllers();
});

app.Run();

.NET Framework（Startup.cs）

public void Configuration(IAppBuilder app)
{
    var config = new HttpConfiguration();

    // 配置OData路由
    config.MapODataServiceRoute("odata", "odata", GetEdmModel());
    // 启用属性路由
    config.MapHttpAttributeRoutes();
    // 配置默认API路由
    config.Routes.MapHttpRoute(
        name: "DefaultApi",
        routeTemplate: "api/{controller}/{id}",
        defaults: new { id = RouteParameter.Optional }
    );

    app.UseWebApi(config);
}

2. 正确调用接口 #

确保Postman调用时使用OData格式的路由：

• 默认创建学生：POST https://your-domain/odata/student
• 自定义选课接口：POST https://your-domain/odata/student/EnrollInCourse
• 自定义分配学校接口：POST https://your-domain/odata/student/AssignToSchool

如果误用了/api/student/EnrollInCourse这类非OData路由，就会触发"No non-OData HTTP route registered"错误。

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