如何使用Python Flask集成Elasticsearch实现全文检索?

阿磊小哥_4934

阿磊小哥_4934

2026-08-07

174人浏览

原创

flask 连接 elasticsearch 8.x 需用 elasticsearch() 实例,开发时设 verify_certs=false 并配置用户名密码;建索引时指定 ik_max_word 分词器支持中文搜索;路由中调用 es.search() 并安全提取 hits 数据返回,分页避免 from + size > 10000。

如何使用python flask集成elasticsearch实现全文检索?

Flask里怎么连Elasticsearch?别用elasticsearch官方库的旧版API

直接用 elasticsearch 8.x 官方客户端,但必须避开已弃用的 ES().search() 这类低级调用。新版强制走 Elasticsearch() 实例 + search() 方法,且默认要求 HTTPS 和认证。本地开发时最常踩的坑是:启动 ES 用 docker run -p 9200:9200 -e "discovery.type=single-node" docker.elastic.co/elasticsearch/elasticsearch:8.12.2,但忘了关 TLS 验证——结果 Flask 报 SSLError 或 ConnectionError。

  • 初始化客户端必须显式传 verify_certs=False(仅限开发环境)
  • 用户名密码默认是 elastic / 自动生成的密码,查 docker logs 输出里的 password for the elastic user is 行
  • 推荐封装成 Flask 的 app.config 变量或应用工厂里的全局实例,避免每次请求都新建连接

怎么写一个能搜中文的搜索路由?关键在 analyzer 和 mapping

ES 默认不支持中文分词,直接 index 字段后搜“人工智能”会匹配不到“AI”。必须提前建索引并指定 ik_max_word 或 jieba 分词器——但 Flask 路由本身不负责建索引,得在应用启动时一次性执行。

  • 先用 curl -X PUT "http://localhost:9200/my_index" -H "Content-Type: application/json" -d'{"mappings":{"properties":{"title":{"type":"text","analyzer":"ik_max_word"},"content":{"type":"text","analyzer":"ik_max_word"}}}}' 手动建好
  • Flask 路由里调 es.search(index="my_index", query={"match": {"title": request.args.get("q")}}) 即可
  • 如果没装 IK 插件,ES 启动会报 failed to load analyzer [ik_max_word],得进容器执行 ./bin/elasticsearch-plugin install https://github.com/medcl/elasticsearch-analysis-ik/releases/download/v8.12.2/elasticsearch-analysis-ik-8.12.2.zip

搜索结果怎么安全返回给前端?别直接 jsonify es.search() 返回值

es.search() 返回的是带 _shards、_scroll_id 等内部字段的嵌套结构,直接 jsonify(res) 会让前端拿到一堆无用数据,还可能泄露集群信息。

python-script-generator
python-script-generator

快速生成专业的 Python 脚本和应用代码。一键创建完整项目结构,支持CLI、API、爬虫、Bot、Django等多种项目类型,包含完整的项目结构、配置文件、依赖管理、测试、README和文档。

下载
  • 只取 res["hits"]["hits"],再用列表推导提取 {"id": h["_id"], "score": h["_score"], "source": h["_source"]}
  • 注意 _source 默认返回全部字段,如果文档很大,应提前在查询时加 _source=["title", "summary"] 参数控制返回字段
  • 分数 _score 是浮点数,JSON 序列化没问题,但别把它当绝对相关度——不同查询间不可比,只用于同一次查询内的排序

分页怎么做?from + size 别超过 10000

ES 默认限制 from + size ,否则报 <code>query_phase_execution_exception。用 request.args.get("page", 1, type=int) 算 from 值时,很容易超限。

  • 简单方案:设硬上限,page = min(page, 500),对应 from=4990
  • 真要深分页,必须换 search_after——它依赖上一页最后一条的 sort 值,不能跳页,但能撑到百万级
  • 别信网上抄的“用 scroll API 做分页”,那是为批量导出设计的,时效性差,且不适用于用户实时搜索

ES 的 mapping 设计、分词器安装、连接配置这三块最容易卡住人,尤其在 Docker 环境下,错误日志分散在 Flask 日志和 ES 容器日志里,得两边一起看。

Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!

相关专题

更多
python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

2023.07.20

1651

4

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

2023.07.25

4124

7

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.31

1669

3

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

2023.08.03

23857

23

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

2927

5

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

2947

5

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

1143

5

python合并两个列表
python合并两个列表

Python是一种强大的编程语言,具有许多方便的功能和工具。在Python中,有多种方法可以合并两个列表。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.10

596

4

python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

2283

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程