Lỗi schema thường gặp và cách kiểm tra bằng Rich Results Test

Schema có thể xuất hiện trong mã nguồn nhưng Google vẫn báo lỗi. Ngược lại, Rich Results Test có thể báo hợp lệ nhưng kết quả tìm kiếm không hiển thị thêm hình ảnh, đánh giá, breadcrumb hoặc thông tin ngày đăng như bạn mong đợi.

Hai tình huống này thường bị gộp thành một kết luận: “Schema không hoạt động”. Thực tế, bạn cần tách ba câu hỏi khác nhau: mã có đúng cú pháp không, dữ liệu có đáp ứng yêu cầu của Google cho loại rich result đó không và trang có được Google chọn để hiển thị rich result không.

Bài viết này hướng dẫn cách đọc thông báo trong Rich Results Test, xử lý sáu lỗi schema thường gặp và theo dõi lỗi trên nhiều URL bằng Google Search Console. Nếu chưa nắm nền tảng, bạn có thể đọc trước bài Schema Markup là gì?.

Error và Warning khác nhau thế nào?

Rich Results Test có thể trả về item hợp lệ, item hợp lệ kèm cảnh báo hoặc item không hợp lệ. Mức độ xử lý không giống nhau.

Không nên xử lý cảnh báo bằng cách điền dữ liệu cho đủ màu xanh. Mỗi loại schema có bộ yêu cầu riêng. Tài liệu Article hiện tại không đặt thuộc tính bắt buộc, còn Recipe, Event hoặc Product có thể có trường bắt buộc cho tính năng tương ứng. Vì vậy, luôn đối chiếu thông báo với đúng tài liệu trước khi sửa.

Rich Results Test và Schema Markup Validator dùng khi nào?

Hai công cụ này không làm cùng một việc.

Quy trình phù hợp là kiểm tra cú pháp, kiểm tra khả năng tạo rich result, rồi xem phiên bản Google thu thập trên trang đã xuất bản.

Sáu lỗi schema thường gặp và cách sửa

Các thông báo dưới đây được lấy theo cách gọi trong tài liệu trợ giúp của Google. Giao diện có thể hiển thị thêm tên trường hoặc loại schema cụ thể tùy URL.

1. Parsing error: Missing ‘,’ or ‘}’

Đây là lỗi cú pháp JSON-LD. Thiếu dấu phẩy, sai dấu ngoặc hoặc mã bị cắt giữa chừng có thể khiến Google không xác định được loại schema.

Ví dụ sai:

{
  "@context": "https://schema.org"
  "@type": "Article",
  "headline": "Lỗi schema thường gặp"
}

Giữa @context và @type đang thiếu dấu phẩy. Nếu lỗi xuất hiện trên nhiều URL, kiểm tra template, đoạn chèn code hoặc plugin tạo schema trước khi sửa từng bài.

[Ảnh chèn 1: Rich Results Test hiển thị lỗi “Parsing error: Missing ‘,’ or ‘}’”, che URL nếu dùng dữ liệu dự án.]

2. Duplicate unique property

Thông báo này xuất hiện khi một thuộc tính chỉ được phép khai báo một lần nhưng lại có hai định nghĩa trong cùng đối tượng. Ví dụ thường gặp là lặp @context:

{
  "@context": "https://schema.org",
  "@context": "https://schema.org",
  "@type": "Article"
}

Cần xóa thuộc tính bị lặp và kiểm tra nơi sinh mã. Đừng nhầm lỗi này với việc một trang có nhiều đối tượng trong @graph. WebPage, Article, Person và BreadcrumbList có thể cùng tồn tại nếu mỗi đối tượng mô tả đúng nội dung.

[Ảnh chèn 2: Thông báo “Duplicate unique property” và vị trí thuộc tính lặp trong code explorer.]

3. Missing field “property name”

Thông báo xuất hiện khi một trường cần thiết cho loại rich result bị thiếu hoặc có giá trị rỗng. Trước khi thêm, cần xác nhận trường đó là bắt buộc hay chỉ được khuyến nghị, dữ liệu có hiển thị trên trang không và nó thuộc đối tượng nào. Nếu Breadcrumb thiếu name, phải sửa đúng tên mục breadcrumb thay vì lấy một tiêu đề bất kỳ để điền vào.

Riêng với Article Schema, cần cẩn thận khi đọc các hướng dẫn cũ nói rằng mọi bài viết bắt buộc phải có publisher hoặc logo. Tài liệu Google hiện ghi các thuộc tính được hỗ trợ dưới dạng khuyến nghị và không đặt thuộc tính bắt buộc cho Article.

[Ảnh chèn 3: Lỗi “Missing field” được mở rộng để thấy tên trường và item bị ảnh hưởng.]

4. Invalid object type for field “property name”

Lỗi xảy ra khi giá trị có mặt nhưng sai kiểu. Với author, một chuỗi văn bản không phản ánh cấu trúc Person hoặc Organization mà tài liệu yêu cầu.

Khai báo chưa phù hợp:

"author": "Mai Kim Tuyến"

Cấu trúc rõ hơn:

"author": {
  "@type": "Person",
  "name": "Mai Kim Tuyến",
  "url": "https://maikimtuyen.com/tuyen-la-ai-seo-strategist"
}

