如何在Azure Functions路由中获取数组参数？

看起来你在尝试通过Azure Functions的GET请求传递数组类型的status参数时遇到了绑定问题，这其实是因为路径参数和查询参数在数组绑定上有不同的规则，下面给你两个可行的解决方案：

方案一：使用查询参数传递数组（推荐） #

路径参数并不适合传递数组类型的数据，REST规范里通常会用查询参数来处理这类多值参数。你可以调整函数的路由和参数绑定方式：

1. 修改HttpTrigger的路由，移除路径中的{status}部分
2. 给status参数加上[FromQuery]特性，同时更新OpenApi注解里的参数位置

修改后的函数代码示例：

[FunctionName("GetFilteredEorInstancesByStatusOrganisationId")]
[OpenApiOperation(operationId: "GetFilteredEorInstancesStatusByOrganisationId", tags: new[] { "reads" })]
[OpenApiSecurity("function_key", SecuritySchemeType.ApiKey, Name = "code", In = OpenApiSecurityLocationType.Query)]
[OpenApiParameter(name: "organisationId", In = ParameterLocation.Path, Required = true, Type = typeof(string), Description = "the id of the Organisation")]
[OpenApiParameter(name: "searchFilter", In = ParameterLocation.Path, Required = true, Type = typeof(string), Description = "the search text filter")]
[OpenApiParameter(name: "status", In = ParameterLocation.Query, Required = true, Type = typeof(List<string>), Description = "the list of status text filters")]
[OpenApiResponseWithBody(statusCode: HttpStatusCode.OK, contentType: "text/json", bodyType: typeof(JObject), Description = "OK response")]
[OpenApiResponseWithBody(statusCode: HttpStatusCode.NotFound, contentType: "text/plain", bodyType: typeof(string), Description = "NOT FOUND response")]
public async Task<IActionResult> GetFilteredEorInstancesByStatusOrganisationId(
    [HttpTrigger(AuthorizationLevel.Function, "get", Route = "organisations/{organisationId}/eorinstances/filters/{searchFilter}")]
    HttpRequest req, string organisationId, string searchFilter, [FromQuery] List<string> status)
{
    // 这里可以直接使用绑定好的status列表
    return new OkObjectResult(status);
}

对应的请求URL格式应该是：
http://localhost:7071/api/organisations/xxx/eorinstances/filters/xxx?status=active&status=inactive

ASP.NET Core会自动把多个同名的查询参数绑定到List<string>类型的status参数中。

方案二：通过路径参数传递逗号分隔的字符串（可选） #

如果你一定要通过路径传递多值的status，可以用逗号分隔的字符串，然后在函数内部拆分：

1. 调整路由为organisations/{organisationId}/eorinstances/filters/{searchFilter}/statuses/{statuses}
2. 将status参数改为string类型，在函数内部分割成列表

修改后的核心代码：

[HttpTrigger(AuthorizationLevel.Function, "get", Route = "organisations/{organisationId}/eorinstances/filters/{searchFilter}/statuses/{statuses}")]
HttpRequest req, string organisationId, string searchFilter, string statuses)
{
    // 拆分逗号分隔的字符串为列表
    List<string> statusList = statuses.Split(',').ToList();
    // 后续业务逻辑使用statusList
}

对应的请求URL格式：
http://localhost:7071/api/organisations/xxx/eorinstances/filters/xxx/statuses/active,inactive

为什么你之前的方法没成功？ #

你尝试的status[0]=xxx是表单提交或JSON请求中常用的数组格式，但GET查询参数并不支持这种索引式的写法。Azure Functions基于ASP.NET Core的绑定规则，对于数组类型的查询参数，只识别重复的参数名（如?status=xxx&status=yyy），或者你可以自己处理逗号分隔的字符串。

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