Flask Jinja2报'user' is undefined错误问题咨询

这个报错本质是模板渲染时找不到user变量，和你子页面本身的逻辑没关系——你所有页面都继承了layout.html公共模板，这个模板里写了调用user的逻辑（比如顶部导航的用户信息、登录态判断），你只在账号编辑页的视图函数里给模板传了user参数，其余页面的render_template调用都漏传了。你自己觉得所有用到的地方都传了，大概率是只检查了单个子模板的变量引用，没意识到继承公共模板后，所有页面都会加载layout里的代码，只要layout用了user，不管子页面用不用都得传这个值。

别在每个视图函数里单独传user，这种写法后续加新页面百分百还会漏，直接做全局模板注入一次搞定：

• 打开main.py，在路由定义前加全局用户加载和模板注入逻辑，代码如下，注意把注释里标注的部分换成你自己项目的实际逻辑：

from flask import session, g

# 每个请求进来先加载当前登录用户
@app.before_request
def load_user():
    # 如果你存在session里的用户标识键名不是user_id，换成你自己用的
    current_user_id = session.get("user_id")
    if not current_user_id:
        g.user = None
    else:
        # 替换成你项目里查询用户的实际代码，比如用SQLAlchemy就写对应模型查询，用pymysql就写对应查询逻辑
        g.user = User.query.get(current_user_id)

# 把user变量注入到所有模板的上下文，所有模板都能直接调用，不用单独传
@app.context_processor
def push_user_to_template():
    return {"user": g.user}

• 加完这段之后，把之前各个视图函数里render_template括号里单独写的user=xxx参数全删掉，避免重复传参。
• 回到layout.html里所有用到user的位置，补个空值判断，避免未登录状态下取值报错：

<nav>
  <!-- 其他导航内容 -->
  {% if user %}
    <div class="user-info">
      <span>你好，{{ user.nickname }}</span>
      <a href="/edit">账号编辑</a>
      <a href="/logout">退出登录</a>
    </div>
  {% else %}
    <div class="auth-entry">
      <a href="/login">登录</a>
      <a href="/register">注册</a>
    </div>
  {% endif %}
</nav>

如果你暂时不想调整全局逻辑，就顺着报错traceback里的模板路径找：只要报错的模板栈里出现layout.html，就去对应触发报错的路由视图函数里看，render_template的参数里肯定没传user，补上就行。注意别漏了自定义错误页（比如404、500页面）、首页这些你可能觉得不需要传用户信息的页面，只要继承了带user引用的layout，就必须传这个值。

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