Lỗi cũng xuất hiện khi trường cần số nhưng nhận chuỗi, cần mảng nhưng nhận một đối tượng hoặc cần URL nhưng nhận văn bản thường.

Nếu đang xử lý riêng schema bài viết trên WordPress, phần Article Schema cho blog WordPress giải thích kỹ hơn cách nối tác giả và trang hồ sơ.

[Ảnh chèn 4: Thông báo “Invalid object type for field” kèm trường đang nhận sai kiểu dữ liệu.]

5. Datetime property is missing a timezone hoặc Invalid datetime value

Ngày giờ cần dùng định dạng ISO 8601. Giá trị như 28/08/2026 9:00 sáng không phù hợp trong JSON-LD.

Ví dụ thiếu múi giờ:

"datePublished": "2026-08-28T09:00:00"

Ví dụ có múi giờ Việt Nam:

"datePublished": "2026-08-28T09:00:00+07:00"

dateModified chỉ nên phản ánh lần sửa nội dung có ý nghĩa, không phải mỗi lần trang được tải.

[Ảnh chèn 5: Cảnh báo thiếu múi giờ hoặc lỗi giá trị datetime trong Rich Results Test.]

6. Invalid or unsupported @context value

Trong JSON-LD dành cho Google Search, @context thường được khai báo là:

"@context": "https://schema.org"

Viết thành https://schema.com, dùng context tùy chỉnh không được hỗ trợ hoặc để URL thiếu ký tự đều có thể gây lỗi. Nếu plugin đã tạo @context, không thêm một đoạn khác bằng tay.

[Ảnh chèn 6: Thông báo “Invalid or unsupported @context value” và giá trị sai trong code explorer.]

Vì sao schema hợp lệ vẫn không hiện rich result?

Màu xanh chỉ xác nhận công cụ không phát hiện lỗi làm item mất hiệu lực trong phạm vi kiểm tra. Google không cam kết trang hợp lệ sẽ luôn có rich result.

Schema.org có nhiều kiểu hơn danh sách tính năng tìm kiếm của Google. Vì vậy, mã có thể hợp lệ trong Schema Markup Validator nhưng Rich Results Test báo “No items detected”. Dữ liệu cũng phải đại diện cho nội dung chính và hiện diện trên trang; review không hiển thị, Product gắn cho bài tư vấn hoặc FAQ chỉ có trong mã đều có thể bị bỏ qua.

Rich Results Test kiểm tra trang đang hoạt động, còn kết quả tìm kiếm có thể dựa trên phiên bản Google thu thập trước đó. Dùng URL Inspection sau khi sửa. Ngay cả khi đã đủ điều kiện, Google vẫn có thể chọn kết quả văn bản theo truy vấn, thiết bị, vị trí và các tín hiệu khác.

Theo dõi lỗi schema hàng loạt trong Google Search Console

Rich Results Test phù hợp với một URL hoặc đoạn mã. Khi lỗi đến từ template và ảnh hưởng nhiều trang, cần theo dõi bằng Search Console.

Sau khi vào thuộc tính website, kiểm tra hai nhóm báo cáo:

1. Báo cáo theo loại rich result trong mục Enhancements hoặc Shopping, tùy cấu trúc website.
2. Báo cáo Unparsable structured data dành cho lỗi cú pháp nghiêm trọng khiến Google chưa xác định được loại dữ liệu.

Mở từng vấn đề, lấy vài URL đại diện và xác định mẫu trang chung. Nếu lỗi nằm ở template, sửa nguồn sinh mã trước thay vì sửa từng URL.

Có thể phân mức ưu tiên như sau:

Sau khi sửa nhóm URL bị ảnh hưởng, dùng Validate Fix. Google cần thu thập lại trang nên kết quả xác nhận không xuất hiện ngay.

Nếu chưa cài hoặc chưa quen với báo cáo của công cụ, bạn có thể xem 7 bước cài đặt Google Search Console cho website.

Checklist kiểm tra trước khi kết luận schema bị lỗi

• Dùng đúng công cụ cho cú pháp, rich result và trạng thái lập chỉ mục.
• Phân biệt Error với Warning trước khi sửa.
• Đối chiếu tài liệu riêng của loại schema đang dùng.
• So sánh dữ liệu trong mã với nội dung hiển thị.
• Kiểm tra theme và plugin có cùng tạo schema không.
• Theo dõi lỗi theo mẫu trang trong Search Console.

Lỗi schema hiếm khi nên được xử lý bằng cách thêm thật nhiều trường. Mục tiêu là dữ liệu đúng cú pháp, đúng kiểu, đúng nội dung và phản ánh nhất quán những gì đang có trên trang.

Nếu lỗi xuất hiện hàng loạt, không rõ nguồn sinh mã hoặc liên quan nhiều plugin, một đợt audit technical website sẽ giúp xác định lỗi nằm ở template, plugin, dữ liệu nhập hay khả năng Google truy cập trang.

Nguồn tham khảo:

• Google Search Console Help: Rich Results Test
• Google Search Console Help: Rich result error messages and solutions
• Google Search Console Help: Unparsable structured data report
• Google Search Console Help: Fix structured data issues
• Google Search Central: General structured data guidelines
• Schema.org: Schema Markup Validator