Azure Function连接Azure SignalR服务报错问题求助

错误原因 #

Azure Functions的WebJobs宿主环境对IHostedService的注册生命周期有严格限制，直接使用Microsoft.Azure.SignalR SDK的AddAzureSignalR()方法会自动注册一个Singleton生命周期的HeartBeat服务，这与Functions宿主的预期冲突，从而触发该错误。

解决方案 #

1. 替换为Azure Functions专用SignalR扩展包 #

卸载原有的Microsoft.Azure.SignalR NuGet包，安装Microsoft.Azure.WebJobs.Extensions.SignalRService包，该包是专门为Azure Functions环境设计的，会自动适配宿主的服务生命周期要求。

2. 修改服务注册代码 #

使用Functions专用的扩展方法注册SignalR服务，有两种方式：

方式一：手动配置连接字符串并禁用HeartBeat

如果需要手动指定连接字符串，可以禁用自动注册的HeartBeat服务：

private IServiceCollection ConfigureServices(IServiceCollection services)
{
    var connectionString = Environment.GetEnvironmentVariable("AzureSignalRConnectionString");
    services.AddSignalR().AddAzureSignalR(options =>
    {
        options.ConnectionString = connectionString;
        options.DisableHeartbeat = true; // 禁用冲突的HeartBeat服务
    });
    return services;
}

方式二：使用Functions专用扩展方法（推荐）

直接使用AddSignalRService()扩展方法，它会自动从环境变量读取AzureSignalRConnectionString，并适配Functions环境：

private IServiceCollection ConfigureServices(IServiceCollection services)
{
    services.AddSignalRService();
    return services;
}

3. 确保版本兼容性 #

确保Microsoft.Azure.WebJobs.Extensions.SignalRService的版本与你使用的Azure Functions Runtime版本匹配（比如Functions v4对应包的v1.x或更高版本）。

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