Spring systemProperties配置异常及默认值失效问题求助

我来帮你分析下Spring 4.3.9里遇到的这个问题，大概率是你配置默认值的语法写错了，导致Spring没法正确识别URL里的myServiceKey参数，只能 fallback到默认值，甚至在某些场景下没拿到有效值抛出null异常。

1. 核心问题：默认值配置的语法错误 #

在Spring中，使用${}表达式配置默认值的正确语法是${属性名:默认值}，注意两个关键点：

• 冒号和默认值之间不能有空格
• 默认值不需要额外加引号（除非默认值本身包含特殊字符，比如空格、逗号等）

举个例子：

• 正确写法：${myServiceKey:defaultValue}
• 错误写法（大概率是你踩的坑）：${myServiceKey: defaultValue}（冒号后多了空格），或者${myServiceKey:"defaultValue"}（给默认值加了多余引号）

如果用了错误写法，Spring会直接认为myServiceKey这个属性不存在，要么把带空格/带引号的字符串当成默认值，要么因为解析表达式失败直接返回null，这就解释了你遇到的两个问题：总是用默认值、触发KEY must not be null异常。

2. 对比正确与错误的XML配置 #

假设你原本能正常获取参数的配置是这样：

<bean id="yourServiceBean" class="com.yourpackage.YourService">
    <property name="serviceKey" value="${myServiceKey}" />
</bean>

要添加默认值，正确的修改应该是：

<bean id="yourServiceBean" class="com.yourpackage.YourService">
    <property name="serviceKey" value="${myServiceKey:defaultValue}" />
</bean>

如果写成下面这些错误形式，必然出问题：

• <property name="serviceKey" value="${myServiceKey: defaultValue}" />：Spring会把 defaultValue（带空格）当成默认值，完全不会去识别URL里的myServiceKey参数
• <property name="serviceKey" value="${myServiceKey:"defaultValue"}" />：这种写法会让Spring解析表达式失败，最终传入null给你的Bean，触发非null校验的异常

3. 为什么会触发IllegalArgumentException: KEY must not be null？ #

当Spring无法正确解析${}表达式时，可能返回null（比如语法错误导致表达式失效），而你的代码里某个接收serviceKey的方法/构造函数做了非null校验，比如：

public class YourService {
    private String serviceKey;

    public void setServiceKey(String serviceKey) {
        if (serviceKey == null) {
            throw new IllegalArgumentException("KEY must not be null");
        }
        this.serviceKey = serviceKey;
    }
}

此时Spring传入null，就会直接抛出这个异常。

4. 快速排查步骤 #

1. 检查appContext.xml中${myServiceKey:defaultValue}的语法，确保冒号和默认值之间无空格、无多余引号
2. 手动构造带myServiceKey参数的请求，打印Bean的serviceKey属性值，确认是否正确获取
3. 开启Spring的debug日志，查看属性解析过程，确认Spring是否识别到了URL中的myServiceKey参数

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