Spring @ConfigurationProperties与@ConditionalOnProperty异常问题排查

问题1：@ConditionalOnProperty无法识别带子节点的父配置项 #

现象 #

配置文件中存在e.f.g: abc，但标注@ConditionalOnProperty("e.f")的EfOptionalProperties和EfgOptionalProperties未被实例化，输出中对应实例为null。

原因 #

@ConditionalOnProperty默认逻辑是检查指定属性存在且值匹配havingValue（默认值为true）。对于带子节点的父配置e.f，Spring将其视为嵌套属性（值为Map类型），无法匹配默认的字符串类型havingValue="true"，因此条件不满足，配置类未被加载。

解决方案 #

若需判断父配置是否存在（无论是否有子节点），可二选一修改：

1. 使用@ConditionalOnExpression直接检查属性存在性：

@ConditionalOnExpression("environment.containsProperty('e.f')")

2. 调整@ConditionalOnProperty参数，适配嵌套属性的存在判断：

@ConditionalOnProperty(value = "e.f", havingValue = "", matchIfMissing = false)

问题2：Autowired注入类型错误 #

现象 #

输出中ef optional properties被错误注入CdOptionalProperties实例，而非预期的EfOptionalProperties。

原因 #

代码存在类型定义错误：

@Autowired(required = false)
private CdOptionalProperties efOptionalProperties; // 类型写错

变量efOptionalProperties的类型被误写为CdOptionalProperties，Spring按类型查找Bean时，注入了该类型唯一的实例。

解决方案 #

修正变量类型为预期的EfOptionalProperties：

@Autowired(required = false)
private EfOptionalProperties efOptionalProperties;

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