以下是使用 Spring Boot Admin 通过图形界面查看应用配置信息的完整配置详解,包含代码示例和注释,最后以表格总结关键配置:
1. 环境准备
Spring Boot 版本 :2.7.x(兼容 Spring Boot Admin 2.x)Spring Boot Admin 版本 :2.7.x依赖管理 :Maven 或 Gradle
2. 配置步骤详解
2.1 创建 Spring Boot Admin 服务器
2.1.1 添加依赖(pom.xml
)
< dependency> < groupId> de.codecentric</ groupId> < artifactId> spring-boot-admin-starter-server</ artifactId> < version> 2.7.8</ version>
</ dependency>
< dependency> < groupId> org.springframework.boot</ groupId> < artifactId> spring-boot-starter-actuator</ artifactId>
</ dependency>
2.1.2 启动类配置
package com. example. admin ; import de. codecentric. boot. admin. server. config. EnableAdminServer ;
import org. springframework. boot. SpringApplication ;
import org. springframework. boot. autoconfigure. SpringBootApplication ; @SpringBootApplication
@EnableAdminServer
public class AdminServerApplication { public static void main ( String [ ] args) { SpringApplication . run ( AdminServerApplication . class , args) ; }
}
2.1.3 配置文件(application.yml
)
server : port : 8080 spring : boot : admin : client : url :
2.2 创建客户端应用
2.2.1 添加依赖(pom.xml
)
< dependency> < groupId> de.codecentric</ groupId> < artifactId> spring-boot-admin-starter-client</ artifactId> < version> 2.7.8</ version>
</ dependency>
< dependency> < groupId> org.springframework.boot</ groupId> < artifactId> spring-boot-starter-actuator</ artifactId>
</ dependency>
2.2.2 配置文件(application.yml
)
server : port : 8081 spring : application : name : my- service
spring.boot.admin.client : url : http: //localhost: 8080 instance : description : My Service Instancemanagement-url : http: //localhost: 8081/actuator
management : endpoints : web : exposure : include : "*" endpoint : health : show-details : always
2.2.3 启动类配置
package com. example. client ; import org. springframework. boot. SpringApplication ;
import org. springframework. boot. autoconfigure. SpringBootApplication ; @SpringBootApplication
public class ClientApplication { public static void main ( String [ ] args) { SpringApplication . run ( ClientApplication . class , args) ; }
}
3. 启动与访问
启动 Admin 服务器 : 访问 http://localhost:8080
,看到默认界面。 启动客户端应用 : 查看配置信息 : 在 Admin 界面选择客户端实例 → 点击 “Configuration Properties” → 查看所有配置属性(如 spring
, server
, application
等)。
4. 关键配置说明
4.1 Actuator 端点暴露
4.2 客户端注册到 Admin 服务器
5. 完整代码示例
5.1 Admin 服务器 pom.xml
<?xml version="1.0" encoding="UTF-8"?>
< project> < dependencies> < dependency> < groupId> de.codecentric</ groupId> < artifactId> spring-boot-admin-starter-server</ artifactId> < version> 2.7.8</ version> </ dependency> < dependency> < groupId> org.springframework.boot</ groupId> < artifactId> spring-boot-starter-actuator</ artifactId> </ dependency> </ dependencies>
</ project>
5.2 客户端 application.yml
spring : boot : admin : client : url : http: //localhost: 8080 instance : management-url : http: //localhost: 8081/actuator
management : endpoints : web : exposure : include : "*"
6. 功能对比表格
配置项 作用 示例值 适用场景 spring.boot.admin.client.url
指定 Admin 服务器地址 http://localhost:8080
必须配置 management.endpoints.web.exposure.include
暴露 Actuator 端点(如 configprops
) "configprops,health"
查看配置信息必需 spring.application.name
客户端应用名称(在 Admin 界面显示) my-service
标识应用 management.endpoint.health.show-details
控制健康检查详情是否显示 always
调试时需要详细信息 spring.boot.admin.client.instance.management-url
客户端 Actuator 端点地址(用于 Admin 服务器访问) http://localhost:8081/actuator
必须配置
7. 总结建议
场景 配置关键点 注意事项 基础配置 客户端注册到 Admin 服务器,暴露 configprops
端点 确保网络连通性,端口开放 安全环境 配置用户名密码认证(spring.boot.admin.client.username/password
) 结合 Spring Security 加密传输 多环境部署 动态配置 spring.boot.admin.client.url
(如通过配置中心) 使用环境变量或外部配置文件
8. 常见问题
问题 解决方案 客户端未注册到 Admin 检查 spring.boot.admin.client.url
是否正确,防火墙是否放行端口 配置信息未显示 确保 management.endpoints.web.exposure.include=configprops
已配置 安全认证失败 在 Admin 服务器配置 security
权限,并在客户端传递凭证
如需进一步优化或解决特定问题(如自定义配置过滤、集成 Spring Cloud),可提供具体需求!