VB.NET WebService复杂JSON处理及RestApi POST数据绑定问题

我之前在VB.NET开发REST API时也碰到过这种复杂嵌套结构绑定失效的问题，多半是类结构和JSON不匹配、序列化配置没做好，或者端点参数绑定有疏漏。给你几个实用的排查和解决方向：

首先要确保你的VB.NET数据类层级、属性名称和提交的JSON完全对应。举个例子，如果你的请求JSON是这样的：

{
  "UserInfo": {
    "Name": {
      "First": "John",
      "Last": "Doe"
    },
    "Address": {
      "AddressLine1": "123 Main St",
      "City": "New York"
    }
  }
}

那对应的VB.NET类必须按相同层级定义，而且要确保所有类和属性都是Public的：

Public Class RootRequest
    Public Property UserInfo As UserInfo
End Class

Public Class UserInfo
    Public Property Name As NameDetail
    Public Property Address As AddressDetail
End Class

Public Class NameDetail
    Public Property First As String
    Public Property Last As String
End Class

Public Class AddressDetail
    Public Property AddressLine1 As String
    Public Property City As String
End Class

如果JSON的键名和类属性名大小写不一致（比如JSON是first而类里是First），要给属性加上序列化特性指定映射。比如用Newtonsoft.Json的话：<JsonProperty("first")>，用System.Text.Json的话：<JsonPropertyName("first")>

VB.NET常用的JSON序列化库有Newtonsoft.Json（Json.NET）和System.Text.Json，两者的默认行为有差异：

• 如果你用System.Text.Json，默认对大小写敏感，而且要求类必须有无参构造函数。可以通过配置放宽限制：

Dim serializeOptions As New JsonSerializerOptions With {
    .PropertyNameCaseInsensitive = True, ' 忽略大小写匹配
    .IgnoreNullValues = True ' 忽略JSON中的null值
}
Dim requestObj = JsonSerializer.Deserialize(Of RootRequest)(requestBody, serializeOptions)

• 如果你用Newtonsoft.Json，默认大小写不敏感，但可以配置忽略多余字段避免报错：

Dim settings As New JsonSerializerSettings With {
    .MissingMemberHandling = MissingMemberHandling.Ignore,
    .NullValueHandling = NullValueHandling.Ignore
}
Dim requestObj = JsonConvert.DeserializeObject(Of RootRequest)(requestBody, settings)

别忽略最基础的细节：

• 确保Postman请求的Content-Type头设置为application/json，否则API不会按JSON格式解析请求体。
• 用本地的JSON校验工具（比如VS自带的JSON编辑器）检查你的请求JSON是否合法，有没有多余逗号、引号不匹配等语法错误。

如果绑定后对象是null或者部分属性为空，一定要捕获反序列化的异常，看具体错误信息：

Try
    Dim requestObj = JsonSerializer.Deserialize(Of RootRequest)(requestBody)
    ' 业务逻辑处理
Catch ex As JsonException
    ' 打印或记录异常信息，比如"无法将字符串转换为Integer"、"找不到属性XXX"
    Console.WriteLine($"反序列化失败：{ex.Message}")
End Try

异常信息会直接告诉你问题根源，比盲目排查高效得多。

如果是ASP.NET Core Web API，控制器方法的参数必须加上[FromBody]标记，否则框架不会从请求体中解析JSON：

<ApiController>
<Route("api/users")>
Public Class UsersController
    <HttpPost>
    Public Function CreateUser(<FromBody> request As RootRequest) As IActionResult
        If ModelState.IsValid Then
            ' 处理请求
            Return Ok("创建成功")
        Else
            Return BadRequest(ModelState)
        End If
    End Function
End Class

另外，也可以通过ModelState.IsValid检查绑定是否有验证错误，方便定位问题。

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