.NET7 Razor Page中SignalR推送Schedule空引用异常排查求助

针对你遇到的Clients.All.SendAsync触发空引用异常、定时器无法推送数据的问题，按以下步骤排查：

1. 禁止手动实例化Hub类 #

SignalR的Hub实例由框架托管，绝对不能自己new Hub对象。如果你的定时器逻辑里是手动创建Hub实例，Clients属性必然为null——因为框架才会负责注入IHubCallerClients等依赖。

正确做法是通过IHubContext<YourHub>来操作客户端：

// 示例：在定时器服务中注入IHubContext
public class SchedulePushService : BackgroundService
{
    private readonly IHubContext<ScheduleHub> _hubContext;

    public SchedulePushService(IHubContext<ScheduleHub> hubContext)
    {
        _hubContext = hubContext;
    }

    protected override async Task ExecuteAsync(CancellationToken stoppingToken)
    {
        while (!stoppingToken.IsCancellationRequested)
        {
            var schedule = GetUpdatedSchedule(); // 你的获取逻辑
            // 使用_hubContext推送，而非Hub实例的Clients
            await _hubContext.Clients.All.SendAsync("updateSchedule", schedule, stoppingToken);
            await Task.Delay(TimeSpan.FromMinutes(1), stoppingToken);
        }
    }
}

2. 验证SignalR服务注册是否完整 #

在Program.cs中确认已正确注册SignalR：

// 注册SignalR服务
builder.Services.AddSignalR();

// 映射Hub端点
app.MapHub<ScheduleHub>("/scheduleHub");

3. 检查Hub类的定义 #

Hub类需直接继承Hub，不要自定义构造函数（除非你明确知道如何注入依赖，否则会覆盖框架的依赖注入逻辑，导致Clients为空）：

public class ScheduleHub : Hub
{
    // 仅保留框架默认的无参构造函数，不要添加自定义构造函数
}

4. 确认定时器服务的生命周期 #

• 如果使用BackgroundService实现定时器，需以单例注册（默认就是单例），确保IHubContext能被正确注入（IHubContext本身是单例服务）。
• 避免在Razor Page的PageModel中创建定时器——请求结束后PageModel会被释放，相关依赖也可能失效。

5. 定位空引用的具体来源 #

在推送代码处添加日志，明确是Clients为空还是其他对象问题：

try
{
    if (_hubContext.Clients == null)
    {
        // 记录日志：IHubContext.Clients 为 null
    }
    await _hubContext.Clients.All.SendAsync("updateSchedule", Schedule);
}
catch (NullReferenceException ex)
{
    // 记录异常完整堆栈，定位具体空引用对象
}

6. 验证客户端连接状态 #

在Hub中添加连接日志，确认定时器触发时存在在线客户端：

public class ScheduleHub : Hub
{
    public override async Task OnConnectedAsync()
    {
        // 记录客户端连接：Context.ConnectionId
        await base.OnConnectedAsync();
    }

    public override async Task OnDisconnectedAsync(Exception? exception)
    {
        // 记录客户端断开：Context.ConnectionId
        await base.OnDisconnectedAsync(exception);
    }
}

同时确认客户端已正确监听事件：

const connection = new signalR.HubConnectionBuilder()
    .withUrl("/scheduleHub")
    .build();

connection.on("updateSchedule", function(schedule) {
    // 处理更新逻辑，比如渲染时间表
});

await connection.start();

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