SpringBoot2x升级踩坑新增Configuration-property-name限制

最近公司项目在做 SpringBoot 的升级，在升级过程中遇到了一些问题，简单记录一下，做个分享。另外，本文中的程序只为示例代码，并非公司生产环境代码。

遇到什么问题

从 SpringBoot1.x 升级到 SpringBoot2.x 之后，解决完编译异常，运行程序，在程序启动时报错：

报错信息就已经很直白的告诉了我们错误原因：

配置属性名称“com_shen”无效

无效字符：‘_’，原因：规范名称应为 kebab-case（用 ’-‘ 分隔），小写字母数字字符，并且必须以字母开头

怎么解决

经过排查，是因为在 application.properties 文件中有如下一个配置项：

com_shen.name=xiaohei

对应 Java 程序代码：

@Getter
@Setter
@ConfigurationProperties(prefix = "com_shen")
public class Service {private String name;}

结合报错日志，我们可以很容易的解决这个问题，去掉配置项中的 _，将配置项 name 修改为com.shen.name 即可。

源码解析

你以为文章写到这里就结束了吗？其实并没有。hhhhhh，通过这个问题，我们来看一下 SpringBoot2.x 的内部源码。什么，你不知道该从哪里入手来看这个源码，没关系，我们一步一步来。

点开 @ConfigurationProperties 源码，

在 Spring 中，大量的功能都是通过 BeanPostProcessor 来实现的。而且，Spring 中的源码注释写的非常的仔细。通过源码注释我们可以猜到可能是 ConfigurationPropertiesBindingPostProcessor 这个类在负责 @ConfigurationProperties 注解的背后支持。

点开 ConfigurationPropertiesBindingPostProcessor 类源码，发现在该类中 Override 了 BeanPostProcessor 的postProcessBeforeInitialization方法：

在这个方法中，调用了 bind(bean, beanName, annotation); 方法。这个方法名叫 ” 绑定 ”，方法中传入了 bean、beanName 和 annotation 的信息，经验告诉我这个方法大概率就是在负责解析@ConfigurationProperties，进行属性绑定。

于是，在这里打一个条件断点，debug 运行项目：

通过 debug 发现的确是这个方法在进行属性绑定。而且底层调用了org.springframework.boot.context.properties.bind.Binder#bind(String, Bindable<T>, BindHandler) 方法：

在这个 bind 方法中，又调用了另一个方法 bind(ConfigurationPropertyName.of(name), target, handler);，而且通过name 生成了 ConfigurationPropertyName 对象ConfigurationPropertyName.of(name)，通过方法名我们可以猜测，这个方法可能是在负责解析 Configuration Property Name，项目启动的报错信息很有可能是这个方法中抛出的。点开源码：

发现在这个方法中，调用了InvalidConfigurationPropertyNameException.throwIfHasInvalidChars(name,ElementValidator.getInvalidChars(elementValue));。Spring 代码命名真的是太优雅了，虽然名称很长，但是让源码阅读者一看就能明白这个方法在做什么。

通过源码，我们可以看到，在 SpringBoot 中对 Configuration property name 中的字符进行了有效性的判断，判断规则如上图所示。

ElementValidator类是 ConfigurationPropertyName 的一个内部类。ConfigurationPropertyName是 SpringBoot2.0 新增的一个类，让我们一起来阅读一下类中注释，了解一下这个类：

机器翻译结果如下：

由点分隔的元素组成的配置属性名称。用户创建的名称可以包含字符“a-z”，“0-9”）和“-”，它们必须为小写字母，并且必须以字母数字字符开头。“-”仅用于格式化，即“foo-bar”和“foobar”被认为是等效的。
“[”和“]”字符可用于表示关联索引（即 Map 键或 Collection 索引。索引名称不受限制，并且区分大小写。

以下是一些典型示例：

spring.main.banner-mode
server.hosts [0]。名称
日志[org.springboot] .level

使用 @Value

我们知道，SpringBoot 中除了可以使用 @ConfigurationProperties 之外，还可以使用@Value。

Demo 程序如下：

@Getter
@Setter
@Component
public class Service {@Value("${com_shen.name}")
    private String name;
}

application.properties文件:

com_shen.name=xiaohei

在这种情况下，项目依旧启动成功了，而且成功的获取到了 com_shen.name 的属性值。也就是说，@Value注解中并没有表达式做限制。

拓展阅读

Property Binding in Spring Boot 2.0：https://spring.io/blog/2018/0…

---

欢迎关注公众号，大家一起学习成长。