django-elasticsearch-dsl是第三方库，需手动安装es客户端、配置连接、定义索引，信号仅同步增删改，重建索引需运行search_index --rebuild，search()返回search对象而非queryset，分页用切片，精确匹配须用keyword子字段，类型映射错误或同步延迟易致搜索异常。
django-elasticsearch-dsl 不是 Django 官方组件，别当内置功能用
它只是个第三方封装库，底层完全依赖 elasticsearch-py 和 Django 的信号机制。你得自己装客户端、配连接、写索引定义，Django 不会帮你自动建 mapping 或同步数据。
- 必须显式安装
elasticsearch（v7.x）或elasticsearch8（v8.x），django-elasticsearch-dsl本身不带 ES 客户端 -
ELASTICSEARCH_DSL配置里hosts写错端口（比如用了9200但实际是9201）会导致ConnectionError: Connection refused - 模型加
@document装饰器后，要手动运行python manage.py search_index --rebuild才会真正建索引，信号只管后续增删改
search() 返回的是 Search 对象，不是 QuerySet
调用 MyDocument.search() 得到的是 elasticsearch-dsl 的 Search 实例，不是 Django 的 QuerySet，不能直接 .filter() 或 .order_by() —— 那些是 Django ORM 的方法，ES 不认。
- 排序要用
.sort('-pub_date')，字段名得和 ES mapping 里定义的一致（比如pub_date.keyword才能精确排序） - 分页用
[start:end]切片，不是.paginate()；[0:10]发出的请求里就是from=0&size=10 - 想转成 Python 对象再处理？得调
.execute().to_dict()，但注意这会绕过Result封装，丢失高亮、评分等元信息
字段类型映射错，搜索就失效
Django 字段（如 TextField）默认映射成 ES 的 text 类型，带分词；但如果你搜的是完整邮箱或时间戳，却没声明 .keyword 子字段，term 查询永远为空。
-
title = fields.TextField(attr='title')→ ES 里是"title": {"type": "text", "fields": {"keyword": {"type": "keyword"}} - 精确匹配用
.filter('term', title__keyword='Django 5')，漏掉__keyword就是全文匹配，结果不可控 -
DateField映射成date类型后，范围查询才支持gte/lte；如果误映射成text，.filter('range', pub_date={'gte': '2023-01-01'})直接静默失败
信号同步延迟和事务边界问题很隐蔽
靠 post_save 信号更新 ES，看似简单，但 Django 的事务提交和信号触发顺序并不严格绑定——尤其在批量操作或使用 bulk_create 时，ES 索引可能滞后于数据库状态。
-
save()成功但 ES 写入失败？默认不抛异常，日志里只有WARNING: Failed to update document，容易被忽略 - 想强一致性？得自己捕获
elasticsearch.exceptions.ConnectionError并重试，或者改用异步任务（如 Celery +on_commit） - 测试环境关掉信号（
ELASTICSEARCH_DSL_AUTOSYNC = False）是好习惯，否则跑 test 会连真实 ES，慢还污染数据
ES 字段类型、查询语法、同步时机这三块，任一出偏差都会让搜索“看起来在跑，结果总不对”。调试时先 curl 看 mapping，再用 Kibana Dev Tools 跑一遍原始 query，比在 Django 里反复改 search() 调用更靠谱。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
