query_string 是什么
query_string 是 Elasticsearch 里最接近搜索引擎语法的查询：一个字符串里就能写 field:value、AND / OR / NOT、通配符、模糊匹配等完整表达式，语法写错会直接返回 400。simple_query_string 是它的宽松版本，遇到无法解析的语法符号只忽略不报错，更适合直接接受用户输入。
基本信息
| query_string | 支持 field:value、AND/OR/NOT、通配、模糊等，不要直接暴露给终端用户 |
|---|---|
| simple_query_string | + 表示必须、| 表示或、- 表示排除、双引号表示短语，容错性好 |
| 常用参数 | default_field、fields、default_operator（默认 OR）、analyze_wildcard |
| 错误行为 | query_string 语法错误直接 400，simple_query_string 静默忽略非法部分 |
| 适用版本 | Elasticsearch 7.x / 8.x 语法一致 |
典型使用场景
- 运维检索：一次输入多个字段条件，省去逐条拼 bool 查询
- 搜索框输入：用户输入自然语言关键词时用 simple_query_string 更安全
- 批量排查：用一个表达式组合状态、时间与关键字
- 旧系统迁移：把 lucene 语法风格的查询条件平移过来
- 控制台试查询：先快速验证条件写法，再翻译成结构化 DSL
常用写法
常用写法
# query_string：完整语法，支持字段前缀与布尔运算符
GET /my-index/_search
{ "query": { "query_string": {
"query": "title:elastic AND (status:open OR status:pending)",
"default_field": "content" } } }
# simple_query_string：面向用户输入的宽松写法
GET /my-index/_search
{ "query": { "simple_query_string": {
"query": "elastic +tutorial -outdated",
"fields": ["title", "body"],
"default_operator": "and" } } }
# 字段权重与短语：title^2 提高标题权重，双引号表示短语
GET /my-index/_search
{ "query": { "simple_query_string": {
"query": "\"exact phrase\" +tutorial",
"fields": ["title^2", "body"] } } }两种查询对照
| 对比项 | query_string | simple_query_string |
|---|---|---|
| 语法能力 | 完整，含通配、模糊、正则 | 仅简化符号，能力有限 |
| 非法语法 | 直接返回 400 | 忽略无法解析的部分继续查询 |
| 面向用户 | 不建议直接暴露 | 适合接搜索框输入 |
| 默认运算符 | OR | OR，可用 default_operator 调整 |
| 字段选择 | default_field 或在 query 内指定 | fields 数组，支持 ^N 权重 |
query_string 可以触发昂贵查询，例如前导通配、超大布尔表达式与正则；不要把它直接拼进对外的搜索接口。需要接受用户输入时优先用 simple_query_string 或结构化的 match 查询。
两种查询都会对输入做分词与重写，analyze_wildcard 控制通配符是否参与分词，默认关闭；前缀通配配合该参数才能在分词后的词条上生效，调试时可以先用 _analyze 接口确认词条切分结果。