g对象非线程/协程安全，仅限单请求生命周期内有效；必须在before_request等请求上下文中初始化赋值，不可跨请求、跨线程或跨协程共享，误用将导致数据错乱或RuntimeError。
g对象不是线程安全的，多线程或异步场景下会出错
g 是 Flask 提供的请求上下文全局变量，只在单个请求生命周期内有效，**不是跨请求、也不是跨线程/协程共享的**。如果你在 threading.Thread 里直接读写 g，或者用 asyncio + await 时没注意上下文切换，g 会是空的、报 RuntimeError: Working outside of application context，甚至拿到其他请求的数据。
常见错误现象：
- 使用
ThreadPoolExecutor异步处理数据库操作时，g.db突然为None - 在
before_request中赋值g.user_id = 123，但在after_request或日志中间件里访问时报 AttributeError - 用
gevent或uvicorn --workers 4部署后，g值偶尔错乱
根本原因：Flask 的 g 依赖 werkzeug.local.Local，它靠线程 ID 或 greenlet ID 做隔离——但协程切换不触发 ID 变更，多进程里更完全不共享。
正确初始化和赋值 g 对象必须在 before_request 或请求上下文中
不能在模块顶层、app = Flask(__name__) 后直接写 g.xxx = ...，那会报 RuntimeError。所有赋值必须发生在请求已进入上下文之后。
立即学习“Python免费学习笔记（深入）”；
推荐做法：
- 在
@app.before_request中解析 token、查用户、打开数据库连接，并存入g - 用
g.setdefault('db', get_db_connection())避免重复创建（但注意连接不能跨请求复用） - 如果要用类封装逻辑，确保实例化发生在
before_request内，而不是全局
示例：
@app.before_request
def load_user():
auth_header = request.headers.get('Authorization')
if auth_header and auth_header.startswith('Bearer '):
token = auth_header[7:]
try:
user_data = decode_jwt(token) # 假设你有解码函数
g.user_id = user_data['id']
g.is_admin = user_data.get('admin', False)
except Exception:
g.user_id = None
g.is_admin = False
else:
g.user_id = None
g.is_admin = False
g 对象不能替代 session 或数据库存储用户状态
g 只活到当前请求结束，响应发出后就销毁。如果你在视图里把用户权限存进 g.permissions，然后想在模板里用，可以；但想在下一个请求里接着用？不行——那是 session 或缓存的事。
典型误用：
- 在登录成功后写
g.login_time = time.time()，以为下次请求还能读到 - 把临时上传文件路径存在
g.upload_path，然后在后台任务里引用（后台任务已脱离请求上下文） - 用
g.cache = {}做简易缓存，结果发现不同请求互相覆盖
记住：g 是“本次请求的便签纸”，不是“跨请求记事本”。需要持久或共享的状态，该走 session、Redis、或参数显式传递。
调试时怎么确认 g 是否可用、有没有被污染
最直接的方式是在视图函数开头加一行打印：
print(f"g keys: {list(g.__dict__.keys())}, id: {id(g)}")
还可以在 teardown_request 里检查资源是否被正确清理：
@app.teardown_request
def close_db(error):
if hasattr(g, 'db') and g.db is not None:
g.db.close()
delattr(g, 'db') # 主动清理，避免残留
容易忽略的点：
-
g是动态属性容器，hasattr(g, 'xxx')比g.xxx is not None更可靠（因为可能显式赋了None） - 测试时用
app.test_request_context()手动构造上下文，否则单元测试里直接访问g会报错 - 蓝本（Blueprint）里也能用
g，但它和主应用共用同一个g实例，不存在隔离
真正难处理的，是那些你以为还在请求上下文里、其实已经被 await 或 run_in_executor 带跑偏的代码路径。这时候别硬扛 g，把需要的数据作为参数传进去更稳妥。
