Flask MVC模式下Jinja2模板无法获取ViewModel输出值问题

1. 确认视图传递ViewModel的正确性 #

• 检查视图函数是否将ViewModel完整实例传递给render_template，而非仅传递部分属性或错误变量名：

  # 错误示例：仅传递单个属性
  return render_template('canaries.html', content=vm.html_content)
  # 正确示例：传递完整ViewModel实例，模板中通过实例访问属性
  return render_template('canaries.html', vm=vm)
  

2. 检查ViewModelBase的属性访问权限 #

• 确保ViewModel中存储HTML内容的属性是公开可访问的，Jinja2无法直接读取双下划线开头的私有属性：

  # 错误示例：私有属性无法被Jinja2访问
  class ViewModelBase:
      def __init__(self):
          self._html_content = ""
  # 正确示例1：使用公开属性
  class ViewModelBase:
      def __init__(self):
          self.html_content = ""
  # 正确示例2：使用@property装饰器封装私有属性
  class ViewModelBase:
      def __init__(self):
          self._html_content = ""
      
      @property
      def html_content(self):
          return self._html_content
  

3. 确保ViewModel已执行生成逻辑 #

• 终端能打印正常说明生成逻辑没问题，但要确认视图中在传递ViewModel前已调用生成HTML的方法：

  def canaries_view():
      vm = CanariesViewModel()
      # 必须先调用生成方法，否则属性为空
      vm.generate_html()
      return render_template('canaries.html', vm=vm)
  

4. 验证模板变量访问的正确性 #

• 模板中需使用与视图传递一致的变量名和属性名，若要渲染原始HTML需添加safe过滤器避免转义：

  {# 错误示例：变量名或属性名拼写错误 #}
  {{ vm.html_contnet }}
  {# 正确示例：正确访问并渲染原始HTML #}
  {{ vm.html_content|safe }}
  

5. 排查ViewModel是否被意外重置 #

• 检查视图代码中，生成ViewModel实例后是否存在重新赋值操作，导致传递给模板的是未执行生成逻辑的空实例。

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