Spring Boot从1.5.6升级至2.0.0后出现Could not bind properties绑定错误求助

我之前把Spring Boot从1.5.6升级到2.0.0的时候，也踩过不少坑，其中就碰到了你说的这个Could not bind properties问题。当时的场景和你一模一样：定义了带@Data和@ConfigurationProperties("eclipseLink")的EclipseLinkProperties类，然后在@Configuration+@EnableConfigurationProperties(EclipseLinkProperties.class)的WebDatasourceConfig里用它，结果编译直接报错，日志片段如下：

2018-03-18 18:44:58.560 INFO 3528 --- [ main] trationDelegate$BeanP...

结合我当时的排查经验，给你几个大概率能解决问题的方向：

• 绑定规则变严格了
  Spring Boot 2.0对@ConfigurationProperties的绑定校验比1.5.x严格多了，之前松散的属性名匹配在新版本里可能直接失效。比如你类里是驼峰命名的字段，配置文件里用了短横线分隔，或者反过来，就会绑定失败。
  解决方式：

  1. 先核对配置文件里的属性名和类中字段名的匹配，确保符合Spring Boot的绑定规则（比如eclipseLink.someProperty对应配置文件里的eclipse-link.some-property）
  2. 如果需要保留原来的松散绑定习惯，可以给@ConfigurationProperties加参数放宽限制：

     @Data
     @ConfigurationProperties(prefix = "eclipseLink", ignoreUnknownFields = true, ignoreInvalidFields = true)
     public class EclipseLinkProperties {
         // 你的字段定义
     }
     

• prefix参数的写法建议调整
  Spring Boot 2.0更推荐prefix用全小写加短横线的格式，比如把eclipseLink改成eclipse-link，同时配置文件里也对应改成eclipse-link.xxx的写法。虽然不是强制要求，但这样能避免很多大小写导致的绑定问题。
  调整后的类：

  @Data
  @ConfigurationProperties(prefix = "eclipse-link")
  public class EclipseLinkProperties {
      // 字段定义
  }
  

  对应的application.yml配置：

  eclipse-link:
      some-property: your-value
  

• 依赖版本不兼容
  升级到2.0后，相关依赖的版本可能跟不上了，比如你用的Lombok@Data，要确保版本和Spring Boot 2.0兼容（至少1.16.20及以上）。另外Spring Boot 2.0要求JDK 8+，也检查下自己的JDK版本是否符合要求。
  建议尽量用Spring Boot的starter来管理依赖，避免手动指定版本导致冲突。

• 配置类的注册方式调整
  有时候问题出在EclipseLinkProperties没被Spring容器正确注册。你可以试试给这个类加上@Component注解，让Spring自动扫描到它，这样甚至可以不用在@EnableConfigurationProperties里指定类了：

  @Data
  @Component
  @ConfigurationProperties(prefix = "eclipse-link")
  public class EclipseLinkProperties {
      // 字段定义
  }
  

  然后配置类改成构造注入（Spring Boot 2.0推荐这种方式）：

  @Configuration
  public class WebDatasourceConfig {
      private final EclipseLinkProperties eclipseLinkProperties;
  
      public WebDatasourceConfig(EclipseLinkProperties eclipseLinkProperties) {
          this.eclipseLinkProperties = eclipseLinkProperties;
      }
  
      // 你的数据源配置逻辑
  }
  

你可以按照这几个方向逐一排查，应该能解决问题。

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