Spring Boot 的松散绑定默认启用，需配合@ConfigurationProperties和容器管理；支持短横线、下划线、驼峰、大写下划线等多种配置格式；不适用于@Value，且要求字段有getter/setter、类型可转换、yml冒号后空格。
配置类要规范写
定义一个配置类，字段用标准驼峰命名（如 userName、maxRetryCount），加上 @ConfigurationProperties(prefix = "app.user") 和 @Component：
✅ 正确示例：
@Component
@ConfigurationProperties(prefix = "app.user")
public class UserConfig {
private String userName;
private int maxRetryCount;
// getter/setter 必须有（Lombok 的 @Data 也行）
}
没有这些注解，或只用 @Value，松散绑定就不起作用。
配置文件中可写多种格式
只要前缀一致（这里是 app.user），字段名可以自由切换写法，Spring Boot 会自动归一化后匹配：
立即学习“Java免费学习笔记（深入）”；
deep-java-review
下载
Java项目代码review工具。分析Git变更+完整调用链路上下文，推断业务需求，进行多维度评分和分类汇总，生成完整PRD文档。包含细粒度Java代码审查清单（Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...
-
app.user.user-name=true（短横线，.properties/.yml 都推荐） -
app.user.user_name=true（下划线） -
app.user.userName=true（标准驼峰，仅限 properties 文件） -
APP_USER_USERNAME=true（全大写+下划线，适用于环境变量） -
--app.user.user-name=true（命令行参数，双短横开头）
注意：app.user.USER_NAME 这种在 properties 里写法不被识别，大小写敏感且不走松散规则；但环境变量天然转大写，所以 APP_USER_USERNAME 可以。
嵌套对象和集合也支持松散绑定
比如配置类里有个 Security security 对象，其内部字段 loginTimeoutSeconds：
-
app.user.security.login-timeout-seconds=30（yml 或 properties 中最常用） app.user.security.login_timeout_seconds=30-
APP_USER_SECURITY_LOGIN_TIMEOUT_SECONDS=30（环境变量）
List 或 Map 同样适用，例如 app.features.enabled[0]=log、app.features.enabled[1]=cache，也能识别成 List<String>。
别踩这些坑
-
不要只用 @Value：它不支持松散绑定，
@Value("${app.user.user-name}")会报错，必须写成${app.user.userName} -
prefix 必须是 kebab-case（短横线）：比如
@ConfigurationProperties(prefix = "my-db")是合法的，但prefix = "myDB"或"myDb"在某些版本可能触发警告或不兼容 - 类型要能转换：字符串配 boolean、int 等基本类型没问题，但如果字段是自定义类且没提供构造器或 setter，绑定会失败
-
yml 中冒号后必须空格：写成
user-name: true✅，user-name:true❌（YAML 语法错误，根本读不到）
松散绑定本质是 Spring Boot 在加载配置时，把各种命名风格统一转成小写字母+去除分隔符的字符串，再和 Java 字段名做模糊比对。它省心，但依赖约定，不依赖魔法。
