Spring Boot Admin 与 management.endpoints.web.base-path：避免歧义，加强健康检查

Spring Boot Admin 与管理端点路径
Spring Boot Admin 是一个用于监控和管理 Spring Boot 微服务的工具，它提供了一个集中式仪表盘，便于用户查看微服务的运行状态、健康状况、日志信息等。而 Actuator 是 Spring Boot 中内置的一套端点，用于暴露服务的运行时信息，便于监控和管理。

在默认情况下，Actuator 端点暴露在 /actuator 路径下。但是，有些场景下，用户可能需要修改端点路径，比如：

• 为了避免与其他应用或服务冲突，需要使用自定义端点路径。
• 为了增强安全性，需要将端点路径隐藏在非默认位置。

修改端点路径带来的挑战

当某个服务修改了 Actuator 端点路径后，如果 Spring Boot Admin Server 仍然使用默认的 /actuator 路径来检查该服务的健康状态，则可能会导致检查失败。这是因为 SBA Server 无法找到预期的端点，从而认为该服务不可用。

例如，假设某个服务将端点路径修改为 /api/actuator，那么 SBA Server 在检查该服务健康状态时仍然使用默认的 /actuator 路径，这会导致检查失败。

解决方法

为了避免歧义，确保 SBA Server 能够正确检查服务的健康状态，需要采取以下解决方法：

• 在 SBA Server 中配置正确的端点路径。 在 SBA Server 的配置文件中，需要将 management.endpoints.web.base-path 属性设置为与服务端点路径一致的值。这样，SBA Server 就会使用正确的路径来检查服务健康状态。

• 在服务中使用 Actuator 代理。 Actuator 代理是一个轻量级的 Java 库，可以将 Actuator 端点代理到另一个路径。通过使用 Actuator 代理，可以将服务端点路径暴露在自定义路径下，同时仍然保持与 SBA Server 的兼容性。

• 使用 Spring Boot Admin 的端点发现功能。 Spring Boot Admin 提供了一个端点发现功能，可以自动发现和注册具有相同管理端口的微服务。通过使用端点发现功能，SBA Server 可以自动发现并注册服务，无需手动配置端点路径。

结语

Spring Boot Admin 与 management.endpoints.web.base-path 属性的歧义可能会导致服务健康检查失败。为了避免歧义，确保 SBA Server 能够正确检查服务的健康状态，需要在 SBA Server 中配置正确的端点路径，在服务中使用 Actuator 代理，或使用 Spring Boot Admin 的端点发现功能。

通过采取这些措施，可以确保服务治理和健康检查的可靠性，并避免由于端点路径不一致而导致的故障。