Spring Boot配置属性命名差异咨询：healthCheckUrl与health-Check-Url

这个差异其实是Spring Boot核心的**松散绑定（Relaxed Binding）**机制在起作用，同时结合了IDE的补全逻辑，具体拆解如下：

• Spring Boot的松散绑定规则
  Spring Boot在处理@ConfigurationProperties注解标记的配置类（比如ConsulDiscoveryProperties）时，支持多种配置命名风格与Java驼峰式变量的映射：

  • Java类中的驼峰式变量healthCheckUrl，可以对应配置中的：
    • 短横线分隔的kebab-case（官方推荐）：health-check-url
    • 下划线分隔的snake_case：health_check_url
    • 全大写下划线分隔：HEALTH_CHECK_URL
    • 甚至混合大小写的短横线形式（比如IDE补全的health-Check-Url）
      这些写法都会被Spring自动解析并绑定到healthCheckUrl变量上，核心是忽略大小写和分隔符的差异。

• IntelliJ自动补全的显示逻辑
  IntelliJ的Spring Boot配置补全功能，会把Java类的驼峰变量转换为一种更易读的分隔形式（也就是你看到的health-Check-Url），但这只是IDE的显示优化——实际配置时，你用这种混合大小写的写法，或者标准的全小写kebab-case写法，都能正常生效。

• 额外提醒
  虽然多种写法都支持，但Spring官方推荐在配置文件（比如application.yml/application.properties）中使用全小写的kebab-case风格（health-check-url），这样更符合配置文件的通用书写习惯，也能避免不必要的格式混淆。

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