虚拟环境下SqlAlchemy报错：无法从'sqlalchemy'导入名称'inspect'

问题根因 #

你遇到的导入错误是虚拟环境中Flask-SQLAlchemy与SQLAlchemy版本不匹配导致的。全局环境下两个依赖版本兼容所以直接运行正常，虚拟环境内的依赖版本组合存在兼容性问题。你之前仅核对了flask_sqlalchemy的配置一致性，没有对齐SQLAlchemy本身的版本，Flask-SQLAlchemy对依赖的SQLAlchemy版本有严格要求，版本不匹配就会触发这类导入错误。

解决步骤 #

• 首先激活第二个项目的虚拟环境：
  source /root/myproject2/myprojectenv2/bin/activate
• 卸载虚拟环境内现有两个包，清除残留冲突：
  pip uninstall -y flask-sqlalchemy sqlalchemy
• 安装经过验证的兼容版本组合：
  pip install flask-sqlalchemy==3.0.5 sqlalchemy==2.0.20
• 验证导入是否正常：
  进入Python交互环境执行from flask_sqlalchemy import SQLAlchemy，无报错即说明版本冲突已解决。
• 重启对应的uWSGI服务使修改生效，如果你使用systemd管理服务，执行：
  systemctl restart 你的第二个项目uWSGI服务名

注意事项 #

后续给虚拟环境安装依赖时尽量直接在激活虚拟环境后用pip安装，不要手动同步全局和虚拟环境的包文件，避免出现依赖版本不对齐的问题。

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