Kiểm tra và Debug Structured Data: Công cụ và quy trình phát hiện lỗi schema

Schema sai phổ biến hơn bạn nghĩ

Qua kiểm tra hàng trăm website Việt Nam, hơn 70% có ít nhất một lỗi schema nghiêm trọng — lỗi mà chủ website hoàn toàn không biết đến vì trang trông bình thường trên trình duyệt của người dùng.

Schema sai không gây ra lỗi hiển thị. Nó âm thầm khiến Google và AI bỏ qua toàn bộ dữ liệu cấu trúc mà bạn dày công khai báo. Kết quả: không có rich results, không được AI trích dẫn, mất lợi thế cạnh tranh so với đối thủ đã làm đúng.

Tin tốt là các lỗi này đều có thể phát hiện và sửa được trong vài giờ — nếu bạn biết dùng đúng công cụ và có quy trình kiểm tra rõ ràng.

Ba công cụ kiểm tra structured data cần biết

Mỗi công cụ phát hiện một loại vấn đề khác nhau — đừng chỉ dùng một. Rich Results Test có thể bỏ qua lỗi property không nằm trong whitelist của Google, trong khi Schema Markup Validator lại phát hiện được.

Top 10 lỗi schema phổ biến và cách fix

Ví dụ JSON-LD FAQPage đúng chuẩn

Dưới đây là ví dụ FAQPage schema hoàn chỉnh — dạng schema hay có lỗi nhất trong thực tế:

{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "Schema markup là gì và tại sao quan trọng với AEO?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Schema markup là đoạn code JSON-LD giúp search engine và AI hiểu ngữ nghĩa nội dung website. Khi khai báo đúng, nội dung được hiển thị dưới dạng Rich Results trên Google và được AI trích dẫn chính xác hơn khi trả lời câu hỏi người dùng. Đây là nền tảng của AEO."
      }
    },
    {
      "@type": "Question",
      "name": "Khai báo schema ở đâu trong website Next.js?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Khai báo trong thẻ script với type='application/ld+json' trong phần head hoặc body của trang. Với Next.js App Router, đặt trong component Script của next/script hoặc trực tiếp trong layout.tsx. JSON-LD dễ bảo trì hơn microdata hoặc RDFa nên được khuyến nghị dùng."
      }
    }
  ]
}

Walkthrough: Kiểm tra schema với Rich Results Test

Bước 1: Truy cập search.google.com/test/rich-results. Nhập URL trang cần kiểm tra (ưu tiên) hoặc paste HTML source code nếu trang chưa live.

Bước 2: Tool xử lý trong 10-30 giây. Kết quả hiển thị 2 vùng chính:

• Eligible rich results: Danh sách loại rich result trang này đủ điều kiện — FAQ accordion, review stars, recipe card. Đây là mục tiêu cần đạt.
• Detected structured data: Tất cả schema được Google parse, kể cả loại không tạo rich result trực tiếp.

Bước 3: Click vào từng schema trong "Detected structured data" để xem chi tiết. Lỗi màu đỏ là required field bị thiếu và phải fix ngay. Cảnh báo màu vàng là recommended field bị thiếu — nên fix nhưng không bắt buộc.

Bước 4: Với mỗi lỗi đỏ, tool hiển thị tên property bị thiếu. Mở code editor, tìm schema đó và thêm property còn thiếu vào đúng vị trí.

Bước 5: Sau khi fix, nhấn "Test" lại ngay trên trang Rich Results Test với code mới — không cần deploy lên live site để test trước.

Lỗi thường gặp theo từng loại schema

Quy trình debug 5 bước khi schema không hoạt động

Bước 1 — Kiểm tra JSON syntax: Mở DevTools (F12) → Console, chạy lệnh:

JSON.parse(
  document.querySelector('script[type="application/ld+json"]').textContent
)

Nếu Console báo lỗi, schema của bạn có syntax error. Dùng jsonlint.com để tìm chính xác dòng lỗi — thường là dấu phẩy thừa sau item cuối cùng, hoặc quote chưa đóng.

Bước 2 — Validate với Rich Results Test: Kiểm tra Google có nhận diện schema không và báo lỗi gì.

Bước 3 — Validate với Schema Markup Validator: Kiểm tra các lỗi property/type mà Rich Results Test không phát hiện.

Bước 4 — Kiểm tra page indexing: Gõ site:domain.com/duong-dan-trang vào Google. Nếu trang chưa index thì schema dù đúng cũng không có tác dụng — phải đợi Google crawl.

Bước 5 — Chờ và yêu cầu reprocess: Sau khi sửa, vào Google Search Console → URL Inspection → Request Indexing. Kết quả rich result có thể mất 1-4 tuần để xuất hiện.

Search Console monitoring workflow

Đặt lịch kiểm tra Search Console hàng tuần, tập trung vào tab Enhancements (hoặc Rich Results). Dashboard này hiển thị:

• Số page có lỗi schema theo từng loại (FAQ, HowTo, Article, Product...)
• Xu hướng lỗi tăng/giảm theo thời gian
• Tên lỗi cụ thể và số URL bị ảnh hưởng

Khi số lỗi tăng đột biến trong 1 tuần, thường có 2 nguyên nhân: deploy code mới làm hỏng template schema, hoặc Google cập nhật yêu cầu cho loại rich result đó. Vào phần thông báo của Search Console để xem Google có gửi message nào không.

Đặt email alert trong Search Console để nhận thông báo ngay khi có issue mới — đừng để lỗi âm thầm tồn tại hàng tuần trước khi bạn phát hiện.

Checklist trước khi deploy schema mới

1. Validate JSON syntax bằng jsonlint.com hoặc DevTools Console
2. Kiểm tra với Rich Results Test trên URL staging hoặc bằng HTML paste
3. Validate với Schema Markup Validator tại validator.schema.org
4. Xác nhận tất cả @id là URL tuyệt đối và unique trên toàn site
5. Xác nhận datePublished và dateModified theo format ISO 8601
6. Xác nhận ảnh có width và height (tối thiểu 1200px wide)
7. Xác nhận NAP nhất quán với Google Business Profile (với LocalBusiness schema)
8. Xác nhận schema mô tả đúng nội dung page — không khai báo thông tin không có trong page
9. Deploy xong → Request Indexing trong Google Search Console
10. Theo dõi Search Console sau 2-4 tuần để xác nhận rich results xuất hiện

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