如何用SpEL定义Map<String, List<String>>？Spring配置加载为null问题

核心错误点 #

1. 配置文件格式错误：你在.properties中直接使用了SpEL风格的Map语法，但Spring的properties配置不支持这种写法，会导致属性无法被正确解析；
2. @Value注解语法错误：原注解@Value("${ordering:#{{:}}")缺少闭合的}符号，且默认值的SpEL写法不正确。

正确实现方式 #

方式一：使用@Value配合正确的配置格式 #

1. 调整配置文件格式

采用Spring支持的层级属性写法（.properties）：

ordering.SOMEVALUE[0]=ONE
ordering.SOMEVALUE[1]=THREE
ordering.SOMEVALUE[2]=TWO
ordering.OTHERVALUE[0]=THREE
ordering.OTHERVALUE[1]=ONE
ordering.OTHERVALUE[2]=TWO

如果使用.yml文件，格式更直观：

ordering:
  SOMEVALUE:
    - ONE
    - THREE
    - TWO
  OTHERVALUE:
    - THREE
    - ONE
    - TWO

2. 修正@Value注解

使用SpEL解析整个配置层级，同时设置空Map作为默认值：

@Value("#{${ordering:{{}}}}")
private Map<String, List<String>> ordering;

• ${ordering:{{}}}：若配置中无ordering项，使用空Map{{}}作为默认值；
• 外层#{...}：告知Spring用SpEL解析表达式，将配置层级结构转换为Map<String, List<String>>。

方式二：使用@ConfigurationProperties（更推荐） #

对于复杂嵌套类型属性，@ConfigurationProperties比@Value更简洁友好：

1. 添加配置处理器依赖（Spring Boot项目可选，提供IDE提示）

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-configuration-processor</artifactId>
    <optional>true</optional>
</dependency>

2. 编写配置类

直接绑定Map类型属性：

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

@Component
@ConfigurationProperties(prefix = "ordering")
public class OrderingProperties {
    private Map<String, List<String>> values;

    // Getter & Setter
    public Map<String, List<String>> getValues() {
        return values;
    }

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

3. 对应配置文件（.properties）

ordering.values.SOMEVALUE[0]=ONE
ordering.values.SOMEVALUE[1]=THREE
ordering.values.SOMEVALUE[2]=TWO
ordering.values.OTHERVALUE[0]=THREE
ordering.values.OTHERVALUE[1]=ONE
ordering.values.OTHERVALUE[2]=TWO

4. 业务类中注入使用

@Autowired
private OrderingProperties orderingProperties;

// 使用示例
Map<String, List<String>> ordering = orderingProperties.getValues();

SpEL测试方法 #

Spring官方无在线解析工具，但可编写简单Java类验证SpEL表达式：

import org.springframework.expression.ExpressionParser;
import org.springframework.expression.spel.standard.SpelExpressionParser;

public class SpelValidator {
    public static void main(String[] args) {
        ExpressionParser parser = new SpelExpressionParser();
        String spelExpr = "{SOMEVALUE: {'ONE','THREE','TWO'}, OTHERVALUE: {'THREE','ONE','TWO'}}";
        Object result = parser.parseExpression(spelExpr).getValue();
        System.out.println("解析结果类型：" + result.getClass());
        System.out.println("解析结果：" + result);
    }
}

运行该类即可验证表达式是否能正确解析为目标类型。

内容的提问来源于stack exchange，提问作者András Ballai