以下是使用 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 Instance
management-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),可提供具体需求!