Ошибка 404 (Not Found) — частая ситуация в веб‑приложениях. Django даёт простую «из коробки» страницу 404, но для согласованного пользовательского опыта лучше иметь свою страницу, оформленную в стиле проекта и соответствующую требованиям доступности.

Что такое 404 и почему кастомная страница важна

404 — HTTP‑статус, который сообщает браузеру, что ресурс не найден. Стандартная страница фреймворка полезна для разработки, но не для продакшена: она не брендирована, часто не дружелюбна к пользователю и может не давать подсказок, куда идти дальше.

Короткий список выгод кастомной 404:

• Сохраняет стиль и голос продукта.
• Помогает пользователю вернуться на сайт (меню, поиск, ссылки).
• Улучшает восприятие ошибки и снижает фрустрацию.
• Дает поле для SEO/индексации (корректный статус 404 важен).

Шаг 1: Создайте view для обработки 404

В файле views.py добавьте функцию, которая будет возвращать ваш шаблон и статус 404. Аргументы: request и exception — exception даёт контекст об ошибке.

# views.py
from django.shortcuts import render

# кастомный 404 view
def custom_404(request, exception):
    return render(request, '404.html', status=404)

Важно: имя функции и путь к шаблону должны совпадать с тем, что вы укажете в handler404.

Шаг 2: Создайте шаблон 404.html

Шаблон должен быть согласован с дизайном сайта и возвращать HTTP‑статус 404. Ниже простой адаптируемый пример — добавьте aria‑атрибуты, элементы навигации и локализацию по необходимости.

    
    
    
    
    


    

        
😕
        
Упс! Страница не найдена
        
Возможно, ссылка устарела или вы ввели неправильный адрес. Попробуйте найти нужную страницу или вернитесь на главную.
        Перейти на главную
        
Если ошибка повторяется, свяжитесь с поддержкой сайта.
    

Советы по шаблону:

• Убедитесь, что шаблон лёгкий и не требует обращения к базе данных во время рендеринга.
• Добавьте ссылку на поиск по сайту, карту сайта или основные разделы.
• Добавьте aria‑подписи и семантические теги для доступности.

Шаг 3: Укажите handler404 в urls.py проекта

Поставьте mapping в корневом urls.py (тот, где лежит settings.py на уровне проекта). Формат:

# urls.py (проект)
handler404 = 'app_name.views.custom_404'

Например, если приложение называется recipe, а view — custom_404, то:

handler404 = 'recipe.views.custom_404'

Важно: handler404 должен быть объявлен в файле urls.py проекта (не в urls.py отдельного приложения).

Шаг 4: Как тестировать

В режиме разработки Django по умолчанию показывает подробную страницу отладки, а не ваш handler404. Чтобы увидеть кастомную 404‑страницу при локальном запуске, установите DEBUG = False и настройте ALLOWED_HOSTS (или временно воспользуйтесь тестовым клиентом Django).

Простой способ локального теста:

1. В settings.py временно поставьте DEBUG = False.
2. Добавьте в ALLOWED_HOSTS: [‘127.0.0.1’, ‘localhost’].
3. Запустите сервер:

python manage.py runserver

4. Перейдите по несуществующему URL, например http://127.0.0.1:8000/non-existent.

Альтернатива: используйте Django test client в тесте, чтобы проверять код ответа и содержание шаблона без изменения DEBUG.

Частые причины, если кастомная 404 не отображается

• DEBUG = True (в режиме разработки Django показывает страницу отладки).
• handler404 объявлен в urls.py приложения, а не в корневом urls.py.
• Неправильный путь к шаблону в render().
• Ошибки в шаблоне (ошибка при рендеринге возвращает 500, и вы видите другую страницу).
• Кеширование CDN/прокси возвращает старую страницу.

Критерии приёмки

• Страница возвращает HTTP статус 404.
• Визуально страница соответствует стилю сайта (шрифты, цвета, брендинг).
• На странице есть ссылка на главную и/или поиск.
• Проверено при DEBUG = False и упаковке в контейнер/сервер.
• Простая версия шаблона не выполняет тяжёлых DB‑запросов.
• Минимально поддерживается доступность (role=”main”, aria‑labels).

Роль‑ориентированные чек‑листы

Для разработчика:

• Добавил view и верно оформил status=404.
• Задал handler404 в корневом urls.py.
• Тесты покрывают ответ и шаблон.

Для дизайнера:

• Визуально согласовал страницу с дизайн‑гайдом.
• Предоставил варианты для мобильного и десктопа.

Для QA:

• Проверил поведение при DEBUG = False.
• Проверил доступность (контрастность, навигация с клавиатуры).

Для DevOps:

• Убедился, что CDN/кеши не мешают отображению.
• Настроил мониторинг ошибок и логирование 404 для анализа ссылок.

Тестовые случаи и приёмка

• Тест 1: GET на несуществующий URL → ответ 404 и содержимое шаблона содержит «Страница не найдена».
• Тест 2: Проверка заголовков — Content‑Type text/html.
• Тест 3: При отключении внешних ресурсов шаблон всё равно рендерится (нет зависимостей от БД).
• Тест 4: Страница доступна на мобильных разрешениях и читабельна.

Дальнейшие альтернативы и расширения

• Перенаправить на страницу поиска или предложить популярные разделы.
• Использовать серверный лог для сбора частых 404 и фиксировать битые ссылки.
• Для SPA (React/Vue) отдавать корректный 404 с сервера, а клиенту — render fallback.
• Разделять внутренние 404 (в пределах приложения) и внешние (неправильный домен) по логике отображения.

Мини‑методология внедрения (быстрый план)

1. Разработка: создать шаблон и view, локально проверить render.
2. Тестирование: покрыть unit‑тестом, проверить при DEBUG = False.
3. Ревью: дизайнер и accessibility review.
4. Деплой: включить на staging, проверить CDN/кеш.
5. Мониторинг: отслеживать логи 404 и исправлять часто попадающиеся пути.

Доступность и SEO

• Убедитесь, что страница возвращает реальный 404‑код — это важно для поисковых систем.
• Добавьте role=”main” и aria‑метки для экранных читалок.
• Не делайте редирект 404 → 200 (это мешает поисковой индексации).

Отладка и советы

Если вы не видите свою страницу в продакшене:

• Проверьте настройки прокси/NGINX: возможно, он перехватывает ошибки.
• Смотрите логи сервера и приложения: что произошло при рендеринге.
• Убедитесь, что шаблон доступен для Django (TEMPLATES DIRS / APP_DIRS).

Пример быстрых сниппетов/напоминалок

handler mapping:

# в urls.py проекта
handler404 = 'myapp.views.custom_404'

view:

def custom_404(request, exception):
    return render(request, '404.html', status=404)

runserver:

python manage.py runserver

Пример сценариев, когда кастомная 404 не помогает

• Битые внешние ссылки, которые ведут на ваш сайт — кастомная страница не предотвратит потерю трафика, но поможет пользователю.
• Если на сайте микросервисы возвращают 404 из‑за внутренних ошибок, стоит найти причину в API, а не только менять фронтенд.

Краткое резюме

Кастомная 404‑страница повышает удобство, снижает фрустрацию и поддерживает бренд. Реализуется просто: создайте view, шаблон, укажите handler404 в корневом urls.py и протестируйте при DEBUG = False. Не забывайте про доступность, производительность и мониторинг.

Примечание: сохраняйте шаблон простым и независимым от тяжёлых операций (чтобы рендер не падал и не заменялся на 500).