Flask应用环境变量设置/读取错误：跨文件访问问题

问题场景 #

你在__init__.py中通过os.environ设置环境变量：

import os

# set mkey environment variable
MKEY="xxxx"
os.environ["MKEY"] = MKEY

但在file1.py中读取该变量时触发KeyError：

import os
token = os.environ["MKEY"]

报错信息：

token = os.environ["MKEY"]
  File "/Applications/Anaconda/anaconda3/lib/python3.9/os.py", line 679, in __getitem__
    raise KeyError(key) from None
KeyError: 'MKEY'

遍历os.environ也找不到该变量，说明环境变量未全局生效。

解决方案（均无需使用export命令） #

1. 使用Flask内置配置对象（推荐） #

Flask自带全局配置管理，直接将变量存入Flask实例的config字典，所有文件可通过Flask实例或current_app访问：

• 在__init__.py中初始化配置：

from flask import Flask

app = Flask(__name__)
# 将变量存入Flask配置
app.config['MKEY'] = 'xxxx'

• 在file1.py中访问：

from flask import current_app

# 在请求上下文内（比如视图函数中）使用current_app
def some_view():
    token = current_app.config['MKEY']
    # ...

# 在请求上下文外（比如启动脚本、工具函数），直接导入app实例
# from your_app_package import app
# token = app.config['MKEY']

2. 使用.env配置文件（适合多环境切换） #

通过python-dotenv加载本地.env文件，将变量注入os.environ，同时可存入Flask配置：

1. 安装依赖：

pip install python-dotenv

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

MKEY=xxxx

3. 在__init__.py中加载.env并配置：

from flask import Flask
from dotenv import load_dotenv
import os

# 加载.env文件中的变量到os.environ
load_dotenv()

app = Flask(__name__)
# 可选：将变量存入Flask配置，统一管理
app.config['MKEY'] = os.getenv('MKEY')

4. 在file1.py中访问：

import os
# 直接从os.environ获取
token = os.getenv('MKEY')

# 或者通过Flask配置获取
from flask import current_app
token = current_app.config['MKEY']

注意：将.env加入.gitignore，避免敏感信息提交到版本控制。

3. 自定义独立配置文件 #

创建单独的配置文件统一管理所有变量，适合复杂项目的多环境配置：

1. 创建config.py：

# 基础配置
BASE_CONFIG = {
    'MKEY': 'xxxx'
}

# 开发环境配置
class DevelopmentConfig:
    MKEY = 'dev_xxxx'

# 生产环境配置
class ProductionConfig:
    MKEY = 'prod_xxxx'

2. 在__init__.py中导入配置：

from flask import Flask
from config import DevelopmentConfig

app = Flask(__name__)
# 从配置类加载
app.config.from_object(DevelopmentConfig)
# 或者从字典加载
# app.config.from_mapping(config.BASE_CONFIG)

3. 在file1.py中访问：

# 方式1：通过Flask配置
from flask import current_app
token = current_app.config['MKEY']

# 方式2：直接导入配置模块
from config import DevelopmentConfig
token = DevelopmentConfig.MKEY

原方法失效原因 #

你之前的写法中，os.environ的设置仅在__init__.py执行时生效，如果file1.py在__init__.py之前被导入（比如启动脚本先导入file1.py），此时环境变量还未被设置；或者应用启动流程中__init__.py的代码未被执行到，导致变量未全局注入。

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