Ошибки, возникающие при работе Системы, и способы их устранения¶
В таблице ниже представлено описание типичных ошибок, возникающих при работе с Системой, а также рекомендации по их устранению. Ошибки могут возникать как на уровне пользовательского взаимодействия, так и в ходе запуска сканирования моделей.
| № п/п | Ошибка | Причина ошибки | Способ устранения |
|---|---|---|---|
| 1 | docker: command not found |
Docker не установлен | Установите Docker |
| 2 | Error response from daemon: invalid reference format |
Ошибка в имени образа, лишние пробелы в файле .env.dev | Проверьте имя образа и убедитесь в отсутствии пробелов после = |
| 3 | Контейнер сразу останавливается после запуска (Exited) | Ошибка в CMD внутри Dockerfile или в wsgi.py | Выполните docker logs <container_id> и проанализируйте ошибку |
| 4 | ModuleNotFoundError при запуске |
Неустановленные зависимости | Убедитесь, что файл requirements.txt корректен и зависимости установлены |
| 5 | CSRF_TRUSTED_ORIGINS ошибка Django |
Отсутствует http:// или https:// в переменной | Добавьте http:// в начало переменной окружения |
| 6 | 500 Internal Server Error при открытии страницы |
Ошибка Django-приложения из-за переменных окружения или миграций | Проверьте файл .env.dev, выполните python manage.py migrate |
| 7 | Address already in use |
Порт занят | Освободите порт (lsof -i :PORT, kill <PID>) или выберите другой |
| 8 | Не открывается интерфейс в браузере | Контейнер не запущен или порт не проброшен | Проверьте docker ps и убедитесь в пробросе порта -p PORT:PORT |
| 9 | Не работает POST-запрос к модели | Отсутствует модель или неправильный эндпоинт | Проверьте, что модель запущена и эндпоинт доступен |
| 10 | pip install внутри Docker зависает |
Нет интернета в контейнере | Проверьте настройки сети Docker |
| 11 | Ошибка ALLOWED_HOSTS |
Переменная ALLOWED_HOSTS не определена |
Добавьте в settings.py строку с ALLOWED_HOSTS = os.environ.get(...) |
| 12 | MEDIA_ROOT ошибка при сохранении файлов |
MEDIA_ROOT не указан |
Добавьте MEDIA_ROOT = os.path.join(BASE_DIR, 'static/media') в settings.py |
| 13 | Ошибки со статикой (404) | Неправильный STATICFILES_DIRS |
Проверьте STATICFILES_DIRS и наличие папки |
| 14 | Ошибка с whitenoise |
Не указан STATICFILES_STORAGE или нет whitenoise |
Укажите STATICFILES_STORAGE и установите whitenoise |
| 15 | CSRF_TRUSTED_ORIGINS ошибка при отправке формы |
Неправильно задана переменная окружения | Проверьте переменную и наличие схемы http:// |