---
title: "清理 S3 仓库时必须指定 Bucket 选项 —— 如何解决此 Elasticsearch 异常"
date: 2026-03-25
lastmod: 2026-03-25
description: "当 Elasticsearch 尝试清理 S3 仓库时，如果没有指定 bucket 选项，就会发生此错误。bucket 选项是识别要清理的特定 S3 存储桶所必需的。"
tags: ["Elasticsearch", "S3仓库", "异常处理", "存储配置"]
summary: "版本： 7.4-7.5
 简而言之，当 Elasticsearch 尝试清理 S3 仓库时，如果没有指定 bucket 选项，就会发生此错误。bucket 选项是识别要清理的特定 S3 存储桶所必需的。要解决此问题，你应该在清理命令中指定 bucket 选项。你可以通过添加 ‘bucket’ 参数，后跟你的 S3 存储桶名称来实现。如果不确定存储桶名称，可以在 AWS S3 控制台中找到它。在 Elasticsearch 中执行操作时，务必确保提供所有必需的参数。
日志上下文 #  日志 “bucket option is required for cleaning up S3 repository” 的类名是 CleanupS3RepositoryCommand.java。我们从 Elasticsearch 源代码中提取了以下内容，供那些需要深入了解上下文的人参考：
throw new ElasticsearchException("you must not specify both region and endpoint"); } String bucket = bucketOption.value(options); if (Strings.isNullOrEmpty(bucket)) { throw new ElasticsearchException("bucket option is required for cleaning up S3 repository"); } String basePath = basePathOption."
---



> **版本：** 7.4-7.5

简而言之，当 Elasticsearch 尝试清理 S3 仓库时，如果没有指定 bucket 选项，就会发生此错误。bucket 选项是识别要清理的特定 S3 存储桶所必需的。要解决此问题，你应该在清理命令中指定 bucket 选项。你可以通过添加 'bucket' 参数，后跟你的 S3 存储桶名称来实现。如果不确定存储桶名称，可以在 AWS S3 控制台中找到它。在 Elasticsearch 中执行操作时，务必确保提供所有必需的参数。

## 日志上下文

日志 "bucket option is required for cleaning up S3 repository" 的类名是 [CleanupS3RepositoryCommand.java](https://www.geeksforgeeks.org/java-lang-class-class-java-set-1/)。我们从 Elasticsearch 源代码中提取了以下内容，供那些需要深入了解上下文的人参考：

```java
throw new ElasticsearchException("you must not specify both region and endpoint");
 }  String bucket = bucketOption.value(options);
 if (Strings.isNullOrEmpty(bucket)) {
 throw new ElasticsearchException("bucket option is required for cleaning up S3 repository");
 }  String basePath = basePathOption.value(options);
 if (basePath.endsWith("/")) {
 throw new ElasticsearchException("there should be not trailing slash in the base path");
```