Azure Functions中通过HttpTrigger配置自定义路由的问题

我来帮你搞定这个问题！你遇到的核心问题是可选路由参数没有和函数参数的默认值配合使用，导致访问不带format的路径时绑定失败，同时带路由参数的路径也没正确匹配。下面是具体的解决方案：

关键修改步骤 #

1. 正确配置Route属性：使用"qotd/{format:alpha?}"，其中?标记参数为可选，:alpha限制参数只能是字母（可选，但能避免非法输入）。
2. 给函数参数设置默认值：当访问不带format的路径时，需要给format参数一个默认值，比如"plain"，这样绑定系统就不会报错。
3. 调整逻辑适配默认值：确保代码在format为默认值时返回文本格式的响应。

修改后的完整代码 #

public static async Task<HttpResponseMessage> Run(
    [HttpTrigger(AuthorizationLevel.Function, "get", "post", Route = "qotd/{format:alpha?}")]HttpRequestMessage req,
    string format = "plain", // 设置默认值为plain
    TraceWriter log)
{
    var quote = GetRandomQuote();
    
    if (format.Equals("json", StringComparison.OrdinalIgnoreCase))
    {
        return req.CreateResponse(HttpStatusCode.OK, quote, "application/json");
    }
    else
    {
        // 默认返回文本格式，包括format为plain或其他未匹配的值
        var strQuote = quote.Text + Environment.NewLine + quote.Author;
        return req.CreateResponse(HttpStatusCode.OK, strQuote, "text/plain");
    }
}

为什么之前的尝试没生效？ #

你之前用了Route = "qotd/{format:alpha?}"但还是报错，是因为没有给format参数设置默认值。Azure Functions v1版本中，可选路由参数必须对应有默认值的函数参数，否则当访问不带参数的路径时，绑定系统找不到format的值就会抛出异常。

而localhost:7071/api/qotd/?format=json能成功，是因为这时候用的是查询参数绑定，和路由配置无关，查询参数会直接映射到函数的format参数。

测试验证 #

修改后你可以正常访问两个路径：

• localhost:7071/api/qotd：使用默认的format=plain，返回文本格式的名言
• localhost:7071/api/qotd/json：传入format=json，返回JSON格式的名言

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