升级Django至3.2版本后项目报ValueError: Empty module name的原因？

问题描述 #

将Django版本从3.1升级到3.2并运行项目时，遇到如下错误：

Exception in thread django-main-thread:
Traceback (most recent call last):
  File "/usr/lib/python3.8/threading.py", line 932, in _bootstrap_inner
    self.run()
  File "/usr/lib/python3.8/threading.py", line 870, in run
    self._target(*self._args, **self._kwargs)
  File "/.../Kamva-Backend/venv/lib/python3.8/site-packages/django/utils/autoreload.py", line 64, in wrapper
    fn(*args, **kwargs)
  File "/.../Kamva-Backend/venv/lib/python3.8/site-packages/django/core/management/commands/runserver.py", line 125, in inner_run
    autoreload.raise_last_exception()
  File "/.../Kamva-Backend/venv/lib/python3.8/site-packages/django/utils/autoreload.py", line 87, in raise_last_exception
    raise _exception[1]
  File "/.../Kamva-Backend/venv/lib/python3.8/site-packages/django/core/management/__init__.py", line 398, in execute
    autoreload.check_errors(django.setup)()
  File "/.../Kamva-Backend/venv/lib/python3.8/site-packages/django/utils/autoreload.py", line 64, in wrapper
    fn(*args, **kwargs)
  File "/.../Kamva-Backend/venv/lib/python3.8/site-packages/django/__init__.py", line 24, in setup
    apps.populate(settings.INSTALLED_APPS)
  File "/.../Kamva-Backend/venv/lib/python3.8/site-packages/django/apps/registry.py", line 91, in populate
    app_config = AppConfig.create(entry)
  File "/.../Kamva-Backend/venv/lib/python3.8/site-packages/django/apps/config.py", line 210, in create
    app_module = import_module(app_name)
  File "/usr/lib/python3.8/importlib/__init__.py", line 127, in import_module
    return _bootstrap._gcd_import(name[level:], package, level)
  File "<frozen importlib._bootstrap>", line 1011, in _gcd_import
  File "<frozen importlib._bootstrap>", line 950, in _sanity_check
ValueError: Empty module name

项目原本运行正常，但升级后无法正常启动。

解决方案 #

• 检查INSTALLED_APPS配置：这个错误的核心是Django尝试导入一个空的模块名，大概率是settings.py里的INSTALLED_APPS列表存在空字符串或者格式错误的条目。比如不小心多加了逗号导致出现空元素，或者复制粘贴时引入了无效的空行/空条目。
  • 打开项目根目录下的settings.py，找到INSTALLED_APPS列表，逐个检查每个条目，确保没有空字符串（''）、多余的逗号导致的空元素。
  • 错误示例：INSTALLED_APPS = ['django.contrib.admin', '', 'myapp']，其中的空字符串就是问题根源。
• 检查自定义AppConfig的导入路径：如果项目中使用了自定义的AppConfig类，确认其导入路径是否正确，是否存在拼写错误，或者模块结构变动后路径未更新。
• 清理缓存并重新安装依赖：
  • 执行python manage.py clearcache清理Django缓存。
  • 重新安装依赖：pip install -r requirements.txt，确保所有依赖与Django 3.2兼容。
• 检查项目目录结构：确认所有应用的目录结构符合Django要求，应用目录下存在__init__.py文件（Python 3.3+虽支持无__init__.py的命名空间包，但Django对传统应用仍有此要求）。

内容的提问来源于stack exchange，提问作者Seyed Alireza Hashemi