Flask中Jinja2模板过滤关联模型已删除数据失败问题排查

我有category表和post表，二者为一对多关联关系（post表包含关联category_id的外键）。查询category表并将结果传入Jinja2模板，通过嵌套循环按分类展示所有关联帖子，原代码如下：

{% for val in cat_list %}
    {% for i in val.posts.all() %}
        <p>{{ i.msg }}</p>
    {% endfor %}
{% endfor %}

这段代码可正常展示全部帖子，但我希望过滤掉status为Deleted的帖子，修改后的代码如下：

{% for val in cat_list %}
    {% for i in val.posts.filter(val.posts.status != 'Deleted' ).all() %}
        <p>{{ i.msg }}</p>
    {% endfor %}
{% endfor %}

修改后无法过滤已删除帖子，仍显示全部内容，请问我的过滤写法哪里出错了？

问题原因与解决方法 #

1. 模板中filter()的写法错误 #

你在filter()里的参数写法不符合ORM的语法要求：

• val.posts.status这种引用方式是错误的，ORM的filter()需要直接使用字段表达式，而不是通过关联对象引用字段。
• 以SQLAlchemy为例，正确的写法应该直接使用字段名，或者通过模型类的字段来构建条件。

模板中正确的过滤写法示例：

{% for val in cat_list %}
    {% for i in val.posts.filter(status != 'Deleted').all() %}
        <p>{{ i.msg }}</p>
    {% endfor %}
{% endfor %}

如果上述写法不生效，可以明确指定模型类的字段：

{% for val in cat_list %}
    {% set PostModel = val.posts.property.mapper.class_ %}
    {% for i in val.posts.filter(PostModel.status != 'Deleted').all() %}
        <p>{{ i.msg }}</p>
    {% endfor %}
{% endfor %}

2. 更推荐的后端过滤方案 #

不建议在模板中做数据过滤，这既不符合MVC分层思想，也会影响性能（模板中触发额外查询）。更好的做法是在后端查询Category时，直接预先过滤关联的Post。

以SQLAlchemy为例，后端查询代码可以这样写：

from models import Category, Post
from your_app import db

# 使用joinedload预先加载并过滤关联的帖子
cat_list = Category.query.options(
    db.joinedload(Category.posts).filter(Post.status != 'Deleted')
).all()

或者如果需要只返回存在有效帖子的分类：

cat_list = Category.query.filter(
    Category.posts.any(Post.status != 'Deleted')
).options(
    db.joinedload(Category.posts).filter(Post.status != 'Deleted')
).all()

这样传到模板的cat_list中，每个分类的posts已经是过滤后的结果，模板只需保留最初的循环即可：

{% for val in cat_list %}
    {% for i in val.posts %}
        <p>{{ i.msg }}</p>
    {% endfor %}
{% endfor %}

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