Spring Boot Admin客户端报“couldn't determine local port”错误咨询

问题背景 #

已为微服务配置Spring Boot Admin客户端，相关配置如下：

pom.xml依赖

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-actuator</artifactId>
</dependency>     
<dependency>
    <groupId>de.codecentric</groupId>
    <artifactId>spring-boot-admin-starter-client</artifactId>          
</dependency>

application.properties配置

# Application
spring.application.name=My Sample Service

# Spring boot admin server 
spring.boot.admin.client.url=http://localhost:9091
spring.boot.admin.client.enabled=true
spring.boot.admin.client.auto-registration=true
spring.boot.admin.client.username=admin
spring.boot.admin.client.password=password

spring.security.user.name=admin
spring.security.user.password=password
spring.boot.admin.client.instance.metadata.user.name=${spring.security.user.name}
spring.boot.admin.client.instance.metadata.user.password=${spring.security.user.password}

# Actuator endpoints properties
management.endpoints.web.exposure.include=*
management.endpoint.health.show-details=always

# To monitor log file on admin server
logging.file.name=my_ssample_service.log
logging.logback.rollingpolicy.max-history=5
logging.logback.rollingpolicy.max-file-size=10MB

application.yml端口配置

server:
  port : 9020

执行mvn install构建成功，但抛出以下错误：

java.lang.IllegalStateException: couldn't determine local port. Please set spring.boot.admin.client.instance.service-base-url.
    at de.codecentric.boot.admin.client.registration.DefaultApplicationFactory.getLocalServerPort(DefaultApplicationFactory.java:192) ~[spring-boot-admin-client-2.7.4.jar:2.7.4]
    at de.codecentric.boot.admin.client.registration.DefaultApplicationFactory.getServiceBaseUrl(DefaultApplicationFactory.java:104) ~[spring-boot-admin-client-2.7.4.jar:2.7.4]
    at de.codecentric.boot.admin.client.registration.ServletApplicationFactory.getServiceUrl(ServletApplicationFactory.java:63) ~[spring-boot-admin-client-2.7.4.jar:2.7.4]
    at de.codecentric.boot.admin.client.registration.ServletApplicationFactory.getManagementBaseUrl(ServletApplicationFactory.java:76) ~[spring-boot-admin-client-2.7.4.jar:2.7.4]
    at de.codecentric.boot.admin.client.registration.DefaultApplicationFactory.getHealthUrl(DefaultApplicationFactory.java:154) ~[spring-boot-admin-client-2.7.4.jar:2.7.4]
    at de.codecentric.boot.admin.client.registration.DefaultApplicationFactory.createApplication(DefaultApplicationFactory.java:80) ~[spring-boot-admin-client-2.7.4.jar:2.7.4]
    at de.codecentric.boot.admin.client.registration.DefaultApplicationRegistrator.register(DefaultApplicationRegistrator.java:56) ~[spring-boot-admin-client-2.7.4.jar:2.7.4]
    at org.springframework.scheduling.support.DelegatingErrorHandlingRunnable.run(DelegatingErrorHandlingRunnable.java:54) ~[spring-context-5.3.22.jar:5.3.22]

尽管Admin服务器能正常显示所有客户端的详细信息，但该错误始终存在。

解决方案 #

1. 显式指定服务基础URL

直接在application.properties中配置spring.boot.admin.client.instance.service-base-url，跳过端口自动检测逻辑：

spring.boot.admin.client.instance.service-base-url=http://localhost:9020

这个配置会告诉SBA客户端明确的服务访问地址，无需自动推断端口，从根源上解决错误。

2. 构建阶段禁用SBA客户端

如果只需要在运行时启用SBA客户端，可以在构建/测试阶段临时禁用，比如添加application-test.properties配置：

spring.boot.admin.client.enabled=false

或者在pom.xml中为测试阶段指定激活的配置文件，避免构建过程中触发客户端注册逻辑。

3. 统一端口配置位置

将server.port从application.yml移到application.properties中，确保配置加载顺序一致：

server.port=9020

虽然Spring Boot会合并不同格式的配置文件，但统一配置位置可以避免潜在的加载优先级问题，帮助客户端正确读取端口值。

内容的提问来源于stack exchange，提问作者user2304483