Django使用for/if在Bootstrap轮播显示模型图片时遇无效块标签报错

Django模板有严格的语法区分：

• {% %} 是逻辑块标签的专用语法，仅用于编写循环、条件判断、模板引入这类需要执行逻辑操作的代码，不能直接用来输出变量值
• {{ }} 是变量渲染的专用语法，用来输出模型字段、上下文变量、属性调用的结果

你在img标签的src属性里，把图片路径的输出写在了{% %}块标签中，Django解析到该代码行时，会将item.carousel_picture.url识别为未注册的自定义块标签，最终触发无效块标签的报错。

• 首先解决当前的语法错误：将所有写在img src里的{% item.carousel_picture.url %}替换为{{ item.carousel_picture.url }}
• 优化原有冗余代码：原代码中拆分两个独立div判断首项加active类的逻辑，可以合并为同一个div减少重复代码；同时因为模型的图片字段设置了允许为空，需要补充空值判断，避免空对象调用url属性引发运行时错误，修正后的循环代码参考：

{% for item in carousel_items %}
  {% if item.carousel_picture %}
    <div class="carousel-item {% if forloop.first %}active{% endif %}">
      <img src="{{ item.carousel_picture.url }}" class="d-block w-100" alt="轮播图">
    </div>
  {% endif %}
{% endfor %}

• 确认settings.py中MEDIA_URL、MEDIA_ROOT配置正确，开发环境下已在根路由文件中绑定媒体文件的访问路径，否则即使语法修正，图片也无法正常加载
• 空值判断逻辑不能省略，否则遇到未上传图片的轮播条目时，会触发空对象调用属性的报错

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