Spring Boot如何通过YAML配置String到List的Map并支持@Value注入和环境占位符

方案1：使用@Value+SpEL实现（满足@Value注入需求） #

@Value本身不直接支持复杂结构的Map注入，可结合SpEL表达式和JSON格式的行内配置实现，天然支持${ENV:default}格式的环境变量替换：

1. Java代码中@Value的写法：

@Value("#{${class-to-methods}}")
private Map<String, List<String>> classToMethods;

2. application.yml配置写法：

# 用折叠标量包裹JSON格式配置，避免YAML转义问题
class-to-methods: >
  {
    "java.lang.Double": ["parseDouble", "toString"],
    "java.lang.String": ["toUpperCase"],
    # 示例：支持环境变量占位符，无对应环境变量则使用默认值
    "${CUSTOM_CLASS:java.lang.Long}": ["${LONG_METHOD:parseLong}", "valueOf"]
  }

注意：配置中的JSON结构要严格符合语法，引号配对正确，否则会出现解析错误。

方案2：使用@ConfigurationProperties（更推荐的无手动解析方案） #

这是Spring Boot官方推荐的复杂结构配置注入方式，类型安全、结构清晰，不需要编写复杂SpEL表达式，原生支持环境变量替换：

1. 定义配置属性类：

import org.springframework.boot.context.properties.ConfigurationProperties;
import java.util.HashMap;
import java.util.List;
import java.util.Map;

@ConfigurationProperties(prefix = "app.config")
public class ClassMethodProperties {
    private Map<String, List<String>> classToMethods = new HashMap<>();

    public Map<String, List<String>> getClassToMethods() {
        return classToMethods;
    }

    public void setClassToMethods(Map<String, List<String>> classToMethods) {
        this.classToMethods = classToMethods;
    }
}

2. 在启动类/配置类上开启配置属性扫描：

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

3. 编写application.yml配置：

app:
  config:
    class-to-methods:
      java.lang.Double:
        - parseDouble
        - toString
      java.lang.String:
        - toUpperCase
      # 示例：支持环境变量占位符
      ${CUSTOM_CLASS:java.lang.Integer}:
        - ${INT_METHOD1:parseInt}
        - ${INT_METHOD2:valueOf}

4. 使用时直接注入配置类即可：

@Autowired
private ClassMethodProperties properties;

// 取值
Map<String, List<String>> classToMethods = properties.getClassToMethods();

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