
DINHDANH Creator · Bài X04 · Xử lý sự cố
thiếu Route
Có file HTML trong Thư mục nhưng URL vẫn 404 - gần như luôn thiếu hoặc sai map trong tab Đường dẫn.
Mục tiêu: Thêm route đúng slug ↔ file, nhấn Lưu tab Đường dẫn, phân biệt slug vs đường dẫn file (T08).
Thời lượng: ~10 phút · Trước: T08, D02 · Sau: X05
Nhãn UI: tab Đường dẫn · Thêm Route · Lưu · toggle xanh/xám · Lưu thay đổi · Thư mục
1. Sơ đồ xử lý
2. Thuật ngữ
| Thuật ngữ | Nghĩa | Nơi thấy |
|---|---|---|
| Route Path (slug) | URL công khai: chữ, số, -, _; có thể lồng blog/hello | Tab Đường dẫn |
| Target File | File HTML trên kho file của dự án - không tự public theo tên file | Dropdown khi Thêm Route |
| routes.json | Bảng map slug → file - chỉ cập nhật khi nhấn Lưu tab này | Kho file (ẩn với user thường) |
| Lưu vs Lưu thay đổi | Lưu = routes local; Lưu thay đổi = publish toàn nháp | Tab Đường dẫn vs toolbar |
3. Các bước (đúng nhãn T08)
- Mở tab Đường dẫn.
- Nhấn Thêm Route.
- Nhập slug route (chữ, số,
-,_) - không nhầm với tên filepost-hello.html. - Chọn file HTML từ dropdown (Target File).
- Bật toggle xanh (route active).
- Nhấn Lưu - lưu routes vào kho file của dự án. Không nhầm với Lưu thay đổi.
- Preview Thay đổi → thử URL → nếu OK → Lưu thay đổi publish.
- Sau AI tạo trang mới: luôn kiểm tab này - AI hay quên addRoute.
4. So sánh · Làm được / Không
Next.js file-based routing: path file ≈ URL. WordPress permalinks: rewrite ≈ routes.json. DINHDANH tách file ↔ route tường minh - linh hoạt slug đẹp.
5. Bảo mật
Đừng route trang admin/CMS ra slug dễ đoán mà thiếu auth (T07). Route public chỉ cho trang guest được phép xem.
6. Bảng sự cố chi tiết
| Triệu chứng | Xử lý |
|---|---|
| 404 dù có HTML trong Thư mục | Thêm Route + Lưu; kiểm toggle xanh |
| Sửa route không thấy trên live | Quên Lưu tab Đường dẫn; rồi Lưu thay đổi |
| Link nội bộ gãy | Dùng absolute URL từ site_url (T08) |
| Slug đúng, file sai | Đổi Target File trong route → Lưu |
| Mất hết route sau template | Clean template wipe routes - add lại hoặc Clone cũ (X08) |
| Xóa bài mà URL còn | Xóa route tương ứng + Lưu |
7. Lời khuyên · Checklist
- Prompt AI: “Sau khi tạo trang, addRoute + nhắc tôi Lưu tab Đường dẫn.”
- CMS dynamic types tự sinh route - vẫn kiểm manifest + tab Đường dẫn khi lỗi 404.
- Phân biệt slug URL vs tên file HTML?
- Biết Lưu (routes) khác Lưu thay đổi?
- Đã thử toggle xanh + Lưu trước khi báo 404?
Bài tiếp theo
Điều hướng nội bộ (cùng ngôn ngữ)