当前位置：首页 > news >正文

springcloud-config服务器，同样的配置在linux环境下不生效

news 2025/7/19 7:57:59

原本在windows下能争取的获取远程配置但是部署到linux上死活都没有内容，然后开始了远程调试，这里顺带讲解下获取配置文件如果使用的是Git源，config service是如何响应接口并返回配置信息的。先说问题，我的服务名原本是abc-abc-abc这种，因为configService 在获取配置的时候允许使用 -来指定profiles，导致这种服务名会被认为 abc 是appname abc-abc是profiles。而正确的应该是abc-abc 是appname，abc是profiles。所有后面我把服务名改成了驼峰命名即 abcAbc 这样在获取的时候就可以识别。并且在git仓库中把配置文件的名字写成了abcAbc.properties，而远程仓库名在新建的时候仓库地址会默认给全部转换为小写
在这里插入图片描述
一开始我还没太在意这个事情，我是用的策略是一个微服务一个仓库的方式进行管理

spring.cloud.config.server.git.uri=http://your_git_space/your_org_name/{application}-config.git

但是由于git Url是小写，使用 http://your_git_space/your_org_name/abcAbc-config.git 无法访问到仓库，所以我在config client中配置了name

spring:cloud:config:enabled: truediscovery:enabled: true #是否启动config server服务发现service-id: CONFIG-SERVICE #配置服务名称profile: ${spring.profiles.active}name: abcabc#获取配置是使用的application name，默认是spring.application.namelabel: master

config client 在拉取config的时候会以如下的方式进行访问
http://CONFIG-SERVICE/abcabc/dev/master

tip 对应的格式为 http://CONFIG-SERVICE/{appname}/{profile}/{branch|commit id}

在configService中，对应的JGitEnvironmentRepository会按照 spring.cloud.config.server.git.uri的配置将{xxx}提醒替换即，最终生成的git url为 http://your_git_space/your_org_name/abcabc-config.git 这样可以确保git url是一个正确的git仓库地址。然后神奇的事情来了同样的配置，和git仓库地址。在linux上不行，在windows上可以。

这里有个需要注意的东西，spring.cloud.config.server.git.basedir=file:///E:/config-repo 在windows下需要是 file:/// 在linux下是file:/

其次在linux环境中如果没有使用file:开头，则spring会把本地配置文件的地址修改为 runpath+spring.cloud.config.server.git.basedir 配置的值，比如linux环境下配置
spring.cloud.config.server.git.basedir=~/config-service/config-repo，那么给到spring 配置文件加载的File地址就会变成 /home/user/config-server/~/config-service/config-repo

具体的官方文档描述在这里 file_system_backend

排除上面的注意点之后依然不可以，先来看看具体是怎么获取到配置文件的，访问http://CONFIG-SERVICE/fxdanmugw/dev/master，暴露该端点的是org.springframework.cloud.config.server.environment.EnvironmentController#labelled

	@RequestMapping(path = "/{name}/{profiles}/{label:.*}",produces = MediaType.APPLICATION_JSON_VALUE)public Environment labelled(@PathVariable String name, @PathVariable String profiles,@PathVariable String label) {return getEnvironment(name, profiles, label, false);}

然后通过EnvironmentEncryptorEnvironmentRepository#findOne(java.lang.String, java.lang.String, java.lang.String, boolean)
···>CompositeEnvironmentRepository#findOne(java.lang.String, java.lang.String, java.lang.String, boolean)
···>CompositeEnvironmentRepository#findOne(java.lang.String, java.lang.String, java.lang.String, boolean)
···>MultipleJGitEnvironmentRepository#findOne
···>AbstractScmEnvironmentRepository#findOne(java.lang.String, java.lang.String, java.lang.String, boolean)

该超类的方法是通过 JGitEnvironmentRepository的实例调用的

好的核心逻辑到了我们看下源码

	public synchronized Environment findOne(String application, String profile,String label, boolean includeOrigin) {NativeEnvironmentRepository delegate = new NativeEnvironmentRepository(getEnvironment(), new NativeEnvironmentProperties());Locations locations = getLocations(application, profile, label);delegate.setSearchLocations(locations.getLocations());Environment result = delegate.findOne(application, profile, "", includeOrigin);result.setVersion(locations.getVersion());result.setLabel(label);return this.cleaner.clean(result, getWorkingDirectory().toURI().toString(),getUri());}

大致流程新建了一个NativeEnvironmentRepository 去读取本地文件，getLocations里面会根据application,profile,label 刷新对应的git仓库，保证仓库的version版本和远程git仓库一致，然后启动一个SpringApplication容器使用配置–spring.config.path=file:/xxxx 的形式让这个容器去加载配置文件，在从上下文中取出所有和当前 application,profile,label 符合的配置返回出去，application=abcabc,profile=dev,label=master。有点不可思议完全没想到会使用SpringApplicationBuilder 构建一个容器进行配置读取，这个懒投的可以，当然可能是有其他必要原因导致不得不这么做，下面来看详细部分代码
git 仓库刷新部分之前博客有讲过，简单过一下
JGitEnvironmentRepository#getLocations ···> JGitEnvironmentRepository#refresh

delegate.setSearchLocations(locations.getLocations());locations就是过滤出来的本地仓库地址它的实际值可能是这样的
在这里插入图片描述
application被我马赛克了，理解成abcabc吧，然后依靠NativeEnvironmentRepository#findOne(java.lang.String, java.lang.String, java.lang.String, boolean)来获取Environment，具体代码如下

@Overridepublic Environment findOne(String config, String profile, String label,boolean includeOrigin) {SpringApplicationBuilder builder = new SpringApplicationBuilder(PropertyPlaceholderAutoConfiguration.class);ConfigurableEnvironment environment = getEnvironment(profile);builder.environment(environment);builder.web(WebApplicationType.NONE).bannerMode(Mode.OFF);if (!logger.isDebugEnabled()) {// Make the mini-application startup less verbosebuilder.logStartupInfo(false);}String[] args = getArgs(config, profile, label);// Explicitly set the listeners (to exclude logging listener which would change// log levels in the caller)builder.application().setListeners(Arrays.asList(new ConfigFileApplicationListener()));try (ConfigurableApplicationContext context = builder.run(args)) {environment.getPropertySources().remove("profiles");return clean(new PassthruEnvironmentRepository(environment).findOne(config,profile, label, includeOrigin));}catch (Exception e) {String msg = String.format("Could not construct context for config=%s profile=%s label=%s includeOrigin=%b",config, profile, label, includeOrigin);String completeMessage = NestedExceptionUtils.buildMessage(msg,NestedExceptionUtils.getMostSpecificCause(e));throw new FailedToConstructEnvironmentException(completeMessage, e);}}

主要看args的值，如下

args[]数值
0 = "--spring.config.name=application,abcabc"
1 = "--spring.cloud.bootstrap.enabled=false"
2 = "--encrypt.failOnError=false"
3 = "--spring.config.location=file:/E:/config-repo/config-repo-6098804444752826688/"

注意看这里的–spring.config.name用的是接口请求传进来的appname。在windows和linux中文件系统对文件名的大小写敏感程度不同，举个例子
在这里插入图片描述
在linux是允许大小写不同的文件存在的

罪魁祸首出现了，问题就是出现在这里，windows的文件系统与linux的差异导致了，他们表现上的差异，我的处理方式是，将git url的地址改成和服务一样的驼峰大小写，再删除掉config client中配置的name，或者直接不适用特定的名称来编写配置文件，全部写道application.yml 里面