Spring Cloud Config配置报错：无法解析'message'占位符

我来帮你一步步排查这个问题，这个报错本质是客户端没能从Config Server获取到message配置项，咱们从几个核心环节入手：

1. 检查Git配置仓库的内容 #

首先确认你的MySpringCloudConfigContentRepository仓库里的配置文件是否符合规则：

• 文件名要和客户端的spring.application.name对应。比如客户端应用名叫my-service，那仓库里需要有my-service.properties（或my-service.yml），而且文件里必须包含message=你要的内容这样的配置项。
• 如果客户端指定了profile（比如dev），那需要对应my-service-dev.properties这样的文件，或者在主配置文件里用spring.profiles.active指定生效的配置段。

2. 验证客户端的配置加载顺序与内容 #

这是最容易踩坑的点：

• 优先使用bootstrap.properties/bootstrap.yml：在Spring Cloud中，客户端需要先加载Config Server的配置，所以相关配置要放在bootstrap开头的文件里，而不是application开头的文件。示例配置：

  spring.application.name=my-service # 必须和仓库里的配置文件名匹配
  spring.cloud.config.uri=http://localhost:8888 # 指向你的Config Server地址
  

• 如果是Spring Boot 2.4+版本：默认关闭了bootstrap上下文，你需要二选一：
  • 在application.properties中添加spring.config.import=configserver:http://localhost:8888
  • 引入bootstrap依赖，重新启用该机制：

    <dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-starter-bootstrap</artifactId>
    </dependency>
    

3. 检查Config Server的运行状态 #

启动Config Server后，查看控制台日志：

• 确认有没有成功克隆Git仓库的日志（比如Cloning into '/tmp/config-repo-xxx'），如果有Git访问失败、权限错误等日志，先解决仓库拉取问题。
• 查看是否有Located environment: name=my-service, profiles=[default], label=null这类日志，说明Server已经正确识别到对应客户端的配置环境。

4. 直接测试Config Server的端点 #

用浏览器或curl访问http://localhost:8888/[你的应用名]/[profile]（比如http://localhost:8888/my-service/default），查看返回的JSON数据：

• 如果返回的propertySources里没有message字段，说明仓库配置有误；
• 如果有message字段，说明Server没问题，问题出在客户端的配置加载上。

常见额外排查点 #

• 确认客户端和Server的Spring Cloud版本是否兼容，版本不匹配可能导致配置拉取失败；
• 如果Git仓库是私有仓库，需要在Config Server的application.properties中添加用户名密码配置：

  spring.cloud.config.server.git.username=你的用户名
  spring.cloud.config.server.git.password=你的密码/令牌
  

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