Azure Functions v2 EventHubTrigger异常，版本与Startup配置冲突求助

你遇到的是Microsoft.NET.Sdk.Functions版本兼容性引发的双重问题：1.0.29版本下EventHubTrigger无法读取连接字符串，降级到1.0.25后触发器正常但Startup配置不生效。下面是针对性的排查和解决方案：

核心原因分析 #

• 1.0.29版本的Microsoft.NET.Sdk.Functions对EventHubs扩展的依赖逻辑有更新，如果配套的Microsoft.Azure.WebJobs.Extensions.EventHubs版本不匹配，就会出现连接字符串读取失败的问题。
• 1.0.25版本的Sdk对FunctionsStartup的支持不完善，导致Configure方法无法执行，这是早期版本的已知限制。

解决方案步骤 #

1. 确保NuGet包版本完全兼容 #

这是最常见的修复手段：

• 卸载当前项目中的Microsoft.Azure.WebJobs.Extensions.EventHubs包。
• 安装与Microsoft.NET.Sdk.Functions 1.0.29兼容的EventHubs扩展版本（推荐3.0.5，可通过NuGet包的依赖关系确认）。
• 重新构建项目，测试EventHubTrigger是否正常读取连接字符串。

2. 修正连接字符串的配置命名 #

新版本的EventHubs扩展对配置键名的处理更严格，建议调整配置以避免歧义：

• 修改local.settings.json中的键名，使用更清晰的命名：

{
  "IsEncrypted": false,
  "Values": {
    "AzureWebJobsStorage": "*****",
    "MyEventHub_ConnectionString": "Endpoint=sb://***.servicebus.windows.net/;SharedAccessKeyName=RootManageSharedAccessKey;SharedAccessKey=***"
  }
}

• 同步更新Trigger的Connection参数值：

[FunctionName("MyFunction")]
public async Task RunAsync([EventHubTrigger("myHubName", Connection = "MyEventHub_ConnectionString")] string events, ILogger log) 
{ 
    // 函数逻辑
}

3. 验证Startup类是否干扰配置加载 #

如果你的Startup中自定义了配置加载逻辑，可能会覆盖默认的local.settings.json读取：

• 在Startup.Configure中添加调试代码，确认配置是否被正确加载：

public override void Configure(IFunctionsHostBuilder builder)
{
    var config = builder.GetContext().Configuration;
    var hubConn = config["MyEventHub_ConnectionString"];
    if (string.IsNullOrEmpty(hubConn))
    {
        // 此处可添加日志或断点，确认配置是否读取成功
        throw new InvalidOperationException("EventHub连接字符串未找到");
    }
    // 你的其他配置逻辑
}

如果读取失败，需要调整Startup中的配置源顺序，确保local.settings.json被优先加载。

4. 升级到最新稳定版Sdk（推荐） #

1.x版本的Microsoft.NET.Sdk.Functions已经比较陈旧，建议直接升级到最新的稳定版（比如3.x或4.x）：

• 升级Microsoft.NET.Sdk.Functions到最新稳定版，同时配套升级Microsoft.Azure.WebJobs.Extensions.EventHubs到对应版本。
• 新版本不仅能解决Startup执行问题，还能修复EventHubs触发器的已知bug，提升整体稳定性。

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