为HTTP触发Azure Function请求体参数设置默认值

嘿，刚接触Azure Functions遇到这种参数默认值的问题太正常了！我给你两种实用的解决办法，不管你用C#还是Python都能轻松搞定参数为空的情况：

这种方法最适合参数多的场景，代码干净还不用手动判断空值。你只需要创建一个对应请求体参数的类，给每个属性设置好默认值，Azure会自动帮你把请求体的参数绑定到这个类的实例上，没传的参数就用你定义的默认值。

C# 示例代码： #

// 定义参数模型，每个属性设置默认值
public class RequestParams
{
    public string Username { get; set; } = "";       // 字符串默认空
    public int Age { get; set; } = 0;                // 整数默认0
    public bool IsActive { get; set; } = false;      // 布尔默认false
    // 剩下的7个参数按照这个格式添加即可
}

public static class MyHttpFunction
{
    [FunctionName("UserInfoTrigger")]
    public static async Task<IActionResult> Run(
        [HttpTrigger(AuthorizationLevel.Function, "post", Route = null)] HttpRequest req,
        [FromBody] RequestParams paramsModel, // 直接绑定模型
        ILogger log)
    {
        log.LogInformation("处理HTTP请求");

        // 直接使用模型里的参数，完全不用担心空值报错
        string userName = paramsModel.Username;
        int userAge = paramsModel.Age;
        bool userActive = paramsModel.IsActive;

        // 这里写你的业务逻辑，比如根据参数值执行不同操作
        string result = userActive ? $"活跃用户：{userName}，年龄{userAge}" : $"非活跃用户：{userName}";

        return new OkObjectResult(result);
    }
}

Python 示例代码（用Pydantic模型）： #

如果你用Python，推荐用Pydantic来做模型绑定，同样能自动处理默认值：

import azure.functions as func
from pydantic import BaseModel

# 定义参数模型
class RequestParams(BaseModel):
    Username: str = ""
    Age: int = 0
    IsActive: bool = False
    # 其他参数同理添加

def main(req: func.HttpRequest) -> func.HttpResponse:
    try:
        # 绑定请求体到模型
        params_model = RequestParams(**req.get_json())
    except ValueError:
        return func.HttpResponse("请求格式错误", status_code=400)

    # 直接使用参数
    result = f"活跃用户：{params_model.Username}" if params_model.IsActive else f"非活跃用户：{params_model.Username}"
    
    return func.HttpResponse(result)

如果你不想创建模型，也可以手动读取请求体的参数，用空值合并或者字典的get方法来设置默认值。

C# 示例代码： #

using Newtonsoft.Json;

public static class MyHttpFunction
{
    [FunctionName("UserInfoTrigger")]
    public static async Task<IActionResult> Run(
        [HttpTrigger(AuthorizationLevel.Function, "post", Route = null)] HttpRequest req,
        ILogger log)
    {
        log.LogInformation("处理HTTP请求");

        // 读取请求体内容
        string requestBody = await new StreamReader(req.Body).ReadToEndAsync();
        dynamic data = JsonConvert.DeserializeObject(requestBody);

        // 手动获取参数，用??设置默认值
        string userName = data?.Username ?? "";
        int userAge = data?.Age ?? 0;
        bool userActive = data?.IsActive ?? false;
        // 其他参数同理处理

        // 业务逻辑
        string result = userActive ? $"活跃用户：{userName}，年龄{userAge}" : $"非活跃用户：{userName}";

        return new OkObjectResult(result);
    }
}

Python 示例代码： #

import azure.functions as func
import json

def main(req: func.HttpRequest) -> func.HttpResponse:
    req_body = req.get_json() or {}  # 如果请求体为空，默认空字典

    # 用get方法获取参数，第二个参数是默认值
    user_name = req_body.get('Username', '')
    user_age = req_body.get('Age', 0)
    user_active = req_body.get('IsActive', False)

    # 业务逻辑
    result = f"活跃用户：{user_name}" if user_active else f"非活跃用户：{user_name}"
    
    return func.HttpResponse(result)

• 确保请求的Content-Type设置为application/json，否则模型绑定可能无法正常工作
• 如果是GET请求，参数在QueryString里，C#可以用req.Query.GetValueOrDefault("Username", "")，Python可以用req.params.get("Username", "")来设置默认值
• 布尔值在JSON里要写小写的true/false，Azure会自动帮你转换成对应的布尔类型，不用手动处理

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