安装AspNetCore.SignalR.Client导致.NET Maui应用故障，求排查方案

可能的冲突诱因 #

• 目标框架版本不兼容：AspNetCore.SignalR.Client对.NET MAUI的目标框架有明确要求，较新版本的包通常需要匹配.NET 7及以上的MAUI SDK版本。如果你的项目使用的框架版本过低，就会触发兼容性问题。
• 传递依赖版本冲突：MAUI自身依赖的System.*、Microsoft.*系列包，可能与AspNetCore.SignalR.Client引入的间接依赖版本不一致，导致类型加载或服务注册失败。

可落地的解决方案 #

• 对齐依赖版本：在项目的.csproj文件中，强制声明与MAUI默认依赖一致的包版本，覆盖SignalR Client带来的版本偏差。例如：

  <ItemGroup>
    <PackageReference Include="System.Text.Json" Version="7.0.3" />
    <PackageReference Include="Microsoft.Extensions.DependencyInjection" Version="7.0.0" />
  </ItemGroup>
  

• 匹配后端SignalR版本：选择与后端ASP.NET Core SignalR大版本一致的客户端包。比如后端用ASP.NET Core 6，就对应使用AspNetCore.SignalR.Client 6.x版本；后端用ASP.NET Core 7，则选用7.x版本，避免跨大版本的兼容性问题。
• 清理重建项目：删除项目的bin、obj文件夹，清理NuGet缓存后重新构建：

  dotnet clean
  dotnet restore
  dotnet build
  

• 检查服务注册逻辑：确认MauiProgram.cs中SignalR的服务注册未干扰MAUI默认服务。正确的注册方式应为：

  builder.Services.AddSignalR();
  

  不要覆盖或修改MAUI原生的导航、视图注册逻辑。

精准定位异常 #

若以上方法无效，捕获全局异常获取细节：
在App.xaml.cs的OnStart方法中添加异常捕获：

try
{
    // 应用初始化逻辑
}
catch (Exception ex)
{
    System.Diagnostics.Debug.WriteLine($"异常详情：{ex.Message}\n堆栈跟踪：{ex.StackTrace}");
}

根据输出的异常信息，定位具体冲突的包或代码逻辑问题。

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