Azure Function读取HttpRequest Header时抛出EntryPointNotFoundException

问题场景 #

有一个带HTTP触发器的Azure Function用于处理Webhook，读取POST请求体功能正常，但尝试访问req.Headers集合（比如调用ContainsKey或TryGetValue）时抛出EntryPointNotFoundException。奇怪的是，VS2022即时窗口中执行req.Headers.ContainsKey("X-Payload-Digest")能正常运行，但单步执行或断点时却失败，调试器指向Microsoft.Azure.WebJobs.Host.Executors.TaskMethodInvoker -> FunctionInvoker，显示Result = "{Not yet computed}"。

排查方向 #

1. 检查程序集版本冲突 #

Azure Functions运行时对ASP.NET Core相关依赖有严格的版本匹配要求，若手动引入了不兼容的Microsoft.AspNetCore.Http版本，会导致类型加载异常：

• 打开项目.csproj文件，检查是否手动指定了Microsoft.AspNetCore.Http包，若有尝试移除，让Azure Functions SDK自动管理依赖版本。
• 清理项目的bin和obj目录，重新构建项目，避免旧版本程序集残留。

2. 调整代码执行顺序 #

虽然读取请求体用了await，但可以尝试先检查Headers再读取请求体，排除请求流处置导致的潜在问题：

// 先检查Headers
if (req.Headers.ContainsKey("X-Payload-Digest"))
{
    req.Headers.TryGetValue("X-Payload-Digest", out var secretKey);
}
// 再读取请求体
var requestBody = await new StreamReader(req.Body).ReadToEndAsync();

3. 对齐本地与云端运行时版本 #

本地调试时的Azure Functions Core Tools版本若与Azure云端的运行时版本不一致，可能引发此类异常：

• 检查本地Core Tools版本，更新到与云端一致的版本。
• 直接发布到Azure Functions环境测试，排除本地调试环境的特殊配置问题。

4. 确认参数类型的命名空间 #

确保HTTP触发器的HttpRequest参数来自正确的命名空间，避免误引用其他类型：

public async Task<IActionResult> Run(
    [HttpTrigger(AuthorizationLevel.Function, "post", Route = null)] Microsoft.AspNetCore.Http.HttpRequest req,
    ILogger log)
{
    // 函数逻辑
}

5. 捕获完整异常信息 #

添加try-catch块捕获详细异常，包括内部异常和堆栈跟踪，帮助定位问题根源：

try
{
    if (req.Headers.ContainsKey("X-Payload-Digest"))
    {
        req.Headers.TryGetValue("X-Payload-Digest", out var secretKey);
    }
}
catch (Exception ex)
{
    log.LogError(ex, "Headers访问失败");
    // 输出异常的完整堆栈信息，重点关注程序集加载相关的细节
}

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