如何在Azure Functions的POST请求Body中传递复杂值

一、复杂请求体是否需要创建类？怎么建模？ #

不是必须，但非常建议创建嵌套类来对应这个复杂结构，强类型带来的好处远大于这点编码成本：

• 编译时就能检查字段类型、拼写错误，避免运行时才发现问题
• 自动序列化/反序列化，不用手动拼接JSON或者解析
• 代码可读性、维护性更高，后续修改结构一目了然

针对你给出的JSON结构，对应的C#类可以这么写：

public class FamilyRequest
{
    public FamilyHierarchy familyHierarchy { get; set; }
    public int pageSize { get; set; }
}

public class FamilyHierarchy
{
    public FamilyMembers familyMembers { get; set; }
    public string familyGroup { get; set; }
}

public class FamilyMembers
{
    public List<string> memberIds { get; set; }
    public int age { get; set; }
    public string marriageDate { get; set; }
}

如果某些字段是可选的，可以给属性加上?标记为可空类型，比如public int? age { get; set; }。

二、关于FromBody的使用疑问 #

你当前的方法签名用的是HttpRequest req，这种情况下需要手动读取请求体内容再反序列化：

[FunctionName("GetFamilyInfo")]
public static async Task<IActionResult> GetFamilyInfo([HttpTrigger(AuthorizationLevel.Function, "post", Route = "families/")] HttpRequest req, ILogger log)
{
    string requestBody = await new StreamReader(req.Body).ReadToEndAsync();
    var familyRequest = JsonSerializer.Deserialize<FamilyRequest>(requestBody);
    
    // 后续调用第三方API的逻辑
    // ...
}

如果想简化代码，直接用[FromBody]，可以修改方法签名，把HttpRequest req替换成强类型参数并加上[FromBody]属性（Azure Functions中HttpTrigger结合FromBody时，参数直接用FromBody标记即可）：

[FunctionName("GetFamilyInfo")]
public static async Task<IActionResult> GetFamilyInfo(
    [HttpTrigger(AuthorizationLevel.Function, "post", Route = "families/")] [FromBody] FamilyRequest familyRequest, 
    ILogger log)
{
    if (familyRequest == null)
    {
        return new BadRequestObjectResult("请求体格式不正确");
    }
    
    // 直接使用familyRequest对象调用第三方API
    // ...
}

这样框架会自动帮你完成请求体的反序列化，省去手动读取和解析的步骤，代码更简洁。

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