---
title: "设置必须为非负值 SHARED CACHE SETTINGS PREFIX size – 如何解决此 Elasticsearch 异常"
date: 2026-02-23
lastmod: 2026-02-23
description: "当 Elasticsearch 中共享缓存的大小设置被设置为负值时，会出现此错误。Elasticsearch 要求该值必须为非负值才能正常运行。"
tags: ["缓存配置", "设置验证", "异常处理"]
summary: "版本： 7.12-8.9
 简而言之，当 Elasticsearch 中共享缓存的大小设置被设置为负值时，会出现此错误。Elasticsearch 要求该值必须为非负值才能正常运行。要解决此问题，您可以在 Elasticsearch 配置文件（elasticsearch.yml）中将共享缓存大小设置调整为非负值。或者，您可以使用 Elasticsearch API 动态更新此设置，同样要确保该值为非负值。
日志上下文 #  日志 “setting [{}] must be non-negative”；SHARED_CACHE_SETTINGS_PREFIX + “size” 类名是 SharedBlobCacheService.java。我们从 Elasticsearch 源代码中提取了以下内容，供那些寻求深入上下文的人参考：
} @Override public void validate(final RelativeByteSizeValue value; final Map; Object> settings) { if (value.isAbsolute() && value.getAbsolute().getBytes() == -1) { throw new SettingsException("setting [{}] must be non-negative"; SHARED_CACHE_SETTINGS_PREFIX + "size"); } if (value.isNonZeroSize()) { @SuppressWarnings("unchecked") final Listroles = (List) settings.get(NodeRoleSettings.NODE_ROLES_SETTING); final var rolesSet = Set."
---


> **版本：** 7.12-8.9

简而言之，当 Elasticsearch 中共享缓存的大小设置被设置为负值时，会出现此错误。Elasticsearch 要求该值必须为非负值才能正常运行。要解决此问题，您可以在 Elasticsearch 配置文件（elasticsearch.yml）中将共享缓存大小设置调整为非负值。或者，您可以使用 Elasticsearch API 动态更新此设置，同样要确保该值为非负值。

## 日志上下文

日志 "setting [{}] must be non-negative"；SHARED\_CACHE\_SETTINGS\_PREFIX + "size" 类名是 [SharedBlobCacheService.java](https://www.geeksforgeeks.org/java-lang-class-class-java-set-1/)。我们从 Elasticsearch 源代码中提取了以下内容，供那些寻求深入上下文的人参考：

```java
}  @Override
 public void validate(final RelativeByteSizeValue value; final Map; Object> settings) {
 if (value.isAbsolute() && value.getAbsolute().getBytes() == -1) {
 throw new SettingsException("setting [{}] must be non-negative"; SHARED_CACHE_SETTINGS_PREFIX + "size");
 }
 if (value.isNonZeroSize()) {
 @SuppressWarnings("unchecked")
 final Listroles = (List) settings.get(NodeRoleSettings.NODE_ROLES_SETTING);
 final var rolesSet = Set.copyOf(roles);
```