在AspNetCore中绑定未知JSON到JsonObject的方法及绑定失败排查

首先，你遇到的错误是因为ASP.NET Core默认使用的System.Text.Json序列化器无法直接将JSON对象绑定到JsonObject类型（或者你可能误用了不同JSON库中的JsonObject类型），绑定器错误地试图把你的JSON对象当作集合（IEnumerable）来处理，才会抛出这个异常。

下面给你几种可行的解决方案，按需选择：

方案1：使用System.Text.Json内置的JsonObject（.NET 6+） #

如果你的项目是.NET 6及以上版本，直接使用System.Text.Json.Nodes.JsonObject作为参数即可，不需要额外配置，注意要引用正确的命名空间：

using System.Text.Json.Nodes;

[HttpPost]
public IActionResult RetrieveData([FromBody] JsonObject request)
{
    // 示例：读取JSON中的属性
    var userName = request["userName"]?.GetValue<string>();
    var age = request["age"]?.GetValue<int>();
    
    // 处理逻辑
    return Ok();
}

注意：确保你的请求JSON是一个对象（而非数组），比如正确的请求体应该是：

{
  "userName": "John",
  "age": 30
}

如果你的请求是JSON数组，需要改用JsonArray作为参数类型。

方案2：用dynamic快速处理未知JSON #

如果不需要编译时类型检查，只是快速处理任意JSON，直接用dynamic类型最省事：

[HttpPost]
public IActionResult RetrieveData([FromBody] dynamic request)
{
    // 直接访问JSON属性
    var id = request.id;
    var tags = request.tags;
    
    return Ok();
}

这种方式简单直接，但缺点是没有类型安全，拼写错误要到运行时才会发现。

方案3：使用Newtonsoft.Json的JObject（Json.NET） #

如果你更习惯用Newtonsoft.Json，需要先配置ASP.NET Core切换到这个序列化器：

1. 安装NuGet包：Microsoft.AspNetCore.Mvc.NewtonsoftJson
2. 在Program.cs中添加配置：

var builder = WebApplication.CreateBuilder(args);

// 添加控制器并配置使用Newtonsoft.Json
builder.Services.AddControllers().AddNewtonsoftJson();

var app = builder.Build();

// 其他中间件配置...
app.MapControllers();
app.Run();

之后就可以直接用JObject作为参数：

using Newtonsoft.Json.Linq;

[HttpPost]
public IActionResult RetrieveData([FromBody] JObject request)
{
    // 读取属性的示例
    var email = request["email"]?.ToString();
    var isActive = request["isActive"]?.ToObject<bool>();
    
    return Ok();
}

方案4：用Dictionary<string, object>绑定扁平JSON #

如果你的JSON结构是简单的键值对，用Dictionary<string, object>也是个不错的选择，它有编译时类型检查：

[HttpPost]
public IActionResult RetrieveData([FromBody] Dictionary<string, object> request)
{
    if (request.TryGetValue("productId", out var productIdObj))
    {
        var productId = Convert.ToInt32(productIdObj);
        // 处理逻辑
    }
    
    return Ok();
}

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