Khi DEBUG=False, Django không còn hiện trang lỗi kỹ thuật mà trả về trang 404 và 500 mặc định — trắng trơn, không link về trang chủ, không đúng thương hiệu của bạn. Muốn trang lỗi thân thiện hơn, chỉ cần tạo hai template 404.html và 500.html rồi khai báo handler404 và handler500 trong urls.py gốc. Cách này không cần thêm package nào và áp dụng cho mọi dự án Django 4.2 trở lên.
Vấn đề
Mặc định, khi người dùng gõ nhầm URL, Django trả về trang “Not Found” với một dòng chữ duy nhất, còn khi view gặp lỗi chưa xử lý, trình duyệt chỉ thấy dòng “Server Error (500)”. Cả hai trang đều không có logo, không có link quay lại trang chủ hay ô tìm kiếm, nên người dùng thường đóng tab luôn thay vì ở lại. Vấn đề nằm ở chỗ Django chỉ tự dùng template mặc định khi chưa có gì khác — bạn phải chủ động khai báo trang lỗi của mình.
Tình huống thường gặp nhất là một bài viết đã xóa nhưng link cũ vẫn được chia sẻ khắp nơi:
# views.py — bài viết đã xóa vẫn bị truy cập qua link cũfrom django.http import Http404def post_detail(request, slug): post = Post.objects.filter(slug=slug).first() if post is None: raise Http404("Bài viết không tồn tại") return render(request, "post_detail.html", {"post": post})
Giải pháp
Bước 1: tạo hai template trong thư mục templates của project — đảm bảo cấu hình TEMPLATES đã có “DIRS”: [BASE_DIR / “templates”]. Hai file templates/404.html và templates/500.html viết bằng HTML như trang thường, nhớ thêm link về trang chủ và ô tìm kiếm.
Bước 2: nếu muốn trang 404 gợi ý thêm link hữu ích, viết hai view riêng. Lưu ý hàm xử lý lỗi 500 chỉ nhận request, không nhận exception:
# myapp/views.pyfrom django.shortcuts import renderdef custom_404(request, exception): suggestions = [ {"title": "Trang chủ", "url": "/"}, {"title": "Blog", "url": "/blog/"}, {"title": "Liên hệ", "url": "/lien-he/"}, ] return render(request, "404.html", {"suggestions": suggestions}, status=404)def custom_500(request): return render(request, "500.html", status=500)
Bước 3: khai báo hai handler trong urls.py GỐC của project — không phải urls.py của app:
# urls.py (gốc của project)from django.contrib import adminfrom django.urls import pathhandler404 = "myapp.views.custom_404"handler500 = "myapp.views.custom_500"urlpatterns = [ path("admin/", admin.site.urls),]
Thực ra chỉ cần tạo hai template 404.html và 500.html là Django đã tự dùng chúng, không bắt buộc viết view. Handler chỉ cần khi bạn muốn truyền dữ liệu động như danh sách gợi ý ở trên. Một lưu ý quan trọng: handler404 và handler500 chỉ có tác dụng khi DEBUG=False; khi DEBUG=True, Django vẫn hiện trang debug kỹ thuật để bạn soi lỗi.
Áp dụng vào dự án của bạn
Trên dự án thật, trang 404 nên có link về trang chủ, ô tìm kiếm và vài bài viết gợi ý để giữ chân người đọc; trang 500 tuyệt đối không lộ traceback hay thông tin cấu hình, lỗi chi tiết chỉ ghi vào log server để bạn sửa sau. Sau khi thêm template, chạy thử với DEBUG=False và ALLOWED_HOSTS đúng rồi mới deploy, vì lỗi cấu hình template chỉ lộ ra khi DEBUG=False.
Bài viết liên quan
- Django: kiểm tra bản ghi có tồn tại không bằng exists() thay vì count() > 0
- Django: viết middleware tùy chỉnh đo thời gian xử lý request trong 5 phút
- Django: bắt query chậm và dư thừa bằng django-debug-toolbar trong 5 phút
Câu hỏi thường gặp
Vì sao handler404 không chạy khi DEBUG=True?
Khi DEBUG=True, Django ưu tiên hiện trang debug kỹ thuật để lập trình viên soi lỗi, nên handler404 và handler500 bị bỏ qua. Muốn xem trang lỗi thật, đặt DEBUG=False rồi chạy lại server.
Chỉ tạo template 404.html và 500.html, không viết view, có được không?
Được. Django tự tìm hai template này trong thư mục templates khi có lỗi, không cần khai báo handler. Chỉ viết view khi cần truyền dữ liệu động như bài viết gợi ý.
Vì sao hàm custom_500 không nhận tham số exception?
Django gọi handler500 chỉ với request, vì lỗi 500 có thể xảy ra ở bất cứ đâu, kể cả trước khi exception được tạo ra. Muốn biết lỗi gì, đọc log của server hoặc bật ADMINS để nhận email báo lỗi.
Đặt handler404 trong urls.py của app được không?
Không. Django chỉ đọc handler404 và handler500 ở URLconf gốc của project. Đặt trong file urls.py được include() sẽ bị bỏ qua hoàn toàn mà không báo lỗi.
Làm sao kiểm tra trang 500 ở máy local?
Đặt DEBUG=False, thêm “localhost” vào ALLOWED_HOSTS, rồi tạo một view cố tình raise Exception. Với test client, nhớ đặt raise_request_exception=False, nếu không test sẽ raise thay vì trả về response 500.
💬 Bạn đã thử cách này trong dự án của mình chưa? Nếu gặp lỗi hoặc có cách làm gọn hơn, để lại bình luận bên dưới — mình đọc hết và sẽ bổ sung những ý hay vào bài.
