Azure部署失败：Django Web App找不到trplbackend模块问题排查

一、核心错误排查：ModuleNotFoundError: No module named 'trplbackend' #

1. 确认Python路径与项目根目录 #

Azure Web App的启动命令执行路径可能和本地不一致，导致Python无法定位模块：

• 登录Azure门户，进入Web App的高级工具>SSH，执行命令查看当前目录和Python路径：

  pwd
  echo $PYTHONPATH
  ls -la /home/site/wwwroot/
  

  确保trplbackend目录确实在/home/site/wwwroot/下，若PYTHONPATH未包含项目根目录，修改启动命令添加路径配置：

  PYTHONPATH=/home/site/wwwroot gunicorn --bind=0.0.0.0 --timeout 600 trplbackend.wsgi:application
  

2. 检查虚拟环境与依赖安装 #

• 确认虚拟环境antenv激活状态及依赖完整性，在SSH中执行：

  source /home/site/wwwroot/antenv/bin/activate
  pip list
  

  若依赖缺失，重新安装：

  pip install -r /home/site/wwwroot/requirements.txt
  

3. 验证WSGI模块路径 #

检查trplbackend/wsgi.py是否存在且配置正确：

import os
from django.core.wsgi import get_wsgi_application

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

application = get_wsgi_application()

确保DJANGO_SETTINGS_MODULE指向正确的配置文件。

二、提升部署稳定性的措施 #

1. 固化部署流程 #

在Azure Pipelines中添加部署前校验步骤：

• 检查项目结构完整性，确认trplbackend目录存在
• 执行pip check验证依赖无冲突
• 运行python manage.py check确保Django配置合法

2. 明确启动命令的工作目录 #

在Azure Web App的配置>常规设置中，修改启动命令为带目录切换的完整命令：

cd /home/site/wwwroot && PYTHONPATH=/home/site/wwwroot source antenv/bin/activate && gunicorn --bind=0.0.0.0 --timeout 600 trplbackend.wsgi:application

3. 启用部署槽位 #

使用Azure部署槽位功能，先将代码部署到测试槽验证，通过后再交换到生产槽。槽位交换会自动预热应用，减少直接部署带来的启动失败风险。

4. 添加日志与监控 #

• 在Django的settings.py中配置详细日志，记录模块加载过程：

  LOGGING = {
      'version': 1,
      'disable_existing_loggers': False,
      'handlers': {
          'console': {'class': 'logging.StreamHandler'},
      },
      'root': {'handlers': ['console'], 'level': 'INFO'},
      'loggers': {
          'django': {'handlers': ['console'], 'level': 'INFO', 'propagate': False},
      },
  }
  

• 启用Azure Application Insights，监控应用启动时的异常与性能指标，快速定位不稳定诱因。

5. 清理部署残留文件 #

在Azure Pipelines的部署任务中添加清理步骤，确保每次部署都是干净环境，避免旧文件导致路径混淆。

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