Django视图传递的字典列表在模板中无法渲染显示如何解决

• 原因1：服务未重载导致代码变更不生效
  若项目DEBUG配置为False，或是Django开发服务的自动重载机制失效，视图中新增的rooms变量未被服务加载，模板实际拿到的变量为空。
  解决办法：手动重启Django开发服务，重新加载全部视图代码。
• 原因2：上下文变量键名冲突被覆盖
  如果你配置了自定义上下文处理器，或是引入的第三方组件自带上下文处理器，且处理器返回的参数字典中存在同名的rooms键，上下文处理器的优先级高于视图传递的context，会将你定义的列表覆盖为空。
  解决办法：修改视图中context的键名避免冲突，示例：

  def home(request):
      # 修改键名为无冲突的room_list
      context = {'room_list': rooms}
      return render(request, 'home.html', context)
  

  模板对应修改循环语句即可：

  {% for room in room_list %}
      <div>
          <h1>{{room.name}}</h1>
      </div>
  {% endfor %}
  

• 原因3：模板语法隐性错误
  若实际编写代码时存在for循环拼写错误、标签未闭合等问题，也会导致循环不执行。
  排查方法：在模板的<h1>Home Template</h1>下方新增一行{{ rooms }}直接输出变量内容：
  • 若输出为空/None：说明变量未正确传递到模板，按前两个原因排查
  • 若能正常输出列表内容：检查for循环语法、变量名拼写是否和context配置一致
• 原因4：模板缓存导致旧版本生效
  如果你开启了Django模板缓存，还未添加循环逻辑的旧模板被缓存，新修改的代码不会展示。
  解决办法：开发阶段关闭模板缓存，或者清除项目缓存后重新访问。

额外兼容优化：可以将子模板的{% endblock content %}改为和父模板一致的{% endblock %}，避免旧版本Django的块匹配兼容问题。

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