---
title: "Elasticsearch yaml 在 5.5.0 版本中已弃用，必须重命名为 elasticsearch.yml – 如何解决此 Elasticsearch 异常"
date: 2026-02-20
lastmod: 2026-02-20
description: "当使用 Elasticsearch 5.5.0 或更高版本时，如果配置文件仍命名为 elasticsearch.yaml 会出现此错误。该文件在 5.5.0 版本中已更名为 elasticsearch.yml。"
tags: ["配置文件", "版本升级", "弃用警告"]
summary: "版本： 6.8-8.1
 简要来说，当您使用的 Elasticsearch 版本是 5.5.0 或更高版本，但您的配置文件仍命名为 “elasticsearch.yaml” 时，就会出现此错误。在 5.5.0 版本中，该文件已更名为 “elasticsearch.yml”。要解决此问题，您只需将文件从 “elasticsearch.yaml” 重命名为 “elasticsearch.yml” 即可。或者，您可以创建一个新的 “elasticsearch.yml” 文件，并将旧文件的内容复制到其中。完成此操作后，请确保更新脚本或应用程序中对旧文件名的所有引用。
日志上下文 #  日志 “elasticsearch.yaml was deprecated in 5.5.0 and must be renamed to elasticsearch.yml” 的类名是 InternalSettingsPreparer.java。我们从 Elasticsearch 源代码中提取了以下内容，供那些需要深入了解上下文的用户参考：
Settings.Builder output = Settings.builder(); initializeSettings(output, input, properties); Environment environment = new Environment(output.build(), configPath); if (Files.exists(environment.configFile().resolve("elasticsearch.yaml"))) { throw new SettingsException("elasticsearch.yaml was deprecated in 5.5.0 and must be renamed to elasticsearch.yml"); } if (Files."
---



> **版本：** 6.8-8.1

简要来说，当您使用的 Elasticsearch 版本是 5.5.0 或更高版本，但您的配置文件仍命名为 "elasticsearch.yaml" 时，就会出现此错误。在 5.5.0 版本中，该文件已更名为 "elasticsearch.yml"。要解决此问题，您只需将文件从 "elasticsearch.yaml" 重命名为 "elasticsearch.yml" 即可。或者，您可以创建一个新的 "elasticsearch.yml" 文件，并将旧文件的内容复制到其中。完成此操作后，请确保更新脚本或应用程序中对旧文件名的所有引用。

日志上下文
-----------

日志 "elasticsearch.yaml was deprecated in 5.5.0 and must be renamed to elasticsearch.yml" 的类名是 [InternalSettingsPreparer.java](https://www.geeksforgeeks.org/java-lang-class-class-java-set-1/)。我们从 Elasticsearch 源代码中提取了以下内容，供那些需要深入了解上下文的用户参考：

```java
Settings.Builder output = Settings.builder();
 initializeSettings(output, input, properties);
 Environment environment = new Environment(output.build(), configPath);  if (Files.exists(environment.configFile().resolve("elasticsearch.yaml"))) {
 throw new SettingsException("elasticsearch.yaml was deprecated in 5.5.0 and must be renamed to elasticsearch.yml");
 }  if (Files.exists(environment.configFile().resolve("elasticsearch.json"))) {
 throw new SettingsException("elasticsearch.json was deprecated in 5.5.0 and must be converted to elasticsearch.yml");
 }
```