SpringBoot注入自定义配置属性列表报错：无法解析占位符

嘿，我帮你梳理下你遇到的这个配置注入问题——你用@ConfigurationProperties或者@Value注入custom.resource时，Spring提示找不到这个占位符，大概率是配置类的注解配置不全、配置加载顺序不对，或者注解使用方式有问题，咱们一步步排查解决：

一、先确认基础配置没问题 #

首先得确保你的application.properties里确实存在这个配置项，格式别写错：

custom.resource=你的资源路径/目标值

注意别拼错单词（Spring Boot默认配置大小写不敏感，但尽量保持一致避免踩坑），也别加多余的空格。

二、修复@ConfigurationProperties的正确用法 #

从你给出的代码片段来看，你的配置类大概率缺了关键注解或者getter/setter：

1. 必须给配置类加上@Component（或者@Configuration），让Spring能扫描到这个Bean：

import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.stereotype.Component;

@Component
@ConfigurationProperties(prefix = "custom") // 前缀要和配置项的开头对应（custom.resource的前缀是custom）
public class CustomProperties {
    private String resource; // 字段名要和配置项的后半部分对应（custom.resource -> resource）

    // 重点！Spring需要通过setter注入值，所以必须写getter和setter
    public String getResource() {
        return resource;
    }

    public void setResource(String resource) {
        this.resource = resource;
    }
}

2. 如果你的配置类不在Spring默认的扫描路径下（比如放在了单独的config包但启动类没覆盖到），记得在启动类上加上@EnableConfigurationProperties来主动启用这个配置类：

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.context.properties.EnableConfigurationProperties;

@SpringBootApplication
@EnableConfigurationProperties(CustomProperties.class)
public class YourApplication {
    public static void main(String[] args) {
        SpringApplication.run(YourApplication.class, args);
    }
}

三、@Value注入的注意事项 #

如果你用@Value("${custom.resource}")注入，要避开这几个坑：

1. 注入的类必须是Spring管理的Bean（比如加了@Controller、@Service、@Component等注解），不然Spring根本不会处理@Value注解。
2. 怕配置项缺失的话，可以给个默认值，避免启动直接报错：

@Controller
public class YourController {
    // 冒号后面是默认值，配置项不存在时会用这个值
    @Value("${custom.resource:默认资源路径}")
    private String customResource;

    // 你的控制器方法逻辑...
}

四、排查配置加载顺序问题 #

如果你的配置是放在自定义的配置文件（不是默认的application.properties），得确保Spring能加载到它。比如用@PropertySource指定配置文件：

@Configuration
@PropertySource("classpath:custom.properties") // 加载classpath下的custom.properties文件
public class CustomConfig {
}

注意：@PropertySource默认不支持YAML文件，如果是YAML格式，要么改成properties，要么用Spring Boot的spring.config.additional-location配置来加载额外的YAML文件。

五、容易踩的坑点 #

• 别在@ConfigurationProperties的字段上同时加@Value，这会让Spring混淆注入方式，直接报错。
• 配置项的前缀和字段名要严格对应，比如custom.resource对应配置类里的resource字段，前缀是custom，别搞混。
• 如果是多环境配置，要确保你激活的环境（比如dev、prod）对应的配置文件里也有custom.resource，不然会找不到。

按照上面的步骤排查一遍，应该就能解决你遇到的无法解析占位符的问题啦！

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