You need to enable JavaScript to run this app. Ubuntu托管Flask应用时mod_wsgi访问报模块未找到错误如何解决?
优惠活动
大模型
产品
解决方案
定价
更多

Ubuntu托管Flask应用时mod_wsgi访问报模块未找到错误如何解决?

报错核心原因

这个ModuleNotFoundError并非依赖真的未安装,本质是Apache加载的mod_wsgi组件运行的Python环境,和你本地手动运行项目的Python环境完全不匹配。
从你提供的error.log中可以直接定位到环境不匹配的实锤:

日志Apache启动行明确记录:mod_wsgi/4.5.17 Python/3.6 configured
说明当前Apache加载的mod_wsgi是编译时绑定系统Python3.6的版本,运行时所有的模块查找,都只会扫描Python3.6对应的全局site-packages路径。
你本地执行python3 __init__.py能正常启动,说明你安装flask_login这类依赖时,用的不是这个Python3.6解释器——常见情况是你执行pip install时,系统默认的pip指向了更高版本的系统Python,或者指向了虚拟环境的Python,安装的包根本不在mod_wsgi的查找路径里,自然触发模块找不到的报错。

可落地的解决方案

方案1:临时快速验证

给mod_wsgi绑定的Python3.6安装全量项目依赖,再重启Apache即可快速验证:

  • 执行命令为对应解释器安装所有项目依赖:
    /usr/bin/python3.6 -m pip install flask-login flask  # 后续补上你项目用到的所有依赖包
    
  • 重启Apache服务让配置生效:
    sudo systemctl restart apache2
    

方案2:适配现有项目环境(更规范)

如果你本地项目是通过虚拟环境隔离依赖的,不要往全局Python3.6中零散安装包,直接修改wsgi配置,把虚拟环境的模块查找路径加入sys.path即可:

  1. 先找到你项目虚拟环境对应的site-packages绝对路径,路径格式一般为:/你的虚拟环境存放路径/lib/对应Python版本/site-packages
  2. 修改/var/www/dj/dj.wsgi配置,在sys.path初始化部分插入虚拟环境路径,修改后的示例配置如下:
    #!/usr/bin/python3
    import sys
    import logging
    logging.basicConfig(stream=sys.stderr)
    # 插入项目根目录路径
    sys.path.insert(0,"/var/www/dj/")
    # 插入虚拟环境的site-packages路径
    sys.path.insert(0, "/home/xxx/你的虚拟环境路径/lib/python3.6/site-packages")
    
    from dj import app as application
    application.secret_key = 'SECERET'
    
  3. 注意:如果你的虚拟环境Python版本和mod_wsgi绑定的Python3.6大版本不一致,仅加路径会出现二进制兼容问题,这种情况需要重新安装和虚拟环境Python版本匹配的mod_wsgi模块,替换Apache当前加载的旧版本。

额外排查项

  • 确认Apache默认运行用户www-data对项目目录、虚拟环境目录有读取权限,避免路径匹配正确但权限不足、无法读取模块文件的问题。
  • 生产环境不要在wsgi配置中开启debug模式,既存在安全风险,也可能触发其他服务异常。

内容的提问来源于stack exchange,提问作者Dhruv Arne

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.01 14:36:09