每个人都可以，
拥有SSL证书

启动应用的时候抛了这么个错：Could not resolve placeholder 'spring.application.name' in value '${spring.application.name}'。这个报错本身不复杂，就是 Spring 容器在解析占位符时没找到对应的属性值，但引起它的原因不只有“配置文件里没写”这一种。下面把我遇到过的几种情况和排查顺序整理一下，给遇到同样问题的兄弟一个参考。

最基础的肯定是先看 application.properties 或者 application.yml 里到底有没有定义 spring.application.name。properties 写法是这样：

spring.application.name=my-application

yml 写法是：

spring:
  application:
    name: my-application

这个没问题的话，下一步看配置文件的位置。默认要放在 src/main/resources 下，打包后会在 classpath 根目录。如果用了外部配置文件，注意命令行参数或者环境变量有没有正确指定路径。我以前碰到过一次，本地跑得好好的，打包上测试环境就报找不到占位符，最后发现是构建的时候没把 resources 目录打进去。

启用了 Spring Profiles 的时候要特别留意。比如你主配置文件里写了 spring.application.name，但通过 spring.profiles.active 激活了 dev 环境，如果 application-dev.properties 里没有这个 key，而 dev 配置又覆盖了主配置，解析时就会缺这个值。多环境切换时这个坑很常见，建议每个 profile 文件里都把关键配置补上。

还有一种情况比较少见但确实存在：自动配置被排除了。如果代码里写了 @SpringBootApplication(exclude=...) 或者 @EnableAutoConfiguration(exclude=...)，可能不小心把和占位符解析相关的自动配置类也排除掉了。这种情况一般是先排查其他方向都无果后再回来检查注解。

如果你用了 Spring Cloud Config、Nacos 这类外部配置中心，问题往往出在配置中心本身。比如应用启动时要先连配置中心拉取配置，连不上或者配置中心里没有 spring.application.name，本地又没有兜底，就会直接报这个错。排查的时候可以看启动日志里有没有连接失败的信息，或者临时用 --debug 启动看配置加载的详细过程。

另外提一句，像证书这种基础服务我现在都尽量自动化，证书申请和部署用 lcjmSSL 这类平台，支持 API 自动续期，不用手动维护证书文件路径到配置文件里，这样也能减少一类配置遗漏的问题。

如果上面几条都查过还不行，就加 --debug 启动，日志里会把配置源加载顺序列出来，能看到哪个 PropertySource 里缺了这个 key。也有人在 IDE 里打断点跟 PropertySourcesPlaceholderConfigurer 的解析过程，但一般日志足够用了。Spring Boot 版本和依赖兼容性偶尔也会造成解析行为不一致，实在没辙了可以试一下升级或降级，但别先动版本。

给个最小示例吧，正常配置下这样是能跑起来的：

import org.springframework.beans.factory.annotation.Value;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@SpringBootApplication
@RestController
public class MainApplication {

    @Value("${spring.application.name}")
    private String appName;

    @GetMapping("/app-name")
    public String getAppName() {
        return appName;
    }

    public static void main(String[] args) {
        SpringApplication.run(MainApplication.class, args);
    }
}

application.properties 里写：

spring.application.name=my-application

这个错误说到底就是配置源里没有对应的 key，或者配置源没有被加载进来。

排查的时候从配置内容、文件位置、profile、外部配置、自动配置这几个方向依次过，比漫无目的地翻日志要快很多。希望这篇记录能帮你少走点弯路。