Elasticsearch 6.2如何配置无匹配搜索结果时返回404而非200？

好问题！Elasticsearch 6.2默认情况下，哪怕搜索没有匹配到任何文档，也会返回200 OK（因为查询本身是成功执行的，只是没有找到匹配的文档）。要实现你要的“无结果时返回404”的需求，原生ES做不到直接返回404，但可以通过以下几种变通方案实现：

方案1：应用层处理（最推荐） #

这是最简单直接的方式，在你的业务代码里处理ES的响应：

• 发送搜索请求后，解析ES返回的JSON响应
• 检查hits.total字段（ES 6.2里这个字段是纯数字）是否等于0
• 如果等于0，就给你的客户端返回404状态码，而不是把ES的200响应直接透传

举个伪代码例子（比如用Python）：

import requests

response = requests.get("http://your-es-node:9200/twitter/_search?q=user:kimchy")
es_data = response.json()

if es_data["hits"]["total"] == 0:
    # 给客户端返回404
    return {"error": "No documents found"}, 404
else:
    # 返回正常的搜索结果
    return es_data, 200

这种方案的好处是不需要修改ES配置，也不需要额外组件，逻辑清晰易维护。

方案2：用反向代理（比如Nginx）拦截修改响应 #

如果你不想改动应用代码，可以用Nginx作为ES的反向代理，在Nginx层判断ES的响应内容，无结果时修改状态码为404返回给客户端。

需要用到Nginx的Lua模块（ngx_http_lua_module）来解析JSON响应，配置示例如下：

location /twitter {
    proxy_pass http://your-es-node:9200/twitter;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;

    # 开启响应拦截
    proxy_intercept_errors on;
    body_filter_by_lua_block {
        # 引入JSON解析库
        local json = require("cjson")
        local body = ngx.arg[1]
        # 尝试解析ES的响应体
        local success, data = pcall(json.decode, body)
        if success and data and data.hits and data.hits.total == 0 then
            # 修改状态码为404
            ngx.status = 404
            # 自定义返回的错误内容
            ngx.arg[1] = json.encode({
                error = "No documents matching the query",
                status = 404
            })
        end
    }
}

配置完成后，当你请求GET /twitter/_search?q=user:kimchy且无结果时，Nginx会返回404状态码和自定义的错误体。

方案3：用ES脚本字段抛出异常（返回500，非404） #

这个方案会让ES在无结果时返回500状态码（不是404），如果你的场景可以接受非200的其他状态码，可以试试：

在搜索请求中加入一个script_fields，用Painless脚本判断总命中数，无结果时抛出异常：

GET /twitter/_search
{
  "query": {
    "match": {
      "user": "kimchy"
    }
  },
  "script_fields": {
    "check_no_hits": {
      "script": {
        "lang": "painless",
        "source": "if (params._hits.total == 0) { throw new IllegalArgumentException('No matching documents found'); } return true;"
      }
    }
  }
}

当无结果时，ES会返回500状态码，响应体里包含你抛出的错误信息。但注意这个方法返回的是500，不是你想要的404，所以仅作为备选方案。

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