Azure部署Django项目报错：global_settings无ROOT_URLCONF属性

本地运行Django项目一切正常，但部署到Azure后，Stream日志中持续报错：AttributeError: module 'django.conf.global_settings' has no attribute 'ROOT_URLCONF'，尝试多种方案均无效。相关文件内容如下：

wsgi.py 文件 #

import os

from django.core.wsgi import get_wsgi_application


os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'mojspecjalista.settings')

application = get_wsgi_application()

项目urls文件（mojspecjalista/urls.py） #

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


urlpatterns = [
    path('', include('App.api.urls')),
    path('admin/', admin.site.urls),
]

manage.py 文件 #

def main():
    """Run administrative tasks."""
    os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'mojspecjalista.settings')
    try:
        from django.core.management import execute_from_command_line
    except ImportError as exc:
        raise ImportError(
            "Couldn't import Django. Are you sure it's installed and "
            "available on your PYTHONPATH environment variable? Did you "
            "forget to activate a virtual environment?"
        ) from exc
    execute_from_command_line(sys.argv)


if __name__ == '__main__':
    main()

settings.py 相关配置 #

ROOT_URLCONF = 'mojspecjalista.urls'

1. 强制Django版本一致性 #

本地开发和Azure服务器的Django版本必须完全匹配——ROOT_URLCONF是Django核心配置项，版本差异可能导致全局设置模块找不到该属性：

• 本地执行 pip freeze > requirements.txt，确保文件里明确指定具体版本（比如 Django==4.2.5，不要留空版本号）
• 部署时Azure会依据requirements.txt安装依赖，避免自动升级引发兼容问题

2. 验证Azure环境变量配置 #

Azure App Service可能未正确设置DJANGO_SETTINGS_MODULE，导致Django加载默认全局设置而非你的项目配置：

• 登录Azure门户进入你的App Service
• 转到「配置」→「应用程序设置」
• 添加或确认存在DJANGO_SETTINGS_MODULE，值为mojspecjalista.settings
• 保存后重启App Service

3. 检查项目目录与部署路径 #

Azure部署时可能未识别正确的项目根目录，导致Django找不到settings和urls文件：

• 确认项目根目录包含mojspecjalista（settings所在包）、App等核心文件夹
• 在Azure「部署中心」确认部署源（GitHub/Azure Repos等）的路径正确，未遗漏关键目录
• 若用自定义启动命令，确保工作目录为项目根，比如：

  gunicorn --bind=0.0.0.0 --timeout 600 mojspecjalista.wsgi:application
  

4. 排查settings.py加载异常 #

本地正常但部署环境可能存在隐藏语法错误或依赖缺失，导致settings未被正确加载，Django fallback到全局设置：

• 检查settings.py是否有语法错误（比如遗漏逗号、引号不匹配）
• 检查settings中是否有依赖未设置的环境变量，导致加载失败
• 可临时在wsgi.py中添加调试代码，查看日志确认settings加载状态：

  import os
  import django
  os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'mojspecjalista.settings')
  django.setup()
  from django.conf import settings
  print(f"Loaded settings: {settings}")
  print(f"ROOT_URLCONF value: {settings.ROOT_URLCONF}")
  from django.core.wsgi import get_wsgi_application
  application = get_wsgi_application()
  

5. 清理Azure缓存部署 #

Azure可能缓存旧部署文件，导致新配置未生效：

• 在App Service「概述」页面点击「重启」
• 若用部署槽位，可切换槽位后切回，强制刷新文件
• 手动删除服务器上的旧虚拟环境和依赖，重新部署

内容的提问来源于stack exchange，提问作者Adude