Heroku部署遇ModuleNotFoundError：找不到'msilib'模块，求解决

问题原因 #

msilib是Python仅在Windows环境下提供的标准库，Heroku使用Linux运行环境，因此无法找到该模块。报错是因为代码或依赖中存在未做平台判断的Windows专属导入逻辑。

解决方案 #

1. 排查并修改代码中的平台专属导入 #

搜索项目所有.py文件，找到包含from msilib.schema import AdminExecuteSequence（或其他msilib相关导入）的代码，添加平台判断逻辑，仅在Windows环境下执行该导入：

import sys

# 仅在Windows系统下导入msilib相关模块
if sys.platform == "win32":
    from msilib.schema import AdminExecuteSequence
    # 此处添加该模块相关的Windows专属逻辑

2. 清理本地Windows专属缓存文件 #

确保本地开发环境生成的Windows专属缓存文件没有被推送到Heroku：

• 检查项目根目录的.gitignore文件，确保包含以下内容：

  __pycache__/
  *.pyc
  *.pyo
  *.pyd
  

• 执行以下命令清理已缓存的文件并重新提交：

  git rm -r --cached __pycache__
  git commit -m "Remove Windows-specific cache files"
  git push heroku main
  

3. 验证依赖包的跨平台兼容性 #

检查requirements.txt中的依赖是否存在Windows专属包：

• 当前列出的依赖均为跨平台兼容包，但如果后续添加了Windows专属依赖，需通过platform_system标记限定安装环境，例如：

  # 仅在Windows环境下安装的包
  some-windows-only-package==x.x.x; sys_platform == 'win32'
  

4. 重新执行迁移命令 #

完成上述操作后，重新在Heroku上执行迁移：

heroku run python manage.py migrate

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