Asp.NET Core实现接收PHP风格嵌套表单数据的Webhook及模型绑定

当然有！ASP.NET Core的原生模型绑定就完美支持这种PHP风格的嵌套application/x-www-form-urlencoded数据，几乎不需要额外配置就能直接映射到你的C# POCO类，代码简洁又优雅。

核心原理 #

ASP.NET Core的表单模型绑定器天生就能识别user[name]、order[items][0][id]这种PHP风格的嵌套字段命名，会自动将它们映射到对应层级的POCO属性中——完全不需要你手动解析字符串或者写自定义绑定逻辑。

步骤1：定义匹配嵌套结构的POCO类 #

假设你的Webhook请求体格式类似这样（对应PHP的$_POST嵌套数组）：

user[name]=Alice&user[age]=30&order[number]=ORD123&order[products][0][id]=1&order[products][0][name]=Laptop&order[products][1][id]=2&order[products][1][name]=Mouse

你只需要定义结构完全对应的C#类：

public class WebhookRequest
{
    public User User { get; set; }
    public Order Order { get; set; }
}

public class User
{
    public string Name { get; set; }
    public int Age { get; set; }
}

public class Order
{
    public string Number { get; set; }
    public List<Product> Products { get; set; }
}

public class Product
{
    public int Id { get; set; }
    public string Name { get; set; }
}

步骤2：编写Webhook控制器Action #

在控制器里直接用[FromForm]属性（POST请求下也可以省略，但显式声明更清晰）接收POCO对象，模型绑定会自动完成：

[ApiController]
[Route("api/webhook")]
public class WebhookController : ControllerBase
{
    [HttpPost]
    public IActionResult ReceiveWebhook([FromForm] WebhookRequest request)
    {
        // 直接使用绑定好的request对象即可
        if (!ModelState.IsValid)
        {
            return BadRequest(ModelState);
        }

        // 这里写你的业务逻辑，比如处理用户信息、订单数据
        return Ok("Webhook received and processed successfully");
    }
}

注意事项 #

• Content-Type必须正确：确保请求的Content-Type头是application/x-www-form-urlencoded，否则模型绑定器不会处理该请求。
• 处理可选字段：如果某些字段可能缺失，建议在POCO中使用可空类型（比如int? Age），避免因字段缺失导致模型验证失败。
• 字段名映射：如果PHP端的字段名和C#的命名规范不一致（比如下划线命名user_email），可以用[BindProperty(Name = "user_email")]属性指定对应关系：

  public class User
  {
      [BindProperty(Name = "user_email")]
      public string Email { get; set; }
  }
  

这种方式完全利用ASP.NET Core的原生能力，代码量极少，且符合框架的设计规范，是处理这类场景最优雅的方案。

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