Nâng cao

Xử lý sự cố

Viewer trống hoặc hiện lỗi. Ý nghĩa của từng mã và việc cần đổi, từ console của trình duyệt đến Dashboard.

Bắt đầu từ điều bạn thấy trên trang. Ba trường hợp dưới đây cho biết lỗi xảy ra ở đâu. Mỗi lỗi có một mã viết hoa, và mã đó cho biết nguyên nhân.

Trình xem trống hoặc hiển thị lỗi

Bạn nhìn thấy gì trên trang?

Vùng chứa trống, không có iframe
Console hoặc sự kiện VIEWER_ERROR hiển thị nội dung gì?
- SERVICE_UNAVAILABLEKhông nhận được phản hồi. Hãy kiểm tra endpoint của bạn, kết nối mạng và giới hạn thời gian 15 giây.
- LICENSE_KEY_MISSING, LICENSE_KEY_INVALID, LICENSE_INACTIVE, LICENSE_KEY_SHOP_MISMATCHKiểm tra License key trên máy chủ, ngày hết hạn và cửa hàng tương ứng.
- SHOWCASE_NOT_FOUND, SHOWCASE_NOT_ACTIVATED, SHOWCASE_NOT_IN_PRODUCTIONKiểm tra Showcase ID, trạng thái kích hoạt cửa hàng và bảo đảm bạn đang sử dụng mã production.
- EXCHANGE_TOKEN_INVALIDMã đã được sử dụng hoặc đã quá 60 giây. Hãy kiểm tra HTML được lưu cache hoặc mã bị tái sử dụng.
- ORIGIN_NOT_ALLOWEDThêm tên miền của trang vào danh sách tên miền được phép của Showcase.
- RATE_LIMITEDCó quá nhiều yêu cầu từ cùng một địa chỉ. Hãy chờ rồi tải lại trang.
Trình xem mở ra và hiển thị thẻ chứa mã lỗi
Mã nào được hiển thị trên thẻ?
- SHOWCASE_NOT_ACTIVATEDCửa hàng của bạn chưa được kích hoạt.
- SHOWCASE_DISABLED, SHOWCASE_NOT_FOUNDShowcase đã bị tắt hoặc xóa khỏi Dashboard.
- ORIGIN_NOT_ALLOWEDDanh sách tên miền đã thay đổi hoặc trang đang chạy trên một máy chủ khác.
- SESSION_EXPIRED, SESSION_INVALIDNhấn Tải lại. Nếu lỗi tiếp tục xuất hiện, hãy kiểm tra endpoint của bạn.
- RATE_LIMITED, SERVICE_UNAVAILABLEDịch vụ đang bận. Nhấn Thử lại.
- PREVIEW_ENDED, PREVIEW_NOT_ENABLED_HERE, PREVIEW_PAGE_LIMIT, PREVIEW_DAILY_LIMIT, PREVIEW_UNAVAILABLEĐang áp dụng một quy tắc Preview. Xem mục Khắc phục sự cố.
Mô hình hiển thị kèm một thông báo nhỏ
Thông báo nào đang xuất hiện?
- Nội dung mẫuShowcase vẫn đang chứa nội dung mẫu của ngành hàng của bạn.
- Bản xem trướcTrang đang chạy ở chế độ Preview, không phải production.
- Gói dùng thử/gói dịch vụ đã hết hạn, vui lòng gia hạn sớmGiấy phép đã quá hạn hoặc cửa hàng đã sử dụng hết lượt xem trong tháng. Trình xem vẫn tiếp tục hoạt động.

Tìm mã ở đâu

Trong console của trình duyệt, SDK ghi [Comnoira SDK] init failed kèm lỗi. Trang của bạn cũng đọc được mã từ sự kiện VIEWER_ERROR, mang theo { code, message, fatal }. Khi chính Viewer hiện thẻ lỗi, mã được in nhỏ trên thẻ.

Trường hợp 1: khung chứa vẫn trống

Không có iframe nào xuất hiện, nghĩa là lỗi xảy ra trước khi Viewer khởi động. Mã trong console hoặc trong VIEWER_ERROR cho biết bước nào lỗi.

