Data Contract

Mar 31, 2026

Table of Contents

Data Contract: Vì sao chỉ một thay đổi nhỏ có thể “làm sập” cả hệ thống?

Trong các hệ thống hiện đại (microservices, data pipeline, API-first), một vấn đề rất phổ biến nhưng thường bị xem nhẹ là:

Thay đổi cấu trúc dữ liệu mà không kiểm soát

Chỉ cần một service đổi format response — có thể kéo theo hàng loạt lỗi ở các hệ thống phía sau.

Đây chính là lý do Data Contract ngày càng trở nên quan trọng.

Giả sử bạn có API trả về:

{

“user_id”: “123”,

“email”: “user@example.com”

}

Một ngày nào đó, team backend “refactor nhẹ”:

{

“id”: “123”,

“email”: “user@example.com”

}

Nghe có vẻ vô hại. Nhưng thực tế:

👉 Tất cả chỉ vì đổi tên một field.

Data Contract là:

Cam kết rõ ràng về cấu trúc và ý nghĩa dữ liệu giữa các hệ thống

Nó định nghĩa:

Ví dụ:

{

“user_id”: “string (required)”,

“email”: “string (required)”,

“created_at”: “ISO8601 (optional)”

}

👉 Khi đã là contract:

Trong hệ thống lớn, đây gần như là “bom nổ chậm”.

❌ Tránh:

✅ Thay vào đó:

Ví dụ:

/api/v1/users

/api/v2/users

Giúp client có thời gian migrate

👉 Nói ngắn gọn: hầu hết hệ thống hiện đại đều cần

Trong hệ thống đơn giản, thay đổi data có thể chỉ gây lỗi nhỏ.
Nhưng trong hệ thống lớn, nó có thể gây:

❗ Lỗi dây chuyền
❗ Sai dữ liệu
❗ Ảnh hưởng production diện rộng

Data Contract giúp chuyển từ:

❌ “Ai thích đổi gì thì đổi”
→
✅ “Mọi thay đổi đều có kiểm soát và an toàn”

You need to login in order to like this post: click here