部署Django到GAE时whitenoise与wiki模块找不到问题求助

一、修复whitenoise模块找不到的问题 #

• 确认requirements.txt位置：必须放在项目根目录（和app.yaml同层级），GAE会自动读取这里的依赖列表进行安装，若之前放在子目录请移到根目录。
• 检查requirements.txt内容：确保whitenoise==6.7.0单独占一行，无拼写错误、未被注释。
• 本地验证依赖安装：执行pip install -r requirements.txt，确认whitenoise能正常安装，排除依赖包本身的问题。
• 核对app.yaml的entrypoint配置：避免自定义命令跳过GAE默认的依赖安装流程，正确的入口命令示例：

  entrypoint: gunicorn -b :$PORT myproject.wsgi
  

  不要使用本地虚拟环境的绝对路径。

二、修复wiki模块找不到的问题 #

• 确认wiki模块结构：如果是自定义Django app，确保其目录下存在空的__init__.py文件，让Python识别为合法模块。
• 确保项目根目录在Python路径中：在settings.py开头添加代码，强制把项目根目录加入Python路径：

  import sys
  from pathlib import Path
  
  BASE_DIR = Path(__file__).resolve().parent.parent
  sys.path.append(str(BASE_DIR))
  

• 检查INSTALLED_APPS配置：确认wiki已添加到settings.py的INSTALLED_APPS列表中，格式为'wiki'或'wiki.apps.WikiConfig'。

三、更优的部署与调试方案 #

• 本地模拟GAE环境：用gcloud app run命令启动本地GAE服务，替代python manage.py runserver，更精准复现生产环境的依赖和路径问题。
• 实时查看GAE日志：部署后执行gcloud app logs tail -s default，通过详细错误栈定位模块缺失的具体原因（如路径未加载、依赖未安装）。
• 添加调试输出：在wsgi.py开头加入临时打印语句，输出Python路径和已安装包列表，帮助排查：

  import sys
  import pkg_resources
  
  print("Python Path:", sys.path)
  print("Installed Packages:", [pkg.key for pkg in pkg_resources.working_set])
  

  再通过日志查看输出内容，确认路径和依赖状态。
• 检查.gcloudignore文件：确保没有误将wiki模块或requirements.txt加入忽略列表，导致部署时未上传至GAE。

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