Kiểm tra & Định dạng JSON

JSON là gì?

JSON (JavaScript Object Notation) là định dạng văn bản nhẹ dùng để lưu trữ và trao đổi dữ liệu. Được đề xuất bởi Douglas Crockford vào đầu những năm 2000, JSON trở thành chuẩn trao đổi dữ liệu phổ biến nhất trên internet nhờ cú pháp đơn giản, dễ đọc với con người và dễ phân tích bởi máy tính.

Không giống XML hay CSV, JSON có thể biểu diễn cấu trúc dữ liệu phức tạp gồm các đối tượng lồng nhau và mảng nhiều chiều. Điều này khiến JSON trở thành lựa chọn hàng đầu cho API REST, file cấu hình ứng dụng, cơ sở dữ liệu NoSQL như MongoDB, và lưu trữ cài đặt trong các ứng dụng web hiện đại.

JSON được chuẩn hóa theo RFC 8259 và ECMA-404. Chuẩn này định nghĩa chính xác những gì hợp lệ — từ cách viết chuỗi, số, giá trị boolean, cho đến cách cấu trúc đối tượng và mảng. Bất kỳ sai lệch nào so với chuẩn đều khiến JSON trở nên không hợp lệ.

Quy tắc cú pháp JSON

JSON có 6 kiểu dữ liệu cơ bản:

• Chuỗi (String): Phải được bao bởi dấu ngoặc kép đôi. Ví dụ: "Xin chào". Dấu ngoặc đơn (') không hợp lệ trong JSON.
• Số (Number): Nguyên hoặc thập phân, có thể âm hoặc dùng ký hiệu khoa học. Ví dụ: 42, -3.14, 1.5e10.
• Boolean: Chỉ có hai giá trị true và false — bắt buộc viết thường.
• Null: Từ khóa null (viết thường) biểu thị giá trị rỗng/không có.
• Đối tượng (Object): Tập hợp các cặp khóa-giá trị trong dấu ngoặc nhọn {}. Mỗi khóa phải là chuỗi trong ngoặc kép.
• Mảng (Array): Danh sách các giá trị trong dấu ngoặc vuông [], phân cách bằng dấu phẩy.

Những điều JSON không cho phép: chú thích (cả // và /* */), dấu phẩy thừa sau phần tử cuối cùng, khóa không có dấu ngoặc kép, và các giá trị đặc biệt như undefined, NaN, hay Infinity.

Lỗi JSON thường gặp và cách sửa

1. Dấu phẩy thừa (Trailing Comma)

Đây là lỗi phổ biến nhất khi lập trình viên viết JSON theo thói quen JavaScript. JSON nghiêm ngặt không cho phép dấu phẩy sau phần tử cuối cùng trong đối tượng hoặc mảng. Để tránh: luôn kiểm tra phần tử cuối cùng trước dấu } hoặc ].

2. Thiếu dấu ngoặc kép cho khóa

Trong JavaScript, bạn có thể viết { name: 'Alice' } — nhưng trong JSON, khóa phải luôn có dấu ngoặc kép: { "name": "Alice" }. Đây là nguồn gốc của nhiều lỗi khi sao chép trực tiếp từ code JS sang JSON.

3. Chú thích trong JSON

JSON thuần túy không hỗ trợ chú thích. Nếu bạn cần comment trong file cấu hình, hãy cân nhắc dùng YAML hoặc TOML thay thế. Ngoài ra, một số tool như VS Code hỗ trợ định dạng JSONC (JSON with Comments) riêng — nhưng đây không phải JSON chuẩn.

4. Chuỗi chưa đóng (Unterminated String)

Xảy ra khi chuỗi văn bản bị ngắt giữa chừng hoặc thiếu dấu ngoặc đóng. Thường gặp khi copy-paste nội dung có chứa dấu ngoặc kép bên trong mà không được escape đúng cách (\").

So sánh JSON, XML và YAML

Kết luận: JSON thắng ở REST API và web; YAML thắng ở file cấu hình (Kubernetes, Docker Compose, CI/CD); XML vẫn được dùng trong hệ thống doanh nghiệp cũ (SOAP, RSS, XSLT).

Thực hành tốt để viết JSON hợp lệ

• Luôn dùng trình soạn thảo có highlight cú pháp JSON (VS Code, JetBrains) — lỗi sẽ được tô màu ngay.
• Dùng linter JSON trong pipeline CI/CD — đừng đợi đến production mới phát hiện lỗi.
• Khi tạo JSON động bằng code, dùng JSON.stringify() (JavaScript) hoặc json.dumps() (Python) thay vì ghép chuỗi thủ công.
• Validate JSON sau mỗi lần chỉnh sửa thủ công — đặc biệt khi thêm hoặc xóa phần tử.
• Đặt tên khóa nhất quán: nên dùng camelCase hoặc snake_case xuyên suốt, không trộn lẫn.
• Tránh dùng ký tự đặc biệt trong khóa — dù hợp lệ nhưng khó đọc và dễ gây lỗi khi truy cập bằng code.