Thêm thời gian thực vào một API không khó. Giữ cho nó đúng khi có 2.000 kết nối, khi client rớt mạng giữa lúc gửi, khi bạn chạy ba instance sau load balancer — đó mới là phần khó. SignalR trong ASP.NET Core 10 giải quyết phần lớn những việc đó, nhưng chỉ khi bạn hiểu nó đang giấu những gì dưới Hub.
Bài này xây một hub có phòng chat và thông báo theo người dùng, rồi đi qua bốn thứ quyết định chất lượng thật: xác thực, kết nối lại, transport, và scale-out.
Mục lục
Cập nhật 2026
- SignalR server nằm trong shared framework. Với project ASP.NET Core 10, bạn không cần
dotnet add package Microsoft.AspNetCore.SignalR. PackageMicrosoft.AspNetCore.SignalR1.2.13 chỉ còn cần khi bạn tách thư viện nhắmnetstandard2.0hoặc dùng ngoài shared framework. - SSE giờ là API hạng nhất trong ASP.NET Core 10 với
TypedResults.ServerSentEvents(...). Nghĩa là với nhu cầu đẩy một chiều, bạn có lựa chọn nhẹ hơn SignalR. - .NET 10 LTS là môi trường chạy; .NET 8/9 hết hỗ trợ ngày 2026-11-10. .NET 11 mới ở RC3, chưa GA.
- Client JS/TS vẫn là package
@microsoft/signalr. Đừng dùng CDN@latestnhư các bài cũ: pin version trongpackage.jsonđể client và server không lệch nhau sau một lần deploy.
Mô hình cần nắm trước khi viết code
SignalR có bốn khái niệm, và mỗi khái niệm sống ở một tầng khác nhau:
- Connection — một kết nối vật lý từ client, có
ConnectionIddo server sinh. Đây là đơn vị mà transport nhìn thấy. - Hub — class của bạn, nơi nhận lời gọi từ client và quyết định gửi đi đâu. Hub được tạo mới cho mỗi lời gọi, không giữ state giữa các lời gọi.
- Group — tập connection được gắn nhãn. Nhóm thuộc về server đang giữ connection, không phải một khái niệm toàn cục trong database.
- User — danh tính đã xác thực, truy cập qua
Context.UserIdentifier. Một người dùng có thể có nhiều connection (nhiều tab, nhiều thiết bị), vàClients.User(id)gửi tới tất cả.
Điểm dễ sai nhất: group không tồn tại sau khi connection đóng. Nếu client reconnect, nó có ConnectionId mới và không còn ở trong group cũ. Mọi hướng dẫn “gọi JoinRoom sau khi connect” đều đúng, nhưng phải gọi cả sau khi reconnect.
Server: hub có phòng và thông báo
// File: Hubs/ChatHub.cs
using Microsoft.AspNetCore.Authorization;
using Microsoft.AspNetCore.SignalR;
public sealed record ChatMessage(
string UserId, string DisplayName, string RoomId, string Text, DateTimeOffset SentAt);
[Authorize]
public sealed class ChatHub : Hub
{
public override async Task OnConnectedAsync()
{
await Groups.AddToGroupAsync(Context.ConnectionId, $"user:{Context.UserIdentifier}");
await base.OnConnectedAsync();
}
public Task JoinRoom(string roomId) =>
Groups.AddToGroupAsync(Context.ConnectionId, $"room:{roomId}");
public Task LeaveRoom(string roomId) =>
Groups.RemoveFromGroupAsync(Context.ConnectionId, $"room:{roomId}");
public async Task SendMessage(string roomId, string text)
{
if (string.IsNullOrWhiteSpace(text) || text.Length > 2000)
throw new HubException("Tin nhắn không hợp lệ.");
var message = new ChatMessage(
Context.UserIdentifier!,
Context.User?.Identity?.Name ?? "unknown",
roomId,
text,
DateTimeOffset.UtcNow);
await Clients.Group($"room:{roomId}").SendAsync("ReceiveMessage", message);
}
}
Vài chi tiết đáng chú ý trong đoạn trên:
[Authorize]trên hub chặn cả handshake. Không cần tự kiểm tra token trong từng method.HubExceptionlà loại exception duy nhất được gửi thông điệp về client. Exception khác bị thay bằng thông báo chung — đừng đăng ký log để lộ chi tiết nội bộ.- Group đặt tên theo tiền tố (
room:,user:) để không va nhau khi bạn thêm loại group mới.
Đăng ký trong Program.cs:
// File: Program.cs
builder.Services.AddSignalR(o =>
{
o.MaximumReceiveMessageSize = 64 * 1024; // mặc định 32 KB
o.MaximumParallelInvocationsPerClient = 2; // mặc định 1
});
builder.Services.AddSingleton<IUserIdProvider, SubClaimUserIdProvider>();
var app = builder.Build();
app.UseAuthentication();
app.UseAuthorization();
app.MapHub<ChatHub>("/hubs/chat");
app.Run();
MaximumReceiveMessageSize mặc định là 32 KB. Tăng nó là cách nhanh nhất để nhận payload lớn, và cũng là cách nhanh nhất để một client viết lỗi làm server cấp phát bộ nhớ. Nếu bạn cần gửi ảnh hoặc tài liệu, đừng đẩy qua hub — gửi qua HTTP endpoint rồi thông báo một id qua hub.
IUserIdProvider quyết định Context.UserIdentifier lấy từ claim nào. Mặc định là ClaimTypes.NameIdentifier; nếu hệ thống của bạn dùng sub (JWT chuẩn OIDC), hãy thay provider, đừng đổi tên claim trong token chỉ để chiều SignalR.
Gửi từ ngoài hub: IHubContext
Background service, message consumer, hay một controller đều không nằm trong một hub invocation. Chúng dùng IHubContext<THub>, được đăng ký sẵn và an toàn để inject như singleton:
// File: Notifications/OrderNotificationService.cs
using Microsoft.AspNetCore.SignalR;
public sealed class OrderNotificationService(IHubContext<ChatHub> hub)
{
public Task NotifyPaidAsync(string userId, int orderId, CancellationToken ct) =>
hub.Clients.User(userId)
.SendAsync("OrderPaid", new { orderId, at = DateTimeOffset.UtcNow }, ct);
}
Lưu ý: IHubContext gửi được tới client nhưng không đọc được state của hub và không gọi được method trên hub. Nếu logic cần cả hai, hãy đưa logic đó vào một service mà cả hub lẫn worker cùng dùng.
Client JS/TS: reconnect là phần bắt buộc
// File: wwwroot/js/chat.ts
import {
HubConnectionBuilder, HttpTransportType, LogLevel, HubConnectionState
} from "@microsoft/signalr";
const joined = new Set<string>();
const connection = new HubConnectionBuilder()
.withUrl("/hubs/chat", {
accessTokenFactory: () => getAccessToken(),
transport: HttpTransportType.WebSockets,
skipNegotiation: true
})
.withAutomaticReconnect([0, 2000, 10000, 30000])
.configureLogging(LogLevel.Information)
.build();
connection.on("ReceiveMessage", (msg) => appendMessage(msg));
connection.onreconnected(async () => {
for (const room of joined) {
await connection.invoke("JoinRoom", room);
}
});
connection.onclose((error) => {
setStatus("offline");
console.error("SignalR closed", error);
});
await connection.start();
setStatus("online");
skipNegotiation: true chỉ hợp lệ khi bạn ép WebSockets. Nó bỏ một round-trip HTTP nhưng cũng bỏ luôn khả năng fallback — chỉ dùng khi bạn kiểm soát được hạ tầng (proxy, firewall) và đã xác nhận WebSocket đi qua được.
withAutomaticReconnect không tự động khôi phục group, không tự động gửi lại message đang chờ, và không tự chạy lại các invoke đã thất bại. Đây là ba việc bạn phải viết: gia nhập lại group, hàng đợi gửi, và chỉ báo UI rằng dữ liệu có thể đã lỡ.
Transport: đàm phán tự động, nhưng đừng mù về nó
| Transport | Khi nào dùng | Chi phí |
|---|---|---|
| WebSockets | Mặc định; hai chiều, độ trễ thấp | Thấp nhất sau handshake |
| Server-Sent Events | Proxy chặn upgrade; chủ yếu server đẩy xuống | Mỗi chiều một kết nối; tự reconnect |
| Long Polling | Fallback cuối, mạng doanh nghiệp rất hạn chế | Cao: mỗi message là một request |
SignalR đàm phán qua endpoint /negotiate và chọn transport tốt nhất mà cả hai phía hỗ trợ. Transport thực tế hiện trong phản hồi negotiate (bật log mức Debug ở client để thấy) và trong log Debug của server. Nếu bạn thấy LongPolling trong production, đó gần như luôn là lỗi cấu hình proxy chứ không phải giới hạn của trình duyệt.
Scale-out: backplane và sticky session
Với một instance, group nằm trong bộ nhớ process. Với hai instance, client A nối vào instance 1 không nhận được message mà instance 2 gửi cho group của nó. Backplane giải quyết việc này:
// File: Program.cs
builder.Services.AddSignalR()
.AddStackExchangeRedis(redisConnectionString, o =>
{
o.Configuration.ChannelPrefix = RedisChannel.Literal("chat");
});
Package cần thêm là Microsoft.AspNetCore.SignalR.StackExchangeRedis; server Redis 8 là bản hiện hành. Backplane chỉ chuyển message giữa các server — nó không lưu group, không replay message đã mất, và không thay đổi việc mỗi connection phải nằm trên đúng một server.
Ba lựa chọn scale-out, xếp theo độ phức tạp:
- Sticky session ở load balancer — đủ cho một cụm nhỏ, nhưng không giải quyết broadcast giữa các instance và làm deploy mất kết nối hàng loạt.
- Redis backplane — chuẩn tự vận hành. Cần Redis, cần cấu hình
ChannelPrefixriêng cho từng môi trường, và vẫn cần sticky session khi client có thể rơi xuống SSE/Long Polling. - Azure SignalR Service — service nhận connection thay cho app của bạn, nên không cần sticky session và không cần tự vận hành backplane. Đổi lại là chi phí dịch vụ và phụ thuộc cloud.
Backpressure và kích thước message
SignalR không có flow control từ server xuống client. Nếu bạn gọi SendAsync trong vòng lặp 100.000 lần mà không await, bạn đang đưa toàn bộ dữ liệu vào buffer của connection và chờ client đọc. Hai biện pháp thực tế:
- Await từng lần gửi trong luồng chậm (worker, import, replay). Đây là backpressure tự nhiên: client đọc chậm thì vòng lặp chậm lại.
- Dùng streaming cho tập dữ liệu lớn: hub trả về
IAsyncEnumerable<T>hoặc nhậnChannelReader<T>, và client đọc theo từng item. SignalR quản lý việc chia nhỏ và huỷ khi client ngắt.
Với tải cao, đặt MaximumParallelInvocationsPerClient = 1 (mặc định) và giữ nó, trừ khi bạn có lý do rõ ràng. Cho phép nhiều invocation song song trên một connection biến hub thành nơi xử lý đồng thời các thao tác có thể không thread-safe.
Khi nào không dùng SignalR
| Nhu cầu | Lựa chọn |
|---|---|
| Chat, thông báo, presence, dashboard nhiều client | SignalR |
| Chỉ server đẩy một chiều, client không gửi | SSE (TypedResults.ServerSentEvents) hoặc SignalR |
| Giao thức nhị phân riêng, client không dùng .NET/JS | WebSocket trực tiếp (bài tiếp theo) |
| Service-to-service, throughput cao, hai chiều | gRPC streaming hoặc message broker |
SignalR hợp khi bạn cần nhóm, người dùng, reconnect, fallback và xác thực tích hợp sẵn. Nó không hợp khi đối tác yêu cầu một wire format cố định mà bạn không kiểm soát, hoặc khi bạn cần tối ưu từng byte trên một giao thức đã đặc tả.
Cạm bẫy thường gặp
- Hub giữ state. Hub instance mới cho mỗi invocation; state đặt trong field sẽ “mất” một cách khó hiểu. Dùng singleton service hoặc
Context.Itemscho phạm vi một connection. - Group theo connection thay vì theo người dùng. Khi người dùng mở hai tab, bạn gửi hai lần hoặc bỏ sót một tab. Hãy chọn khoá group theo domain (
user:{id},room:{id}). - Không log disconnect. Override
OnDisconnectedAsync(Exception?)và log lý do; đây là nguồn thông tin duy nhất cho biết client rớt do mạng, do token hết hạn hay do deploy. - Token hết hạn giữa phiên. Token chỉ được kiểm tra lúc handshake. Với phiên dài, cần cơ chế đóng kết nối và buộc client lấy token mới, hoặc chấp nhận rằng connection sống lâu hơn token.
- Đẩy payload lớn. 32 KB mặc định là hợp lý; vượt qua nên là tín hiệu thiết kế sai, không phải lý do tăng limit.
2027
.NET 11 đang ở RC và sẽ GA trong tháng 11/2026 dưới dạng STS; SignalR không có thay đổi lớn nào được công bố, nên kiến thức ở bài này vẫn dùng được. Xu hướng đáng theo dõi là SSE ngày càng được dùng cho dashboard một chiều nhờ API có sẵn trong ASP.NET Core, còn SignalR giữ vai trò cho tương tác hai chiều có nhóm và danh tính. Với AI assistant streaming token, SSE thường là lựa chọn đủ và rẻ hơn.
Checklist
- Đặt
[Authorize]trên hub và cấu hìnhIUserIdProviderkhớp claim thật. - Join group trong
OnConnectedAsyncvà join lại trongonreconnectedở client. - Pin
@microsoft/signalr, không dùng CDN@latest; log transport thực tế ở môi trường staging. - Chọn backplane trước khi scale quá một instance; đặt
ChannelPrefixriêng theo môi trường. - Giữ payload dưới 32 KB, await khi gửi hàng loạt, và dùng streaming cho tập dữ liệu lớn.
Đọc tiếp trong series
- WebSockets trong ASP.NET Core: tùy chọn cấp thấp — lớp bên dưới SignalR và khi nào cần chạm tới nó.
- HTTP và HTTPS từ A-Z — nền tảng của handshake, upgrade và proxy timeout.
- Sử dụng Redis trong ASP.NET Core — backplane, pub/sub và cache phân tán.
- Hiểu về gRPC trong ASP.NET Core — lựa chọn cho giao tiếp service-to-service.



