为何Flask应用执行python ml_app.py正常，heroku local web/flask run异常？

数据老陈

2026-5-21

排查Heroku Local Web运行Flask应用的常见问题

Hey there! Let's break down the common issues that pop up when running a Flask app with heroku local web even if it works fine with python ml_app.py locally. Since you didn't share the exact error message, I'll cover the most frequent culprits and fixes:

Procfile配置错误
Heroku依赖Procfile来启动应用，一定要确保配置命令正确。针对Flask应用，标准的Procfile内容应该是：
```
web: gunicorn ml_app:app
```
如果只是本地测试想用Flask自带服务器（不推荐生产环境用），也可以写成：
```
web: python ml_app.py
```
注意：如果用gunicorn，必须把它添加到requirements.txt里，不然Heroku找不到这个依赖。
环境变量未配置
Heroku local会读取.env文件里的环境变量，但你本地直接跑python ml_app.py时可能用的是shell里的变量，两者不互通。Flask应用通常需要配置这些变量：
```
FLASK_APP=ml_app.py
FLASK_ENV=development
```
另外如果你的模型加载需要特定路径、密钥之类的变量，也一定要都写到.env里。
依赖包不匹配
就算你本地装好了所有依赖，要是requirements.txt漏了包或者版本不对，heroku local照样会报错。执行pip freeze > requirements.txt把本地所有依赖都同步到文件里，包括Flask、scikit-learn、gunicorn这些核心包。另外记得用runtime.txt指定Python版本（比如python-3.10.12），确保和Heroku使用的版本一致。
模型加载路径问题
加载训练模型时如果用了本地绝对路径，在Heroku local环境里大概率会找不到文件。换成相对路径试试，比如模型放在models文件夹里：
```
import joblib
model = joblib.load('./models/trained_model.pkl')
```
还要确认模型文件没被加到.gitignore里，不然Heroku访问不到。
端口冲突
heroku local web默认用5000端口，如果这个端口被其他进程占用，就会启动失败。可以换个端口试试：
```
heroku local web -p 5001
```