ASP.NET Core trong .NET 11: OpenAPI 3.2, xác thực bất đồng bộ và điều cần kiểm tra khi nâng cấp
.NET 11 bổ sung union type cho JSON, validation bất đồng bộ và cải tiến SignalR; các thành phần Blazor AI vẫn ở trạng thái thử nghiệm.
ASP.NET Core trong .NET 11 thay đổi một số mắt xích quen thuộc của ứng dụng web: tài liệu OpenAPI được tạo mặc định theo phiên bản 3.2, Minimal API hỗ trợ xác thực dữ liệu bất đồng bộ và SignalR có thêm khả năng làm mới trạng thái xác thực. Với các nhóm duy trì API, điều cần xem không chỉ là tính năng mới mà còn là khả năng tương thích với công cụ và hệ thống hiện có.
Microsoft công bố .NET 11 ngày 10/11/2026. Đây là bản Standard Term Support với hai năm hỗ trợ theo thông báo của hãng; .NET 10 vẫn là lựa chọn Long Term Support được hỗ trợ. Thời hạn bảo trì nên là một phần của quyết định nâng cấp, cùng với chi phí kiểm thử ứng dụng.
OpenAPI 3.2 trở thành mặc định
Theo ghi chú phát hành ASP.NET Core, tài liệu OpenAPI được sinh ra mặc định hướng tới phiên bản 3.2. Định dạng này có thêm khả năng mô tả dữ liệu của từng sự kiện trong luồng Server-Sent Events, thay vì chỉ coi nội dung sự kiện như một chuỗi chung.
Thay đổi này hữu ích khi API cung cấp luồng dữ liệu, nhưng có thể ảnh hưởng các công cụ tạo client, kiểm tra hợp đồng hoặc cổng tài liệu chưa hỗ trợ OpenAPI 3.2. Microsoft cho phép cấu hình phiên bản tài liệu cũ hơn khi cần. Nhóm phát triển nên kiểm tra toàn bộ chuỗi từ sinh tài liệu đến tạo SDK và triển khai, thay vì chỉ xác nhận endpoint vẫn chạy.
Union type và validation bất đồng bộ
C# union type cho phép mô tả một giá trị có thể thuộc một trong các kiểu được khai báo. ASP.NET Core hỗ trợ cơ chế này ở những nơi dùng System.Text.Json, bao gồm phần thân JSON của Minimal API và MVC. Đối với tài liệu OpenAPI, các trường hợp có thể được biểu diễn qua anyOf.
Giới hạn quan trọng: tài liệu Microsoft cho biết union type không được hỗ trợ cho các nguồn binding ngoài body như tham số route, query string, header và trường form. Nếu các trường hợp tạo ra cùng hình dạng JSON, ứng dụng cũng cần cơ chế phân biệt phù hợp. Không nên xem đây là thay đổi tự động áp dụng cho mọi đầu vào của API.
Minimal API cũng hỗ trợ validator bất đồng bộ xuyên suốt quy trình kiểm tra. Điều này hữu ích khi quy tắc xác thực cần chờ thao tác khác, nhưng ứng dụng vẫn phải quản lý thời gian chờ, lỗi dịch vụ phụ thuộc và cách trả phản hồi nhất quán. Kiểm thử tích hợp cần bao gồm cả trường hợp validator thất bại hoặc bị hủy.
SignalR, nén và Blazor AI
SignalR bổ sung khả năng làm mới xác thực mà không nhất thiết ngắt kết nối; các ứng dụng có kết nối dài có thể đánh giá lợi ích này theo mô hình cấp quyền của mình. Microsoft cũng bổ sung Zstandard cho middleware nén phản hồi và giải nén yêu cầu; ghi chú phát hành cho biết zstd được bật mặc định trong các middleware tương ứng. Nhóm vận hành cần kiểm tra cấu hình, khả năng tương thích của proxy và mức sử dụng CPU trong lưu lượng thực tế.
Phần Blazor có các thành phần giao diện AI hỗ trợ những tình huống như chat streaming và luồng phê duyệt. Microsoft nói gói Microsoft.AspNetCore.Components.AI là thử nghiệm và tiếp tục ở trạng thái prerelease trong suốt .NET 11. Vì vậy, các nhóm sản xuất nên đánh giá rủi ro thay đổi API trước khi phụ thuộc trực tiếp vào gói này.
Lộ trình nâng cấp thực tế
Trước tiên, hãy kiểm kê runtime, thư viện, bộ sinh client và công cụ quan sát đang dùng; đọc thay đổi phá vỡ tương thích của Microsoft. Tiếp đó chạy bộ kiểm thử trên môi trường staging với dữ liệu đại diện, so sánh tài liệu OpenAPI cũ và mới, đồng thời kiểm tra các kết nối SignalR kéo dài và hệ thống proxy.
Mỗi ứng dụng có lịch hỗ trợ và mức độ phụ thuộc khác nhau. Với hệ thống ưu tiên vòng đời dài, việc tiếp tục ở nhánh LTS còn hỗ trợ có thể phù hợp; với hệ thống cần tính năng mới, .NET 11 mang lại các lựa chọn bổ sung sau khi kiểm thử tương thích. Cả hai hướng đều cần cập nhật các bản vá định kỳ.
Nguồn: Microsoft .NET Blog; Microsoft Learn: ASP.NET Core trong .NET 11.