Django模板使用filter()报错TemplateSyntaxError的解决咨询

问题原因 #

Django模板语法不支持直接调用带参数的方法（如filter(grupo__isnull=True)），这就是触发TemplateSyntaxError的核心原因。模板仅允许调用无参数方法或使用内置/自定义过滤器。

解决方法 #

1. 在模型类中添加判断方法（推荐）

直接在Modalidad模型里新增封装过滤逻辑的无参数方法，模板直接调用即可：

class Modalidad(models.Model):
    # 原有字段定义...

    def has_ungrouped_teams(self):
        # 检查当前模态下是否存在未分组的Team
        return self.team_set.filter(grupo__isnull=True).exists()

修改模板代码：

{% for m in modalidades %}
      <div class="col-4 col-md-2 col-xxl-1 text-center pb-4 pb-xxl-0 ">
          <span class="fs-3 lh-1">{{ m.siglas }}</span>
          <h1 class="fs-3 pt-3">{{ m.team_set.all|length }}</h1>
     {% if m.has_ungrouped_teams %}
          <button class="btn btn-primary btn-sm me-1 mb-1" type="button">Crear Grupos</button>
     {% endif %}
     </div>
{% endfor %}

2. 在视图中预处理数据

如果不想修改模型，可以在视图中提前计算每个Modalidad的判断结果，添加到对象属性中：

def grupos(request):
    modalidades = Modalidad.objects.filter(disciplina=1, temporada__activo=True).order_by('-siglas')
    
    # 给每个模态对象添加判断属性
    for m in modalidades:
        m.has_ungrouped_teams = m.team_set.filter(grupo__isnull=True).exists()
    
    context = {'modalidades': modalidades}
    return render(request, 'temporadas/grupos.html', context=context)

模板代码和方案1一致，直接使用{% if m.has_ungrouped_teams %}即可。

3. 自定义模板过滤器

创建自定义过滤器处理查询集过滤，注意规避安全风险：
在你的app目录下创建templatetags/custom_filters.py文件：

from django import template

register = template.Library()

@register.filter
def has_matching(queryset, filter_kwargs):
    # 仅当filter_kwargs为可控硬编码值时使用，避免用户输入引发安全问题
    kwargs = eval(filter_kwargs)
    return queryset.filter(**kwargs).exists()

在模板开头加载过滤器后使用：

{% load custom_filters %}

{% for m in modalidades %}
      <div class="col-4 col-md-2 col-xxl-1 text-center pb-4 pb-xxl-0 ">
          <span class="fs-3 lh-1">{{ m.siglas }}</span>
          <h1 class="fs-3 pt-3">{{ m.team_set.all|length }}</h1>
     {% if m.team_set|has_matching:"{'grupo__isnull': True}" %}
          <button class="btn btn-primary btn-sm me-1 mb-1" type="button">Crear Grupos</button>
     {% endif %}
     </div>
{% endfor %}

注意事项 #

• 方案1和2更安全易维护，优先选择；方案3中的eval存在安全风险，若过滤参数来自用户输入，请勿使用，可改用JSON解析等更安全的方式。

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