SERVICE_UNAVAILABLE: SDK không nhận được phản hồi. Route của bạn trả lỗi hoặc bị lỗi, khách mất mạng, hoặc một request chạy quá 15 giây. Mở tab network và xem route của bạn trước.
LICENSE_KEY_MISSING, LICENSE_KEY_INVALID, LICENSE_INACTIVE, LICENSE_KEY_SHOP_MISMATCH: lời gọi từ server của bạn bị từ chối. Đọc phản hồi của POST /api/v1/viewer/session trong log server. Kiểm tra biến môi trường chứa đúng License key, license chưa quá ngày hết hạn, và key thuộc đúng shop sở hữu Showcase.
SHOWCASE_NOT_FOUND: Showcase ID sai, hoặc Showcase không hoạt động.
SHOWCASE_NOT_ACTIVATED: shop của bạn chưa kích hoạt. Dùng Preview cho đến khi Comnoira kích hoạt.
SHOWCASE_NOT_IN_PRODUCTION: Showcase là demo hoặc Preview. Hãy dùng mã production.
EXCHANGE_TOKEN_INVALID: mã đã được dùng hoặc quá 60 giây. Tìm HTML trang bị cache có chứa mã, route trả cùng một mã hai lần, hoặc trang khởi động SDK hai lần với một mã.
ORIGIN_NOT_ALLOWED: domain của trang không có trong danh sách domain được phép của Showcase. Thêm đúng host, hoặc *.tên-miền-của-bạn, trong Dashboard.
RATE_LIMITED: quá nhiều request từ một địa chỉ. Chờ một lúc rồi tải lại.
Container #id not found trong console: tuỳ chọn container chỉ tới phần tử chưa tồn tại lúc init chạy. Viết id không có # và gọi init sau khi phần tử đã có.

Trường hợp 2: Viewer mở ra và hiện một thẻ

Phiên đã chạy được và Viewer đã hỏi Backend về Showcase. Một thẻ có tiêu đề và một mã nhỏ xuất hiện.

SHOWCASE_NOT_ACTIVATED: "Trưng bày này chưa sẵn sàng." Shop chưa kích hoạt.
SHOWCASE_DISABLED hoặc SHOWCASE_NOT_FOUND: "Trưng bày này hiện không khả dụng." Showcase đã bị tắt hoặc xoá trong Dashboard.
ORIGIN_NOT_ALLOWED: "Website này không được phép hiển thị Trưng bày này." Danh sách domain đã đổi, hoặc khách vào trang qua một host khác. Thẻ này cũng hiện khi SDK gia hạn phiên.
SESSION_EXPIRED hoặc SESSION_INVALID: "Phiên của bạn đã hết hạn." Thẻ có nút Tải lại, và SDK xin phiên mới. Nếu thẻ cứ quay lại, kiểm tra route của bạn còn chạy không.
RATE_LIMITED hoặc SERVICE_UNAVAILABLE: thẻ báo dịch vụ đang bận và có nút Thử lại.

Trên Preview còn có các mã sau. PREVIEW_ENDED: Preview quá ngày kết thúc hoặc đã dùng hết số phiên. PREVIEW_NOT_ENABLED_HERE: trang không nằm trên website bạn đã xác minh, hoặc việc xác minh chưa xong. PREVIEW_PAGE_LIMIT: Preview đã mở trên nhiều trang hơn mức cho phép. PREVIEW_DAILY_LIMIT: hết hạn mức của hôm nay. PREVIEW_UNAVAILABLE: Comnoira đang tắt Preview.

Trường hợp 3: mô hình hiện ra, kèm một thông báo nhỏ

"Sample content" ở phía trên: Showcase vẫn chứa nội dung mẫu của ngành bạn. Mô hình của bạn thay thế nó khi Comnoira thêm vào Showcase.
"Preview": trang đang chạy Preview, chưa phải production.
"Bản dùng thử hoặc gói đã hết hạn, hãy gia hạn" ở phía dưới: phiên bị đánh dấu vì license quá ngày hết hạn, hoặc shop đã dùng hết số lượt xem hàng tháng của gói. Viewer vẫn chạy. Hãy liên hệ Comnoira về gói.

Vẫn chưa được

Viết tới liftmira@comnosoft.com kèm mã lỗi, địa chỉ trang và thời điểm thử.

Checklist trước khi lên production