Azure Functions v3 HTTP触发继承WebJobStartup后访问请求头报错

• 基于.NET Core 3.1开发Azure Functions v3 HTTP触发应用，核心功能为从请求Authorization头提取JWT，通过JwtSecurityTokenHandler完成身份校验
• 启动类继承FunctionsStartup时功能运行完全正常
• 将启动类改为继承WebJobStartup后，应用抛出类型匹配错误：无法找到Microsoft.Extensions.Primitives.StringValues类型对应的Microsoft.AspNetCore.Http.IHeaderDictionary.get_Item方法

• 调试器可逐步跟踪整体执行流，但所有访问request.Headers字典条目的代码段都会直接触发上述异常，在读取Authorization头时表现尤为明显
• 只要代码中包含对req.Headers的引用，调试器就无法进入GetJwtFromHeader方法执行；移除所有req.Headers相关引用后，调试器可正常进入方法运行
• 调试时通过监视窗口查看req对象，可正常获取正确的请求头取值，不存在请求本身缺失请求头的问题

[FunctionName("HttpAuth")]
public async Task<IActionResult> Run(
    [HttpTrigger(AuthorizationLevel.Anonymous, "get", "post", Route = null)] HttpRequest req,
    ExecutionContext context,
    ILogger log)
{
    SomeFunction();
    var jwt = GetJwtFromHeader(req);
}

private string GetJwtFromHeader(HttpRequest req)
{
    var authorizationHeader = req.Headers?["Authorization"];
    string[] parts = authorizationHeader?.ToString().Split(null) ?? new string[0];
    return (parts.Length == 2 && parts[0].Equals("Bearer")) ? parts[1] : string.Empty;
}

该异常为NuGet包跨版本不兼容引发的程序集绑定失败：

• Azure Functions v3基于.NET Core 3.1构建，运行时默认加载的Microsoft.AspNetCore.Http、Microsoft.Extensions.Primitives为3.x版本，IHeaderDictionary的索引器方法签名基于3.x版本的StringValues类型定义
• 切换为WebJobStartup启动类时，会触发WebJobs SDK的依赖解析逻辑，该逻辑会优先加载项目中被升级到5.0及以上版本的Microsoft.Extensions.Primitives程序集——大版本变更后，StringValues类型的程序集标识发生变化，和运行时已加载的3.x版本IHeaderDictionary接口类型不匹配，运行时绑定方法时无法找到对应签名的get_Item方法，进而抛出异常
• 项目中无法将Microsoft.Extensions.Primitives降级到5.0以下版本，是因为当前使用的高版本WebJobs SDK将Microsoft.Extensions.Primitives的最低依赖要求锁定在了5.0，与.NET Core 3.1运行时的原生依赖形成版本冲突

• 回退启动类实现，保持继承FunctionsStartup的Azure Functions官方推荐启动方式，避免触发WebJobStartup的非公开依赖绑定逻辑
• 若必须使用WebJobStartup，可在项目.csproj中添加程序集版本绑定规则，强制运行时加载与Azure Functions v3运行时版本匹配的3.x版本Microsoft.Extensions.Primitives、Microsoft.AspNetCore.Http程序集，屏蔽高版本程序集的加载优先级
• 可调整请求头读取逻辑，使用req.Headers.TryGetValue("Authorization", out var authValue)替代索引器取值，部分场景下可绕过接口方法的绑定校验逻辑

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