Mã lỗi và cách xử lý

Mã lỗi và cách xử lý

Thông báo/mã	Ý nghĩa thường gặp	Cách xử lý	Tài liệu
Không thể tải dashboard.	Lỗi request hoặc dịch vụ dashboard không trả dữ liệu.	Kiểm tra mạng/API, game đang chọn và thử tải lại; ghi nhận thời điểm nếu lỗi lặp.	Mở
Bạn không có quyền xem dashboard của game này.	403 hoặc thiếu quyền/scope DASHBOARD_KPI/READ.	Xác nhận đúng game; nhờ admin kiểm tra grant, không đổi game sang scope không được cấp.	Mở
Không thể tải ingestion health.	Health request hoặc nguồn health bị lỗi/timeout.	Kiểm tra dịch vụ và freshness; đối chiếu health endpoint, rồi chuyển vận hành nếu lặp lại.	Mở
Bạn không có quyền xem ingestion health.	403 hoặc thiếu INFRA_HEALTH/READ trong scope.	Nhờ admin xác minh role và game scope.	Mở
403 iap_disabled	IAP feature flag của game đang tắt.	Xác minh game, flag và trạng thái provider; chỉ người được giao mới bật.	Mở
forbidden / HTTP 403	Phiên hợp lệ nhưng thiếu action/scope hoặc step-up chưa đạt.	Xác minh role, game, điều kiện flag và MFA; không thử lách permission.	Mở
401 / phiên hết hạn	Access token/session không còn hợp lệ.	Đăng nhập lại theo quy trình; nếu lặp, chuyển admin kiểm tra trạng thái tài khoản.	Mở
409 / conflict	Trạng thái thay đổi hoặc request trùng/xung đột.	Tải lại bản ghi, kiểm tra trạng thái mới và tránh submit lặp mutation.	Mở
429 / rate limit	Có quá nhiều request trong khoảng ngắn.	Chờ theo hướng dẫn retry; không lặp tự động liên tục.	Mở
Telegram chat not found / 403	Chat ID sai, bot chưa được Start hoặc chưa ở trong group.	Kiểm tra chat target và quyền bot trong sandbox; gửi test lại.	Mở
SMTP_HOST and SMTP_FROM_EMAIL are required	Thiếu cấu hình SMTP hoặc backend chưa nạp cấu hình.	Điền cấu hình qua secret management, khởi động lại backend theo runbook và thử channel.	Mở
SMTPAuthenticationError	Thông tin SMTP sai hoặc nhà cung cấp yêu cầu app password.	Đổi credentials qua secret management; không dán password vào ticket/log.	Mở
502 sau deploy	Nginx hoặc upstream chưa sẵn sàng / trỏ tới địa chỉ cũ.	Kiểm tra health/log theo runbook, xác minh upstream rồi reload theo quy trình.	Mở
Dashboard thiếu số liệu	Khoảng thời gian, currency hoặc ingestion chưa khớp.	So filter/freshness với Health và nguồn dữ liệu; không coi missing là 0.	Mở
MFA step-up bị từ chối	Mã hết hạn, lệch thời gian hoặc phiên step-up không hợp lệ.	Dùng mã mới từ thiết bị đã đăng ký; kiểm tra đồng hồ và enroll qua admin nếu cần.	Mở

Thông báo có thể thay đổi theo phiên bản Portal; nếu nội dung thực tế khác bảng, giữ nguyên thông báo an toàn và ghi nhận phiên bản/màn hình để cập nhật hướng dẫn.