spring-data-elasticsearch配置refreshInterval为-1不生效问题咨询

核心结论 #

仅设置@Document注解中的refreshInterval = "-1"完全不足以禁用Elasticsearch客户端主动发起的refresh调用。

具体原因 #

• @Document注解的refreshInterval参数仅作用于索引创建阶段的服务端配置：该参数会在客户端触发索引创建时，作为索引settings的refresh_interval字段提交给ES，设置为-1仅代表关闭ES服务端的后台自动刷新逻辑，和客户端是否主动发refresh请求没有任何关联。
• Spring Data Elasticsearch的ElasticsearchRepository内置的写入类方法（save/saveAll/deleteById等）默认会根据全局刷新策略决定是否主动携带refresh参数，默认策略并非不触发refresh，这就是你仍能看到带refresh的POST请求的核心原因。

修复方案 #

要彻底禁用客户端主动发起的refresh请求，需要补充以下配置：

1. 全局配置Repository刷新策略
   在项目配置文件中添加如下配置，将Repository默认的刷新策略设置为不主动刷新：

# application.yml 配置示例
spring:
  data:
    elasticsearch:
      repositories:
        refresh-policy: NONE

# application.properties 配置示例
spring.data.elasticsearch.repositories.refresh-policy=NONE

该配置适用于Spring Data Elasticsearch 3.2及以上版本。
2. 排查自定义操作的刷新逻辑

• 如果你使用ElasticsearchOperations、ElasticsearchRestTemplate或者原生ES客户端自定义了写入逻辑，需要确认所有写入方法没有显式设置refresh参数为true，也没有指定RefreshPolicy为IMMEDIATE、WAIT_UNTIL这类会触发主动刷新的枚举值。
• 排查项目中是否存在手动调用索引刷新API的代码（例如elasticsearchClient.indices().refresh()这类调用），如有需要删除对应逻辑。

补充提示 #

如果你的ES账号被完全禁止所有POST请求，需要先确认业务是否仅为查询场景：如果存在数据写入需求，ES本身的写入操作就是POST/PUT类型，需要联系管理员调整权限策略。

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