5 Lỗi Định Dạng JSON Thường Gặp Khiến API Bị Lỗi

Dấu phẩy thừa ở cuối

Dấu phẩy thừa sau phần tử cuối cùng trong object hoặc array là hợp lệ trong JavaScript nhưng không hợp lệ trong JSON:

{
  "name": "Alice",
  "role": "admin",
}

Dán đoạn này vào công cụ JSON formatter và lỗi dấu phẩy thừa sẽ được phát hiện ngay lập tức.

Key không có dấu ngoặc kép hoặc dùng dấu nháy đơn

JSON yêu cầu dấu ngoặc kép cho mọi key và giá trị chuỗi. Dấu nháy đơn hoặc key không có dấu ngoặc là lỗi thường gặp khi copy từ mã JavaScript.

Key trùng lặp

Key trùng lặp về mặt kỹ thuật vẫn hợp lệ theo chuẩn JSON, nhưng các trình phân tích cú pháp xử lý không nhất quán — có trình giữ giá trị đầu, có trình giữ giá trị cuối. Tốt nhất nên tránh hoàn toàn.

Trộn lẫn kiểu dữ liệu

Giữ kiểu dữ liệu của một trường nhất quán xuyên suốt (luôn là chuỗi, luôn là số) giúp bên tiêu thụ dữ liệu không phải viết code kiểm tra kiểu phòng thủ ở khắp nơi.

Không kiểm tra trước khi deploy

Cách rẻ nhất là phát hiện lỗi trước khi đưa lên production. Hãy dán payload vào công cụ formatter/validator như một bước trong quy trình làm việc, không phải sau khi nhận báo cáo lỗi.