安装Microsoft.AspNetCore.SignalR.Client后Azure Function启动报错如何解决？

报错原因 #

• 核心是Microsoft.Extensions系列依赖包版本冲突：你使用的是Azure Functions v3运行时，该版本固定绑定了3.1.x版本的Microsoft.Extensions.*类库。安装Microsoft.AspNetCore.SignalR.Client时如果未指定兼容版本，会自动拉取高版本的依赖包，连带升级了Microsoft.Extensions.Logging.Console的版本，导致运行时加载时找不到原版本的AddConsole方法签名，触发MissingMethodException。
• 冗余的日志配置放大了冲突：Azure Functions宿主本身已经内置了控制台日志配置，你在Startup中手动调用AddConsole属于不必要的额外配置，进一步触发了版本不兼容问题。

可行解决方案 #

方案1（最快生效）：移除冗余日志配置 #

直接删除Startup.cs中的以下代码行即可，无需手动配置控制台日志，Functions运行时已经默认实现了相关日志能力：

builder.Services.AddLogging(options => options.AddConsole());

修改完成后清理项目的bin、obj文件夹，重新启动Function即可验证。

方案2：统一锁定依赖包版本 #

如果删除日志配置后仍报错，需要将所有Microsoft.Extensions相关包的版本锁定为和v3运行时兼容的3.1.x版本：

1. 在.csproj中显式指定Microsoft.AspNetCore.SignalR.Client的版本为3.1.x系列的最新稳定版，不要使用5.x及以上版本
2. 显式添加Microsoft.Extensions.Logging.Console的引用，版本和其他Microsoft.Extensions包保持一致：

<PackageReference Include="Microsoft.Extensions.Logging.Console" Version="3.1.32" />
<PackageReference Include="Microsoft.AspNetCore.SignalR.Client" Version="3.1.32" />

方案3（优化建议）：重构SignalR连接实现 #

你当前的SignalRService静态类每次调用都会新建一个HubConnection，会造成严重的资源浪费，建议改为单例注入：

1. 把SignalRService改为非静态类，在Startup中注册为单例
2. 初始化HubConnection的逻辑放在单例的构造函数中，复用同一个连接，也能减少依赖加载冲突的概率。

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