Azure Functions模型绑定：能否像WebApi控制器一样自动绑定参数模型？

一、支持自动模型绑定 #

Azure Functions 完全支持类似Web API的自动模型绑定，不管是POST请求体还是查询参数，都能自动完成反序列化，核心依赖Functions runtime的内置绑定特性与序列化机制。

1. POST请求体自动绑定 #

直接在函数参数中声明自定义模型类，配合[HttpTrigger]特性，runtime会自动将JSON请求体反序列化为模型实例。

示例代码：

public class OrderRequest
{
    public int Id { get; set; }
    public string ProductName { get; set; }
    public decimal Amount { get; set; }
}

[FunctionName("CreateOrder")]
public static IActionResult Run(
    [HttpTrigger(AuthorizationLevel.Function, "post", Route = null)] OrderRequest request,
    ILogger log)
{
    log.LogInformation($"Received order: {request.ProductName}, Amount: {request.Amount}");
    return new OkObjectResult(request);
}

只要请求体是符合OrderRequest结构的JSON，runtime就会自动完成反序列化，无需手动处理。

2. 查询参数自动绑定 #

查询参数既可以直接绑定到简单类型，也可以绑定到自定义模型类（要求模型属性名与查询参数名一致）。

绑定到简单类型

[FunctionName("GetOrder")]
public static IActionResult Run(
    [HttpTrigger(AuthorizationLevel.Function, "get", Route = null)] HttpRequest req,
    int orderId, // 自动绑定查询参数?orderId=123
    ILogger log)
{
    log.LogInformation($"Fetching order with id: {orderId}");
    return new OkObjectResult(new { OrderId = orderId });
}

绑定到自定义模型

如果查询参数较多，可封装成模型类，Functions会自动将匹配的查询参数映射到模型属性：

public class OrderQuery
{
    public int Id { get; set; }
    public string Status { get; set; }
}

[FunctionName("SearchOrders")]
public static IActionResult Run(
    [HttpTrigger(AuthorizationLevel.Function, "get", Route = null)] OrderQuery query,
    ILogger log)
{
    log.LogInformation($"Searching orders: Id={query.Id}, Status={query.Status}");
    return new OkObjectResult(query);
}

请求URL如http://localhost:7071/api/SearchOrders?id=1&status=Completed时，query对象会自动填充对应的属性值。

二、手动实现方案（特殊场景） #

如果遇到复杂场景（比如自定义序列化规则、非JSON格式请求体等），可以手动处理反序列化：

1. 手动处理POST请求体 #

通过HttpRequest读取请求体，再用自定义序列化器（如Newtonsoft.Json、System.Text.Json）反序列化：

[FunctionName("CustomDeserializeOrder")]
public static async Task<IActionResult> Run(
    [HttpTrigger(AuthorizationLevel.Function, "post", Route = null)] HttpRequest req,
    ILogger log)
{
    string requestBody = await new StreamReader(req.Body).ReadToEndAsync();
    // 自定义反序列化，比如指定日期格式
    var order = JsonConvert.DeserializeObject<OrderRequest>(requestBody, new JsonSerializerSettings
    {
        DateFormatString = "yyyy-MM-dd"
    });
    return new OkObjectResult(order);
}

2. 手动处理查询参数 #

从HttpRequest的Query集合中读取参数，手动映射到模型：

[FunctionName("ManualQueryBinding")]
public static IActionResult Run(
    [HttpTrigger(AuthorizationLevel.Function, "get", Route = null)] HttpRequest req,
    ILogger log)
{
    var query = new OrderQuery
    {
        Id = int.TryParse(req.Query["id"], out var id) ? id : 0,
        Status = req.Query["status"]
    };
    log.LogInformation($"Manual query: Id={query.Id}, Status={query.Status}");
    return new OkObjectResult(query);
}

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