Spring Cloud客户端配置server.port=8080仍占用8888端口启动失败

问题原因 #

该问题是Spring Cloud Config配置优先级冲突导致的，Spring Cloud加载配置的优先级从高到低为：启动参数 > 远程配置中心配置 > 本地application.properties/yml配置 > 本地bootstrap.properties/yml配置，你本地配置的端口未生效大概率是被更高优先级的配置覆盖了。

解决方案 #

按优先级依次排查即可：

• 第一步：检查配置中心关联的Git仓库中，account-service-dev.properties（对应你拉取的服务名+环境的配置文件）内是否配置了server.port=8888，如果有直接修改为8080即可。
• 第二步：如果需要本地端口配置优先于远程配置，任选以下一种方式操作：
  1. 将客户端的server.port=8080配置从application.properties移动到bootstrap.properties文件中，bootstrap上下文的配置优先级高于远程拉取的配置
  2. 在客户端的bootstrap.properties中添加配置spring.cloud.config.override-none=true，开启后本地配置会覆盖远程的同属性配置
• 第三步：检查客户端启动命令是否携带了--server.port=8888之类的端口参数，启动参数的优先级最高，会覆盖所有配置文件的端口设置
• 第四步：排查客户端代码中是否有硬编码端口的配置，或者引入的第三方依赖是否有强制配置端口的逻辑

客户端bootstrap.properties参考配置 #

spring.application.name=account-service
spring.cloud.config.uri=http://localhost:8888
spring.profiles.active=dev
server.port=8080

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