Azure Functions 3中能否使用[FromBody]特性实现模型绑定？

当然可以！Azure Functions 3基于ASP.NET Core 3.x构建，完全支持使用[FromBody]特性来实现POST请求的模型绑定，用法和你熟悉的ASP.NET MVC/Web API几乎一致，用起来一样便捷。

下面是具体的使用步骤和示例：

• 前提确认：确保你的Azure Functions项目目标框架是.NET Core 3.x，且运行时版本设置为3.x（可以在host.json里查看或修改："version": "3.0"）。

• 定义请求模型：先创建一个用于接收POST数据的模型类，还可以添加数据注解来做基础验证：

  public class UserRequest
  {
      [Required(ErrorMessage = "用户名不能为空")]
      public string Username { get; set; }
      
      [Range(18, 100, ErrorMessage = "年龄必须在18到100之间")]
      public int Age { get; set; }
      
      public string Email { get; set; }
  }
  

• 在函数中使用[FromBody]：在Http触发的函数参数里，直接给模型参数加上[FromBody]标记，Azure Functions会自动帮你完成JSON到模型的绑定：

  [FunctionName("CreateUserEndpoint")]
  public static IActionResult Run(
      [HttpTrigger(AuthorizationLevel.Function, "post", Route = "users")] HttpRequest req,
      [FromBody] UserRequest userRequest,
      ILogger log)
  {
      log.LogInformation("收到创建用户的POST请求");
  
      // 检查模型是否绑定成功（比如请求体格式错误时会为null）
      if (userRequest == null)
      {
          return new BadRequestObjectResult("请求体格式无效，请提供正确的JSON数据");
      }
  
      // 利用数据注解做验证（需要注入ActionContext来获取ModelState）
      var actionContext = new ActionContext { HttpContext = req.HttpContext };
      var modelState = actionContext.ModelState;
      if (!modelState.IsValid)
      {
          var errors = modelState.SelectMany(x => x.Value.Errors)
                                 .Select(e => e.ErrorMessage)
                                 .ToList();
          return new BadRequestObjectResult(errors);
      }
  
      // 这里写你的业务逻辑，比如保存用户到数据库
      // ...
  
      return new OkObjectResult($"用户 {userRequest.Username} 创建成功！");
  }
  

• 注意事项：

  • 发送请求时，务必将Content-Type设置为application/json，否则模型绑定会失败，userRequest会为null。
  • 如果你的请求体是表单数据（而非JSON），那[FromBody]就不适用了，需要用[Form]或者直接从HttpRequest中读取表单数据。

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