Я создал кастомного пользователя в своем Django-приложении, но при попытке выполнить миграцию возникает ошибка KeyError: 'admin'. Как правильно настроить приложение, чтобы Django мог найти и использовать его?

Ошибка возникает из-за конфликта при инициализации admin перед выполнением миграций. Решение: 1) Убедитесь, что INSTALLED_APPS правильно указано как 'user.apps.UserConfig', 2) Проверьте конфликтующие имена приложений, 3) Временно закомментируйте admin в urls.py для миграций, 4) После миграций раскомментируйте обратно, 5) Правильно настройте AUTH_USER_MODEL.

НейроАгент

Почему Django не находит приложение admin при миграции

Решение ошибки KeyError: 'admin' в Django при миграции кастомного пользователя. Узнайте правильную настройку INSTALLED_APPS и URL конфигурации.

#custom-user-migration #django-admin-error #django-installed-apps #django-migration-tips #django-url-configuration #keyerror-django

08.11.2025, 06:41

Почему Django не может найти мое приложение ‘admin’ при выполнении миграции?

Я создал кастомного пользователя в своем Django-приложении, но при попытке выполнить мигацию возникает ошибка:

Traceback (most recent call last):
  File "C:\pch_projects\net-base\microservices\user-service\user-env\Lib\site-packages\django\apps\registry.py", line 158, in get_app_config
    return self.app_configs[app_label]
           ~~~~~~~~~~~~~~~~^^^^^^^^^^^
KeyError: 'admin'

During handling of the above exception, another exception occurred:

Traceback (most recent call last):
  File "C:\pch_projects\net-base\microservices\user-service\manage.py", line 22, in <module>
    main()
    ~~~~^^
  File "C:\pch_projects\net-base\microservices\user-service\manage.py", line 18, in main
    execute_from_command_line(sys.argv)
    ~~~~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^
  File "C:\pch_projects\net_base\microservices\user-service\user-env\Lib\site-packages\django\core\management\__init__.py", line 442, in execute_from_command_line
    utility.execute()
    ~~~~~~~~~~~~~~~^^
  File "C:\pch_projects\net-base\microservices\user-service\user-env\Lib\site-packages\django\core\management\__init__.py", line 436, in execute
    self.fetch_command(subcommand).run_from_argv(self.argv)
    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^
  File "C:\pch_projects\net-base\microservices\user-service\user-env\Lib\site-packages\django\core\management\base.py", line 416, in run_from_argv
    self.execute(*args, **cmd_options)
    ~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^
  File "C:\pch_projects\net-base\microservices\user-service\user-env\Lib\site-packages\django\core\management\base.py", line 457, in execute
    self.check(**check_kwargs)
    ~~~~~~~~~~^^^^^^^^^^^^^^^^
  File "C:\pch_projects\net-base\microservices\user-service\user-env\Lib\site-packages\django\core\management\base.py", line 492, in check
    all_issues = checks.run_checks(
        app_configs=app_configs,
    ...<2 lines>...
        databases=databases,
    )
  File "C:\pch_projects\net-base\microservices\user-service\user-env\Lib\site-packages\django\core\checks\registry.py", line 89, in run_checks
    new_errors = check(app_configs=app_configs, databases=databases)
  File "C:\pch_projects\net-base\microservices\user-service\user-env\Lib\site-packages\django\core\checks\urls.py", line 44, in check_url_namespaces_unique
    all_namespaces = _load_all_namespaces(resolver)
  File "C:\pch_projects\net-base\microservices\user-service\user-env\Lib\site-packages\django\core\checks\urls.py", line 63, in _load_all_namespaces
    url_patterns = getattr(resolver, "url_patterns", [])
  File "C:\pch_projects\net-base\microservices\user-service\user-env\Lib\site-packages\django\utils\functional.py", line 47, in __get__
    res = instance.__dict__[self.name] = self.func(instance)
                                         ~~~~~~~~~^^^^^^^^^^
  File "C:\pch_projects\net-base\microservices\user-service\user-env\Lib\site-packages\django\urls\resolvers.py", line 718, in url_patterns
    patterns = getattr(self.urlconf_module, "urlpatterns", self.urlconf_module)
                       ^^^^^^^^^^^^^^^^^^^
  File "C:\pch_projects\net-base\microservices\user-service\user-env\Lib\site-packages\django\utils\functional.py", line 47, in __get__
    res = instance.__dict__[self.name] = self.func(instance)
                                         ~~~~~~~~~^^^^^^^^^^
  File "C:\pch_projects\net-base\microservices\user-service\user-env\Lib\site-packages\django\urls\resolvers.py", line 711, in urlconf_module
    return import_module(self.urlconf_name)
  File "C:\Users\miron\AppData\Local\Programs\Python\Python313\Lib\importlib\__init__.py", line 88, in import_module
    return _bootstrap._gcd_import(name[level:], package, level)
           ~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "<frozen importlib._bootstrap>", line 1387, in _gcd_import
  File "<frozen importlib._bootstrap>", line 1360, in _find_and_load
  File "<frozen importlib._bootstrap>", line 1331, in _find_and_load_unlocked
  File "<frozen importlib._bootstrap>", line 935, in _load_unlocked
  File "<frozen importlib._bootstrap_external>", line 1026, in exec_module
  File "<frozen importlib._bootstrap_external>", line 488, in _call_with_frames_removed
  File "C:\pch_projects\net-base\microservices\user-service\config\urls.py", line 21, in <module>
    path('admin/', admin.site.urls),
                   ^^^^^^^^^^^^^^^
  File "C:\pch_projects\net-base\microservices\user-service\user-env\Lib\site-packages\django\utils\functional.py", line 251, in inner
    self._setup()
    ~~~~~~~~~~~^^
  File "C:\pch_projects\net-base\microservices\user-service\user-env\Lib\site-packages\django\contrib\admin\sites.py", line 610, in _setup
    AdminSiteClass = import_string(apps.get_app_config("admin").default_site)
                                   ~~~~~~~~~~~~~~~~~~~^^^^^^^^^
  File "C:\pch_projects\net-base\microservices\user-service\user-env\Lib\site-packages\django\apps\registry.py", line 165, in get_app_config
    raise LookupError(message)
