Django模板遍历OneToOneField关联属性报不可迭代错误解决方法

OneToOneField的反向关联返回值是单个PropertyFeatures模型实例，不是可迭代的查询集对象，直接对其使用for循环遍历自然会触发不可迭代报错。你单独访问property.features.has_garden能正常渲染，是因为这属于单实例的属性取值操作，逻辑完全正确。

不要尝试在模板里硬写遍历逻辑，Django模板的设计定位就是做轻量渲染，复杂数据处理最好放在视图层完成，这种方式后续新增特性字段时不需要修改模板代码，可维护性最高。

调整视图逻辑 #

原视图中用property作为变量名会和Python内置的property装饰器重名，存在潜在冲突，建议先修改为其他命名。之后通过模型内置的_meta接口过滤出需要展示的特性字段，组装成列表传入模板即可：

def property_detailview(request, pk):
    template_name = "property/detail.html"
    property_obj = Property.objects.get(id=pk)
    
    # 预处理要展示的特性字段
    feature_list = []
    for field in property_obj.features._meta.get_fields():
        # 跳过主键、外键这类不需要展示的自动生成字段
        if field.name in ("id", "property"):
            continue
        feature_list.append({
            "label": field.verbose_name if field.verbose_name else field.name,
            "status": getattr(property_obj.features, field.name)
        })

    context = {
        "property": property_obj,
        "feature_list": feature_list
    }
    return render(request, template_name, context)

调整模板代码 #

直接遍历视图传入的feature_list渲染即可：

{% block content %}
    {% include "includes/navigation/navbar.html" %}
    <div class="container">
        <h1>
            {{ property.title }}
        </h1>
        <div class="property-features">
            {% for feature in feature_list %}
            <div class="feature-item">
                <span class="feature-label">{{ feature.label }}：</span>
                <span class="feature-value">{% if feature.status %}支持{% else %}不支持{% endif %}</span>
            </div>
            {% endfor %}
        </div>
    </div>
{% endblock content %}

后续你只需要在PropertyFeatures模型里新增布尔类型的特性字段，不需要修改视图和模板代码，新字段会自动被收集渲染。

不推荐的替代方案 #

如果一定要把遍历逻辑放在模板里，需要先编写自定义模板过滤器来读取模型实例的字段列表，再在模板中调用过滤器实现遍历。这种方式会增加模板层的逻辑复杂度，后续维护成本更高，非特殊场景不建议使用。

注意：Django模板默认会拦截所有以下划线开头的属性访问，所以你无法直接在模板中通过property.features._meta的方式读取字段元数据。

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