Azure Function迁移至.NET 5后查询字符串数组参数绑定失败如何解决

Azure Function .NET 5 采用隔离进程工作者模型，和 .NET Core 3.1 所使用的进程内模型绑定逻辑不同，当前版本默认尚未支持将同名多值查询参数自动绑定到 IEnumerable<T> 等集合类型，只会将多个同名参数值用逗号拼接为单个字符串传入，因此触发类型转换报错。

方案1：直接从请求对象取值（最稳妥，无需额外配置） #

不要将集合类型声明为函数入参，改为从 HttpRequestData 对象中手动读取查询参数，代码示例：

[Function("QueryProductEntities")]
public static async Task<HttpResponseData> Run(
    [HttpTrigger(AuthorizationLevel.Anonymous, "get", Route = "query")] HttpRequestData req,
    FunctionContext context)
{
    // 直接读取所有sgtins参数值，自动转为集合
    List<string> sgtins = req.Query["sgtins"].ToList();
    // 后续业务逻辑
}

方案2：自定义类型转换器（需要保留参数绑定写法时使用） #

实现自定义转换器处理字符串到集合的转换逻辑，步骤如下：

1. 实现 ICustomConverter 接口：

using Microsoft.Azure.Functions.Worker.Converters;

public class StringToEnumerableConverter : ICustomConverter<IEnumerable<string>>
{
    public ConvertResult<IEnumerable<string>> Convert(object value, ConverterContext context)
    {
        if (value is string inputStr)
        {
            // 按逗号拆分拼接的多值，返回集合
            return ConvertResult.Success(inputStr.Split(',', StringSplitOptions.RemoveEmptyEntries));
        }
        return ConvertResult.Failed<IEnumerable<string>>();
    }
}

2. 在项目启动文件 Program.cs 中注册转换器：

var host = new HostBuilder()
    .ConfigureFunctionsWorkerDefaults(builder =>
    {
        builder.Services.AddSingleton<ICustomConverter<IEnumerable<string>>, StringToEnumerableConverter>();
    })
    .Build();

host.Run();

注意：如果参数值本身包含逗号，需要提前对参数值做转义处理，避免拆分错误。

方案3：升级运行时版本 #

该绑定缺陷在 .NET 6 及更高版本的 Azure Function 运行时中已被官方修复，若业务允许升级，直接将项目目标框架升级到 .NET 6 及以上即可原生支持集合类型的查询参数自动绑定。

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