Blazor Server集成Azure身份平台SignalR报错求助

错误含义解析 #

Connection disconnected with error 'Error: Server returned an error on close: Connection closed with an error. InvalidDataException: Reading 'target' as String failed.'

这个错误核心是SignalR Hub在解析消息时无法将target字段读取为字符串。target是SignalR协议中指定要调用的Hub方法名称的必填字段，出现该错误通常源于：

• 客户端与Hub建立连接时，身份验证流程传递的参数/令牌格式不符合SignalR预期，干扰了消息结构
• Hub连接配置代码中，身份验证逻辑修改了SignalR默认的消息处理流程
• 客户端初始化HubConnection时，错误设置了消息相关参数

本地重连与部署后错误排查 #

本地持续重连 #

本地环境的持续重连是SignalR连接断开后的默认重试行为，根源还是初始连接失败导致的target解析错误，重点检查：

• 确认Azure身份平台令牌是否正确传递给SignalR Hub。Blazor Server中需确保建立HubConnection时，正确将身份令牌附加到请求头，示例代码：

  var hubConnection = new HubConnectionBuilder()
      .WithUrl(NavigationManager.ToAbsoluteUri("/chatHub"), options =>
      {
          options.AccessTokenProvider = async () =>
          {
              var tokenResult = await TokenProvider.RequestAccessToken();
              tokenResult.TryGetToken(out var token);
              return token?.Value;
          };
      })
      .Build();
  

• 检查Hub的OnConnectedAsync方法，是否存在错误逻辑破坏了SignalR默认消息结构，比如错误读取自定义字段

Azure App Service部署后通用错误 #

部署后出现通用错误，需先开启详细日志排查：

1. 进入Azure门户的目标App Service，在监控 > 应用服务日志中开启「详细错误日志」和「应用日志记录」
2. 通过高级工具 > Kudu查看日志文件，获取具体错误信息，通常是身份验证配置不全导致

Azure相关配置要求 #

该错误与Azure身份平台配置直接相关，必须确保以下配置正确：

• 应用注册配置：
  • 添加正确的重定向URI：本地环境为https://localhost:xxxx/signin-oidc，Azure App Service为https://<你的应用名称>.azurewebsites.net/signin-oidc
  • 启用「ID令牌」和「访问令牌」（用于SignalR身份验证）
  • 添加API权限：确保包含Microsoft Graph的User.Read权限，以及Hub所需的自定义API权限
• App Service配置：
  • 在配置 > 应用程序设置中添加Azure AD相关项：AzureAd:ClientId、AzureAd:TenantId、AzureAd:ClientSecret（或使用托管标识）
  • 启用App Service的「身份验证」功能，选择Azure Active Directory作为身份提供商并配置正确的应用注册信息
• CORS配置：若涉及跨域场景，需在App Service的API > CORS中添加允许的源

额外排查点 #

• 确认Hub类上正确添加了[Authorize]特性，且身份验证策略与Azure AD配置匹配
• 检查客户端与服务端的SignalR版本是否一致，版本不兼容可能导致消息格式解析错误

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