为何.flaskenv变量在uWSGI中失效但直接运行Flask正常？

问题原因 #

Flask开发服务器（python app.py或flask run）会自动集成python-dotenv的加载逻辑，自动识别并加载项目根目录下的.flaskenv文件。但uWSGI是直接执行Python应用代码，不会触发这个自动加载流程，因此无法读取到文件中的环境变量。

解决方案 #

1. 在代码中手动加载.flaskenv #

修改app.py，在初始化Flask应用前手动调用load_dotenv加载环境变量文件：

from dotenv import load_dotenv
import os
import uuid
from flask import Flask

# 手动加载项目根目录下的.flaskenv文件
load_dotenv('.flaskenv')

app = Flask(__name__)
app.config["SECRET_KEY"] = uuid.uuid4().hex
musicdir = os.environ.get('MUSIC_DIR')

这种方式不受启动方式影响，任何环境下启动都会加载环境变量。

2. 通过uWSGI参数直接加载环境变量文件 #

启动uWSGI时，使用--env-file参数指定.flaskenv文件路径：

uwsgi --socket 0.0.0.0:5000 --wsgi-file app.py --callable app --env-file .flaskenv

注意：如果启动uWSGI时不在项目根目录，需要指定.flaskenv的绝对路径（比如/home/user/project/.flaskenv）。

3. 先加载环境变量再启动uWSGI #

在shell脚本中先将.flaskenv的变量导入当前环境，再启动uWSGI：

# 激活虚拟环境
source /path/to/your/venv/bin/activate
# 过滤注释行，将环境变量导入shell
export $(grep -v '^#' .flaskenv | xargs)
# 启动uWSGI
uwsgi --socket 0.0.0.0:5000 --wsgi-file app.py --callable app

排查要点 #

• 确认uWSGI启动时的工作目录是否为项目根目录：可以在app.py中添加print(os.getcwd())，查看输出路径是否包含.flaskenv文件。
• 验证虚拟环境是否正确使用：确保uWSGI调用的是虚拟环境中的Python解释器，可以通过uwsgi --pythonpath /path/to/venv/lib/pythonX.X/site-packages指定虚拟环境的包路径。
• 检查环境变量是否被正确加载：在app.py中添加print(os.environ.get('MUSIC_DIR'))，启动uWSGI后查看日志输出，确认变量是否为空。

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