Tab Routes map URL cong khai toi file HTML
404 thieu route

DINHDANH Creator · Bài X04 · Xử lý sự cố

URL 404 /
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ý

Khách mở URL → 404?
→ Có file HTML trong Thư mục?
Có file → thiếu map: tab Đường dẫn → Thêm Route → slug → chọn file → toggle ON → Lưu
Không file → AI tạo HTML trước, rồi add route
→ Route có nhưng toggle xám → bật xanh → Lưu
→ Nháp chưa publish → thêm Lưu thay đổi Creator
→ Link nội bộ gãy → absolute URL (T08), không nhầm slug với tên file
Áp Clean template / wipe → routes.json mất - phải add lại (X08)

2. Thuật ngữ

Thuật ngữNghĩaNơi thấy
Route Path (slug)URL công khai: chữ, số, -, _; có thể lồng blog/helloTab Đường dẫn
Target FileFile HTML trên kho file của dự án - không tự public theo tên fileDropdown khi Thêm Route
routes.jsonBảng map slug → file - chỉ cập nhật khi nhấn Lưu tab nàyKho file (ẩn với user thường)
Lưu vs Lưu thay đổiLưu = routes local; Lưu thay đổi = publish toàn nhápTab Đường dẫn vs toolbar

3. Các bước (đúng nhãn T08)

  1. Mở tab Đường dẫn.
  2. Nhấn Thêm Route.
  3. Nhập slug route (chữ, số, -, _) - không nhầm với tên file post-hello.html.
  4. Chọn file HTML từ dropdown (Target File).
  5. Bật toggle xanh (route active).
  6. 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.
  7. Preview Thay đổi → thử URL → nếu OK → Lưu thay đổi publish.
  8. 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.

Làm được: URL ngắn, slug lồng, bật/tắt route không xóa file.
Không: Mọi HTML tự public theo tên file; quên Lưu tab Đường dẫn mà vẫn expect URL hoạt động.

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ứngXử lý
404 dù có HTML trong Thư mụcThêm Route + Lưu; kiểm toggle xanh
Sửa route không thấy trên liveQuên Lưu tab Đường dẫn; rồi Lưu thay đổi
Link nội bộ gãyDùng absolute URL từ site_url (T08)
Slug đúng, file saiĐổi Target File trong route → Lưu
Mất hết route sau templateClean template wipe routes - add lại hoặc Clone cũ (X08)
Xóa bài mà URL cònXó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.
  1. Phân biệt slug URL vs tên file HTML?
  2. Biết Lưu (routes) khác Lưu thay đổi?
  3. Đã thử toggle xanh + Lưu trước khi báo 404?