Heroku部署Flask应用无法识别已安装flask_sqlalchemy包如何解决

问题原因 #

导致Heroku无法找到flask_sqlalchemy包的常见原因有3种：

1. requirements.txt配置/提交异常：本地的requirements.txt没有正确推送到Heroku关联的git仓库，或者文件存放位置不对、内容拼写错误，导致Heroku安装依赖时没有加载该包
2. Pipfile优先级冲突：如果项目根目录同时存在Pipfile/Pipfile.lock文件，Heroku会优先使用Pipfile安装依赖，忽略requirements.txt，若Pipfile中未声明Flask-SQLAlchemy依赖就会触发报错
3. 版本兼容问题：你的Flask和Flask-SQLAlchemy版本组合在Heroku的Linux运行环境中存在兼容问题，导致依赖安装失败

修复方案 #

• 第一步：校准requirements.txt配置
  激活本地项目对应的虚拟环境后，执行pip freeze > requirements.txt命令重新生成依赖清单，确认文件内存在Flask-SQLAlchemy==2.5.1这一行，且文件存放在项目根目录和app.py同级。之后执行以下命令提交更新到Heroku：

  git add requirements.txt
  git commit -m "fix: 补充完整依赖清单"
  git push heroku main
  

  注意如果你的git主分支名称为master，需要将最后一行命令中的main替换为master。
• 第二步：处理Pipfile冲突
  检查项目根目录是否存在Pipfile、Pipfile.lock文件：
  • 如果你不需要用pipenv管理依赖，直接删除这两个文件后重新提交推送即可
  • 如果你需要保留pipenv配置，执行pipenv install Flask-SQLAlchemy==2.5.1更新Pipfile，再将Pipfile和Pipfile.lock提交推送
• 第三步：兼容问题修复
  如果以上操作后仍报错，可以通过heroku run bash进入应用运行容器，执行pip list查看已安装依赖，确认Flask-SQLAlchemy是否安装成功。如果安装失败，可尝试调整依赖版本，比如将requirements.txt中的Flask版本改为1.1.4、Flask-SQLAlchemy版本改为2.4.4后重新提交。

额外提醒：Heroku的文件系统是临时的，每次应用重启、部署都会清空所有本地文件，你当前使用的SQLite数据库数据会完全丢失，建议生产环境切换为Heroku提供的PostgreSQL数据库服务。

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