Django中Agreements模型搜索功能异常：搜索后返回空列表

1. 修正查询逻辑 #

确保视图中使用模糊匹配而非精确匹配，俄语用户名的空格、大小写差异会导致精确匹配失效。正确写法示例：

# views.py
from django.shortcuts import render
from .models import Agreements

def search_agreements(request):
    search_query = request.GET.get('q', '').strip()
    results = Agreements.objects.none()
    if search_query:
        # 用icontains实现不区分大小写的模糊搜索
        results = Agreements.objects.filter(username__icontains=search_query)
    return render(request, 'search_result.html', {'results': results, 'query': search_query})

2. 验证模板表单参数 #

确认搜索输入框的name属性与视图中获取的参数名一致（比如示例中的q），避免无法传递搜索关键词：

<!-- 模板表单示例 -->
<form method="GET" action="{% url 'search_agreements' %}">
    <input type="text" name="q" placeholder="输入用户名搜索" value="{{ query }}">
    <button type="submit">搜索</button>
</form>

3. 直接测试数据库查询 #

在Django Shell中手动执行查询，确认数据库中是否存在目标数据：

python manage.py shell

执行查询代码：

from your_app.models import Agreements
# 用目标用户名的部分内容测试，比如"Иван"
Agreements.objects.filter(username__icontains="Иван")

如果返回空，说明数据库中无对应数据；如果有结果，问题出在视图或模板的逻辑传递上。

4. 检查字符编码配置 #

俄语属于Unicode字符，需确保数据库支持UTF-8编码。在settings.py中配置数据库编码：

DATABASES = {
    'default': {
        # 以MySQL为例，其他数据库类似配置
        'ENGINE': 'django.db.backends.mysql',
        'NAME': 'your_db_name',
        'USER': 'your_db_user',
        'PASSWORD': 'your_db_pass',
        'OPTIONS': {
            'charset': 'utf8mb4',
        },
    }
}

同时确保模板文件保存为UTF-8编码，避免关键词传递时乱码。

5. 确认URL路由映射 #

检查urls.py中路由名称与模板表单action的url标签一致：

# urls.py
from django.urls import path
from . import views

urlpatterns = [
    path('search/', views.search_agreements, name='search_agreements'),
]

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