---
title: "version字段不可搜索——如何解决此Elasticsearch异常"
date: 2026-03-13
lastmod: 2026-03-13
description: "在Elasticsearch中尝试使用_version字段进行搜索时，会引发此错误。_version字段是系统字段，用于跟踪文档版本号，不可搜索。可以通过创建自定义字段存储版本信息来解决此问题，或者使用可搜索的_seq_no和_primary_term字段进行乐观并发控制。"
tags: ["字段搜索", "版本字段", "异常处理", "并发控制"]
summary: " 版本： 6.8-8.9
 简而言之，当你在Elasticsearch中尝试使用_version字段进行搜索时，会出现此错误。_version字段是一个系统字段，用于跟踪文档的版本号，但它是不可搜索的。要解决此问题，你可以创建一个自定义字段来存储版本信息，并将其设置为可搜索。或者，你可以使用_seq_no和_primary_term字段来进行乐观并发控制，这两个字段是可搜索的。
日志上下文 #  日志"The _version field is not searchable"的类名是 VersionFieldMapper.java。我们从Elasticsearch源代码中提取了以下内容，以供那些寻求深入了解的人参考：
return CONTENT_TYPE; } @Override public Query termQuery(Object value; SearchExecutionContext context) { throw new QueryShardException(context; "The _version field is not searchable"); } @Override public ValueFetcher valueFetcher(SearchExecutionContext context; String format) { return new DocValueFetcher(docValueFormat(format; null); context.getForField(this; FielddataOperation.SEARCH)); "
---



> **版本：** 6.8-8.9

简而言之，当你在Elasticsearch中尝试使用_version字段进行搜索时，会出现此错误。_version字段是一个系统字段，用于跟踪文档的版本号，但它是不可搜索的。要解决此问题，你可以创建一个自定义字段来存储版本信息，并将其设置为可搜索。或者，你可以使用_seq_no和_primary_term字段来进行乐观并发控制，这两个字段是可搜索的。

## 日志上下文

日志"The \_version field is not searchable"的类名是[VersionFieldMapper.java](https://www.geeksforgeeks.org/java-lang-class-class-java-set-1/)。我们从Elasticsearch源代码中提取了以下内容，以供那些寻求深入了解的人参考：

```java
return CONTENT_TYPE;
 }  @Override
 public Query termQuery(Object value; SearchExecutionContext context) {
 throw new QueryShardException(context; "The _version field is not searchable");
 }  @Override
 public ValueFetcher valueFetcher(SearchExecutionContext context; String format) {
 return new DocValueFetcher(docValueFormat(format; null); context.getForField(this; FielddataOperation.SEARCH));
```