Ngày 30/10/2026, đội ngũ Pydantic công bố bắt đầu phát triển Pydantic V3, đặt mục tiêu đưa bản này gần trạng thái hoàn thiện cuối năm 2026. Cùng lúc, Pydantic V1.10.27 được xác nhận là bản V1 cuối cùng và hỗ trợ V1 chính thức kết thúc: lỗi bảo mật mới sẽ không còn được sửa. Tin tốt là V3 sẽ không lặp lại cuộc migration đau đớn như V1 lên V2, và V2 vẫn tiếp tục nhận bản vá lỗi lớn và bảo mật cho tới khi đa số người dùng đã chuyển sang V3.

Pydantic là một trong 20 package được tải nhiều nhất trên PyPI, hơn 800 triệu lượt tải mỗi tháng, và là nền tảng validate dữ liệu của FastAPI. Vì vậy lộ trình lần này ảnh hưởng trực tiếp tới hàng triệu dự án và đáng đọc kỹ trước khi bạn lên kế hoạch nâng cấp.

V3 sẽ thay đổi theo cách khác

Đội ngũ Pydantic thừa nhận migration từ V1 lên V2 từng gây đau đớn cho một số người dùng, nên họ đã duy trì V1 suốt ba năm qua. Với V3, mọi thay đổi phá vỡ sẽ chỉ thuộc một trong hai loại: sửa lỗi về tính đúng đắn, ví dụ một lỗi chỉ ảnh hưởng tới thiểu số người dùng; hoặc thay đổi mà bạn có thể dễ dàng chọn quay lại hành vi cũ. Không có cuộc đại tu API nào ở quy mô V1 lên V2.

V1 chính thức “về hưu”

Pydantic V1.10.27 là bản V1 cuối cùng, chứa các bản sửa bảo mật. Các bản sửa này cũng có mặt trong namespace pydantic.v1 đi kèm Pydantic V2.14.2. Nhưng từ đây, hỗ trợ V1 kết thúc hoàn toàn, kể cả namespace pydantic.v1 trong V2: lỗi bảo mật mới phát hiện sẽ không được sửa. Nếu dự án của bạn vẫn chạy V1 trong production, đây là thời điểm phải lên kế hoạch rời khỏi nó, thay vì chờ thêm một bản vá nữa.

V2 thì sao?

Sau khi V3 ra mắt, V2 vẫn tiếp tục nhận bản vá cho lỗi lớn và lỗi bảo mật, và chưa có ngày kết thúc: đội ngũ Pydantic khẳng định sẽ không bỏ V2 cho tới khi tin rằng đa số người dùng đã chuyển sang V3. Pydantic vẫn là mã nguồn mở hoàn toàn, và các đội cần hỗ trợ migration có thể mua gói enterprise support.

Điều này có ý nghĩa gì với bạn

Đừng hoảng vì chữ “major release”: V3 được thiết kế để nâng cấp nhẹ nhàng, không phải viết lại. Kiểm tra ngay dự án của bạn còn import từ pydantic.v1 hay còn dùng Pydantic V1 không — nếu có, hãy lên V2.14.2 trước, vì đó là cầu nối an toàn nhất sang V3. Và đừng vội khi V3 ra mắt: chờ bản ổn định, chạy test suite rồi mới nâng cấp production.

Bài viết liên quan

Câu hỏi thường gặp

Pydantic V3 ra mắt khi nào?

Chưa có ngày phát hành cụ thể. Đội ngũ Pydantic đặt mục tiêu đưa V3 gần trạng thái hoàn thiện cuối năm 2026.

Tôi đang dùng Pydantic V2, có cần làm gì ngay không?

Không. V2 vẫn nhận bản vá lỗi lớn và bảo mật sau khi V3 ra mắt, và chỉ bị bỏ khi đa số người dùng đã chuyển sang V3.

Dự án của tôi vẫn dùng Pydantic V1 thì sao?

Hãy lên kế hoạch rời khỏi V1 càng sớm càng tốt. V1.10.27 là bản cuối cùng và mọi lỗi bảo mật mới sẽ không được sửa, kể cả trong namespace pydantic.v1 của V2. Lên V2.14.2 là bước đi an toàn nhất trước khi V3 ra mắt.

💬 Tin này ảnh hưởng tới dự án của bạn thế nào? Chia sẻ góc nhìn của bạn trong phần bình luận — mình đọc hết và sẽ tổng hợp những ý hay nhất.

Nguồn tham khảo