es查询含#、+、@的字符串返回空，因standard分词器丢弃这些符号；应优先用.keyword子字段配合term查询实现精确匹配，或自定义分析器保留符号用于全文检索。

ES 查询含 #、+、@ 的字符串为什么返回空？

因为 Elasticsearch 默认用 standard 分词器，会直接丢弃 #、+、@ 等符号——它们被当成分隔符处理，不是保留为 token。比如存入 "Java#Spring"，实际只索引了 ["java", "spring"]，搜 "Java#Spring" 自然查不到。

优先用 .keyword 子字段做精确匹配

这是最轻量、最安全的方案，不需要改 mapping 或重建索引：

• 确保字段 mapping 中已启用 keyword 子字段（Laravel Scout 默认开启，原生客户端需显式定义）
• 查询时别写 name，改用 name.keyword
• 用 term（非 match）：它不走分词，原样比对

示例 DSL：

{
  "query": {
    "term": {
      "name.keyword": "55555@#!sina.com"
    }
  }
}

注意：term 区分大小写，且必须全值匹配；若需模糊前缀（如查所有 @xxx.com），改用 prefix 查询 name.keyword 字段。

Laravel Creem Agent

Creem 支付商店助理 — 查询订阅、客户、交易、产品，执行心跳检查，管理本地 Laravel支付商店。

下载

要用全文检索且必须保留特殊符号？自定义分析器是唯一出路

当业务要求支持 "Java#" 这类带符号的关键词搜索（而非整串精确匹配），就得干预分词流程：

• 定义 char_filter 映射，把 @ → .xxxAt.，# → .xxxJin.（前缀防冲突，点号便于分词）
• 绑定该 filter 到自定义 analyzer，并在 mapping 中指定该 analyzer 用于字段
• 插入和查询都走同一套 analyzer，才能保证 token 对齐
• 务必用 _analyze API 验证分词结果，避免 mapping 写错却没感知

坑点：mapping 更新后，旧数据不会自动重索引，必须手动 reindex 或写入新文档才生效。

Laravel 客户端里拼 DSL 要防注入，别直接插用户输入

即使用了 .keyword，也不能把用户原始输入直接塞进 query body：

• 用户传 "foo*bar"，若未过滤，可能触发 regexp 或 wildcard 查询，引发性能雪崩或误匹配
• 白名单校验字段名（如只允许 title.keyword、sku.keyword）
• 对值做 mb_substr($input, 0, 100) 截断，防止超长字符串拖垮集群
• 禁用 script、regexp、template 等高危 query 类型，除非明确需要且已隔离权限

真正容易被忽略的是：.keyword 查询看似简单，但字段若没设成 "type": "keyword"（比如误配成 text），或者 mapping 没刷新，就会静默退化成空结果——查 GET /your_index/_mapping 确认类型，别只信代码逻辑。