# Lỗi thường gặp

> Cách xử lý các lỗi hay gặp khi đăng nhập, tải phiên bản, đọc kết quả kiểm, dùng Hỏi AI, Tệp của tôi, CLI và MCP.

Bảng dưới gom các hiện tượng hay gặp và cách xử lý. Không thấy trường hợp của bạn thì nhắn trưởng phòng hoặc quản trị kèm đường dẫn trang và thời điểm lỗi.

## Tải lên và kiểm tra

| Hiện tượng | Xử lý |
| --- | --- |
| Kiểm và chỉ mục không tự chạy | Phiên bản chưa đủ tệp bắt buộc (bản nộp cần PDF + zip). Tải bổ sung, hoặc bấm **Chạy lại tất cả** ở ngăn Vấn đề |
| Biên dịch LaTeX báo Lỗi | Đọc khối `! …` trong finding, sửa TeX rồi tải phiên bản mới |
| Khớp source ↔ PDF nộp báo Lỗi | PDF là bản scan hoặc không có lớp chữ: xuất lại PDF từ LaTeX |
| Tương đồng báo Chưa cấu hình | Quản trị chưa nhập Turnitin ở [Cài đặt → Tương đồng](/huong-dan/cai-dat/#tương-đồng-turnitin) |
| Không có nút nhảy PDF ↔ mã nguồn | Chưa có SyncTeX tin cậy: xem lý do trên thanh PDF, chạy lại kiểm hoặc nộp PDF biên dịch từ đúng source |
| Tải lên lỗi 403/400 | Đường dẫn tải lên hết hạn sau 600 giây: thử lại; kiểm dung lượng tệp |
| Công trình tạo từ PDF không điền được gì | Chưa cấu hình AI hoặc đã chạm trần: dùng zip LaTeX, DOI/arXiv, hoặc nhập tay |

## Truy cập

| Hiện tượng | Xử lý |
| --- | --- |
| Không thấy bài của mình | Bạn chưa là thành viên công trình: nhờ người phụ trách hoặc trưởng phòng thêm bạn |
| Bị chuyển tới trang thiết lập 2FA | Tài khoản trưởng phòng bắt buộc bật 2FA; làm theo [Đăng nhập và 2FA](/huong-dan/bat-dau/#xác-thực-2-bước-2fa) |
| Lời mời báo hết hạn | Lời mời sống 48 giờ: nhờ trưởng phòng gửi lại |

## Tệp và Hỏi AI

| Hiện tượng | Xử lý |
| --- | --- |
| Tải lên Tệp của tôi báo vượt hạn mức | Xoá bớt tệp (gồm cả thùng rác) hoặc nhờ trưởng phòng nâng hạn mức |
| Tệp HTML/SVG không xem được | Có chủ ý: chỉ PDF, ảnh, văn bản xem trực tiếp; loại khác chỉ tải xuống |
| Hỏi AI báo `ai_budget_exceeded` | Đã chạm trần chi phí AI: nhờ quản trị nâng trần hoặc đổi khoá |
| Hỏi AI không tìm thấy nội dung bài vừa tải | Chỉ mục chưa chạy xong: chờ vài phút rồi hỏi lại |

## CLI và MCP

| Hiện tượng | Xử lý |
| --- | --- |
| `papers push` báo `not_found` | Mã `ISL-…` không nằm trong quyền của bạn: kiểm lại mã hoặc nhờ thêm vào công trình |
| CLI báo hết hạn đăng nhập | Token sống 90 ngày: chạy `papers login` lại |
| Client MCP báo `invalid_client` | Client không hỗ trợ CIMD: nhờ quản trị tạo client (xem [Kết nối MCP](/tich-hop/mcp/#client-không-hỗ-trợ-cimd)) |
| `/device` báo "Mã này đã thuộc tài khoản khác" | Đăng nhập đúng tài khoản vừa yêu cầu kết nối, hoặc huỷ kết nối trong ứng dụng và xin mã mới |