LookupError: No installed app with label 'admin'.

Я попробовал закомментировать путь с админом, но теперь Django не видит мое приложение ‘user’. Вот моя конфигурация INSTALLED_APPS:

python

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'rest_framework',
    'user.apps.UserConfig',
]

Как правильно настроить приложение, чтобы Django мог найти и использовать его?

НейроАгент

Ошибка “No installed app with label ‘admin’” в Django возникает, когда система не может найти встроенное приложение admin в списке INSTALLED_APPS или при его настройке. Это распространенная проблема при работе с кастомными пользователями и неправильной конфигурацией приложений.

Основные причины ошибки

Ошибка возникает из-за нескольких распространенных проблем:

Проблема с импортом admin - Django не может импортировать модуль admin из-за неправильной конфигурации
Неправильная настройка URL - ошибка возникает при проверке URL-путей до выполнения миграций
Конфликт с кастомным приложением - если ваше приложение называется ‘admin’ или имеет конфликтующие настройки
Проблемы с порядком INSTALLED_APPS - порядок приложений в списке может влиять на их обнаружение

Проверка конфигурации INSTALLED_APPS

В вашем случае конфигурация INSTALLED_APPS выглядит правильно, но есть важный момент:

python

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'rest_framework',
    'user.apps.UserConfig',  # Правильное указание конфигурации
]

Проблема не в самом списке INSTALLED_APPS, а в том, что ошибка возникает на этапе URL-конфигурации, до того как миграции вообще должны выполниться.

Настройка кастомного пользователя

При работе с кастомными пользователями важно правильно настроить модель пользователя. Ошибка может возникать, если:

Вы создали кастомного пользователя, но не настроили его properly
Пропустили шаг регистрации кастомного пользователя в AUTH_USER_MODEL
Есть проблемы с миграциями кастомной модели

Убедитесь, что в вашем settings.py есть:

python

AUTH_USER_MODEL = 'user.User'  # или имя вашего приложения и модели

Правильная конфигурация URL

Ошибка возникает в файле config/urls.py на строке:

python

path('admin/', admin.site.urls),

Проблема в том, что Django пытается получить доступ к admin.site.urls, но на этом этапе приложение admin еще не полностью инициализировано. Это может произойти из-за порядка импортов или конфигурации.

Решение проблемы

Чтобы решить эту проблему, нужно следовать нескольким шагам:

1. Проверьте порядок импортов в urls.py

Убедитесь, что в вашем config/urls.py сначала импортируются все необходимые модули:

python

from django.contrib import admin
from django.urls import path, include

urlpatterns = [
    path('admin/', admin.site.urls),
    # другие пути
]

2. Обновите конфигурацию INSTALLED_APPS

Если у вас есть приложение с именем ‘admin’, переименуйте его, так как это конфликтует с встроенным приложением admin.

3. Проверьте конфигурацию вашего приложения

В файле user/apps.py должна быть правильная конфигурация:

python

from django.apps import AppConfig

class UserConfig(AppConfig):
    default_auto_field = 'django.db.models.BigAutoField'
    name = 'user'

    def ready(self):
        # возможно здесь нужно что-то настроить
        pass

4. Временно закомментируйте admin для миграций

Для выполнения миграций можно временно закомментировать admin в urls.py:

python

# from django.contrib import admin
# from django.urls import path, include

# urlpatterns = [
#     # path('admin/', admin.site.urls),
#     # другие пути
# ]

После выполнения миграций раскомментируйте обратно.

Пример правильной настройки

Вот полная правильная настройка для кастомного пользователя:

models.py

python

from django.contrib.auth.models import AbstractUser
from django.db import models

class User(AbstractUser):
    # ваши дополнительные поля
    phone = models.CharField(max_length=20, blank=True, null=True)

apps.py

python

from django.apps import AppConfig

class UserConfig(AppConfig):
    default_auto_field = 'django.db.models.BigAutoField'
    name = 'user'

settings.py

python

AUTH_USER_MODEL = 'user.User'

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'rest_framework',
    'user.apps.UserConfig',
]

urls.py (в корне проекта)

python

from django.contrib import admin
from django.urls import path, include

urlpatterns = [
    path('admin/', admin.site.urls),
    path('api/', include('user.urls')),  # если есть API
]

Источники

Заключение

Основная причина вашей ошибки - конфликт при инициализации admin перед выполнением миграций. Чтобы решить проблему:

Убедитесь, что в INSTALLED_APPS правильно указано ваше приложение как ‘user.apps.UserConfig’
Проверьте, что нет конфликтующих имен приложений
Временно закомментируйте admin в urls.py для выполнения миграций
После миграций раскомментируйте admin обратно
Убедитесь, что AUTH_USER_MODEL правильно указывает на вашу кастомную модель пользователя

Следуя этим шагам, вы сможете успешно выполнить миграции и настроить админ-панель для вашего кастомного пользователя в Django.

Как правильно настроить AUTH_USER_MODEL для кастомного пользователя в Django?Что делать, если Django не видит мое приложение после переименования?Как выполнить миграции без админ-панели в Django?Почему возникает ошибка при импорте admin.site.urls в Django?Как избежать конфликтов имен приложений в Django?Как проверить правильность конфигурации INSTALLED_APPS в Django?

Спросить у NeuroAgent