Django项目HTML模板For循环异常，用户搜索结果无法正常展示

问题排查及解决方法 #

1. 修正视图参数默认值

你views.py里的搜索参数默认值设置错误：

# 错误写法
searched = request.POST.get('searched',False)

这里默认值是布尔值False，如果提交的搜索内容为空、或者表单字段名不匹配，会把布尔值传到查询语句里，first_name__contains=False永远匹配不到任何用户，修改为：

# 正确写法
searched = request.POST.get('searched', '').strip()

把默认值设为空字符串，同时加strip()去除首尾空格，避免用户输入全空格的无效查询。

2. 改为大小写不敏感匹配

Django的__contains查询默认是大小写敏感的，比如数据库存的first_name是Anna，你输入anna就查不到结果，如果需要忽略大小写，把查询条件改为：

users = User.objects.filter(first_name__icontains=searched)

__icontains是大小写不敏感的包含匹配，更符合普通搜索的使用习惯。

3. 验证是否存在匹配数据

可以先在Django shell里手动执行查询验证是否有匹配结果：

1. 进入项目根目录执行python manage.py shell
2. 导入模型：from 你的应用名.models import User
3. 执行查询：print(User.objects.filter(first_name__contains="你确定存在的用户名").count())
   如果返回0说明确实没有匹配数据，大于0说明查询逻辑没问题，再排查模板层问题。

4. 排查表单配置

确认你的搜索表单的method属性是POST，且搜索输入框的name属性严格等于searched，示例正确的表单写法：

<form method="POST" action="{% url 'search_users' %}">
    {% csrf_token %}
    <input type="text" name="searched" placeholder="搜索用户">
    <button type="submit">搜索</button>
</form>

如果method写的是GET，或者输入框name不是searched，都会导致拿不到正确的搜索参数。

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