修复 Spring Boot 3.3.4 的 MongoDB Healthcheck 失败：“No Such Command: 'Hello'”错误

在 Spring Boot Actuator 中处理 MongoDB Healthcheck 失败

以下脚本演示了修改 Spring Boot 中的运行状况检查配置以处理 MongoDB 的“hello”命令问题的后端解决方案。它使用 Java 和 Spring Boot，并包含错误处理以优雅地处理丢失的命令。

// Backend approach using Java and Spring Boot to modify the health check
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.boot.actuate.health.MongoHealthIndicator;
import org.springframework.boot.actuate.health.HealthIndicator;
import com.mongodb.MongoClient;
@Configuration
public class MongoHealthCheckConfig {
    @Bean
    public HealthIndicator mongoHealthIndicator(MongoClient mongoClient) {
        return new MongoHealthIndicator(mongoClient);
    }
}
// The MongoClient bean is injected to use a custom health check implementation.
// The 'hello' command error can now be handled with newer MongoDB versions.

替代方法：使用嵌入式 MongoDB 更新

该脚本更新项目 POM 文件中嵌入的 MongoDB 版本，以确保与“hello”命令的兼容性，从而确保运行状况检查按预期工作。

// Modify the POM file to update the embedded MongoDB version
<dependency>
  <groupId>de.bwaldvogel</groupId>
  <artifactId>mongo-java-server</artifactId>
  <version>1.47.0</version> < !-- Upgrade to newer version -->
  <scope>test</scope>
</dependency>
// This ensures MongoDB supports the 'hello' command, used in the Spring Boot health checks.
// Version 1.47.0 is compatible with MongoDB 5.0+ commands.

使用单元测试来验证健康检查功能

以下脚本是一个单元测试，用于确保 MongoDB 健康检查在 Spring Boot 应用程序中正常工作。它验证 MongoDB 状态是否为“UP”并优雅地处理错误。

// JUnit test for MongoDB health check in Spring Boot
import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.test.web.servlet.MockMvc;
@SpringBootTest
public class MongoHealthCheckTest {
    @Autowired
    private MockMvc mockMvc;
    @Test
    public void shouldReturnUpStatus() throws Exception {
        mockMvc.perform(get("/actuator/health"))
               .andExpect(status().isOk())
               .andDo(result -> {
                   String response = result.getResponse().getContentAsString();
                   assertTrue(response.contains("UP"));
               });
    }
}
// This test checks if MongoDB health status is correctly reported as 'UP' in Spring Boot.

有关 Spring Boot 中 MongoDB 健康检查的常见问题

1. 如何解决 MongoDB 中的“no such command: 'hello'”错误？
2. 要解决此问题，您可以将 MongoDB 升级到版本 5.0 或更高版本，或者自定义 MongoHealthIndicator 避免使用“hello”命令。
3. Spring Boot中@Bean注解的用途是什么？
4. 这 @Bean 注解用于定义将生成 Spring 管理的 bean 的方法。在健康检查的背景下，它可用于创建自定义 HealthIndicator 对于 MongoDB。
5. 为什么 Spring Boot Actuator 在使用较旧的 MongoDB 版本时会失败？
6. 低于 5.0 的旧版 MongoDB 无法识别 Actuator 的 MongoDB 运行状况检查中现在使用的“hello”命令。这会导致健康检查失败。
7. 如何测试MongoDB健康检查功能？
8. 使用 MockMvc 在 JUnit 测试中允许您模拟对 /actuator/health 端点并验证状态是否为“UP”。
9. 我可以修改 MongoDB 的 Spring Boot 健康检查吗？
10. 是的，通过创建自定义 MongoHealthIndicator，您可以调整运行状况检查与 MongoDB 交互的方式，以避免不支持的命令。

解决 MongoDB 运行状况检查错误

升级到 Spring Boot 3.3.4 后，由于 MongoDB 5.0 中引入了“hello”命令，MongoDB 健康检查可能会失败。一种解决方案是升级到 MongoDB 的兼容版本，确保健康检查正确执行，而不会遇到不支持的命令。该解决方案很简单，但可能需要进行重大更改。

或者，开发人员可以修改 Spring Boot 健康检查配置来处理较旧的 MongoDB 版本。通过自定义健康检查逻辑，系统可以避免使用不支持的“hello”命令，确保即使使用较旧的 MongoDB 版本，健康状态也返回为“UP”。这两种方法都可以根据您的环境提供灵活性。