Python3.8部署Django模型到Apache2报colorama无init属性错误解决

按以下优先级从高到低排查，99%的场景都能解决：

• 首先排查同名文件冲突，这是部署场景下的最高发诱因
  全局扫描Django项目根目录、Apache配置中指定的WSGI工作目录，查找是否存在命名为colorama.py的自定义脚本，或是带__init__.py的colorama同名目录。这类文件会被Python优先导入，直接覆盖官方安装的colorama包，必然触发属性不存在的报错。找到后直接重命名该文件/目录，清理路径下所有__pycache__缓存文件夹，重启Apache验证即可。

注意：Apache运行WSGI应用时，会把项目根目录放在Python模块搜索路径的最高优先级，和你本地终端开发时的导入顺序有差异，很多本地运行正常的项目部署后踩这个坑。

• 其次排查包装错环境/安装损坏问题
  Apache通过mod_wsgi运行Django时，调用的Python解释器和你终端里直接敲python3调用的解释器大概率不是同一个，很多人把colorama装到了系统全局Python或者其他虚拟环境里，WSGI运行环境根本没装对包。

  1. 先定位WSGI使用的解释器路径：虚拟环境部署就找虚拟环境下的bin/python3.8，全局mod_wsgi部署可以执行dpkg -L libapache2-mod-wsgi-py3查对应关联的Python路径
  2. 用找到的解释器执行校验命令，确认包状态：

  # 替换为你实际的Python解释器路径
  /path/to/your/python -c "import colorama; print(colorama.__file__, colorama.__version__)"
  

  3. 如果执行上述命令就复现同样的报错，说明当前环境的colorama安装损坏或版本不兼容，直接卸载重装适配Python3.8的稳定版：

  /path/to/your/python -m pip uninstall -y colorama
  /path/to/your/python -m pip install colorama==0.4.6
  

• 再排查权限不足的部署特有问题
  如果你是用root账号执行pip安装的包，Apache的运行用户（Debian/Ubuntu默认为www-data，CentOS/RHEL默认为apache）没有site-packages目录的读取权限，会导致模块导入时只加载了部分文件，触发属性缺失报错。对应执行权限修复命令即可（以Debian系为例）：

  chown -R www-data:www-data /path/to/your/python/env/lib/python3.8/site-packages/
  systemctl restart apache2
  

• 最后排查mod_wsgi版本适配问题
  如果以上操作都无效，大概率是mod_wsgi编译时链接的Python版本和你项目用的Python3.8不匹配，导致模块导入逻辑错乱。重新安装对应版本的mod_wsgi即可：

  apt remove -y libapache2-mod-wsgi-py3
  /path/to/your/python -m pip install mod-wsgi
  mod_wsgi-express install-module
  # 按照命令输出的提示更新Apache的mod_wsgi加载配置，重启服务即可
  

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