Flask应用中os.environ.get()返回None的问题排查

问题核心是：~/.bashrc里的环境变量仅在交互式bash会话中加载，Flask进程作为非交互式子进程时无法读取到，导致os.environ.get()返回None。以下是几种可行的解决方法：

方法1：调整环境变量的加载位置 #

把export MAPBOX_ACCESS_TOKEN='XXXXXXXX'从~/.bashrc移到~/.profile（Linux）或~/.bash_profile（macOS），这些文件在用户登录时会自动加载，无论是否是交互式会话。

如果不想移动，也可以修改~/.bashrc开头的判断逻辑：找到类似[ -z "$PS1" ] && return的行，注释掉它，这样非交互式bash也会加载~/.bashrc的内容。修改后需要重新登录终端或执行source ~/.bashrc生效。

方法2：启动前手动导出环境变量 #

在启动Flask的终端中，先执行：

export MAPBOX_ACCESS_TOKEN='XXXXXXXX'

再运行Flask应用：

python app.py

这样当前终端的所有子进程（包括Flask）都能读取到这个环境变量。

方法3：用.env文件管理敏感变量（推荐） #

这种方式更安全且便于项目维护：

1. 安装依赖：

pip install python-dotenv

2. 在项目根目录创建.env文件，写入：

MAPBOX_ACCESS_TOKEN=XXXXXXXX

3. 修改Flask代码加载.env文件：

from flask import Flask, render_template
import os
from dotenv import load_dotenv

# 加载项目根目录的.env文件
load_dotenv()

app = Flask(__name__)

@app.route('/')
def hello_world():
    access_token = os.environ.get('MAPBOX_ACCESS_TOKEN')
    return render_template('index.html', mapbox_access_token=access_token)

if __name__ == '__main__':
    app.run()

4. 务必把.env添加到.gitignore中，防止敏感信息被提交到代码仓库：

# .gitignore内容
.env

验证环境变量是否生效 #

在启动Flask的终端执行：

echo $MAPBOX_ACCESS_TOKEN

如果能输出正确的令牌值，说明环境变量已成功加载；如果输出为空，需要检查配置是否正确，并重登终端或执行source命令刷新环境变量。

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