OData Web API动作接收String与Delta<T>参数异常求助

1. 先确认请求的Content-Type #

OData对请求头的媒体类型要求很严，必须用application/json;odata.metadata=minimal或者application/json;odata.metadata=none，别只传application/json。很多工具默认的Content-Type会让Delta解析器认不出属性，直接抛异常。

2. 检查参数的绑定方式，别犯多个FromBody的错 #

OData动作默认只能有一个请求体参数，如果你同时用两个[FromBody]（一个string，一个Delta），这本身就不符合规范，会导致Delta解析异常。

• 要么把string参数放到URL里，标记为[FromUri]：

  [HttpPost]
  [ODataRoute("MyAction(param1={param1})")]
  public IActionResult MyAction([FromUri] string param1, [FromBody] Delta<MyEntity> param2)
  

• 要么把两个参数封装成一个复杂类型，统一用[FromBody]接收：

  public class ActionInput
  {
      public string Param1 { get; set; }
      public Delta<MyEntity> EntityChanges { get; set; }
  }
  
  [HttpPost]
  [ODataRoute("MyAction")]
  public IActionResult MyAction([FromBody] ActionInput input)
  

3. 核对实体属性的配置和大小写 #

• 先检查实体T里的目标属性有没有被标记为[ReadOnly(true)]，或者在OData模型构建时被设为不可更新，这种属性Delta是不认的。
• 再核对请求体里的属性名和实体类里的大小写完全一致，OData默认区分大小写，比如实体里是FullName，请求里写fullname绝对会报错。

4. 确认OData模型里实体类型已正确注册 #

在Startup/Program.cs里构建OData模型时，要确保实体T被完整注册，所有需要更新的属性都被包含：

builder.EntitySet<MyEntity>("MyEntities");
// 如果有特殊属性需要手动配置，别漏了
builder.EntityType<MyEntity>().Property(e => e.FullName).IsRequired();

要是实体有继承关系，父类的属性也要在模型里配置好，不然Delta也识别不了。

5. 别给请求体加多余嵌套 #

如果用复杂类型接收参数，请求体的结构要和类对应，别乱嵌套。比如上面的ActionInput对应的请求体应该是：

{
  "Param1": "测试字符串",
  "EntityChanges": {
    "FullName": "新名称",
    "Email": "new@test.com"
  }
}

如果是URL传string，请求体直接放Delta的属性就行，别套额外的层级。

6. 检查动作的路由注册是否正确 #

在OData模型构建时，要把动作正确绑定到实体或集合上：

builder.EntityType<MyEntity>().Action("MyAction")
    .Parameter<string>("param1")
    .Parameter<Delta<MyEntity>>("param2")
    .Returns<IActionResult>();

或者在控制器方法上用[ODataRoute]指定正确的路由模板，避免路由不匹配导致参数解析失败。

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