spring boot 的 relaxed binding 机制支持驼峰命名字段自动匹配多种配置风格，如 server-port、server_port、server_port 等，但需使用 @configurationproperties 注解并满足前缀一致、有 getter/setter 等条件。
Spring Boot 的 Relaxed Binding（松散绑定）机制天然支持驼峰命名的 Java 属性与多种配置风格自动匹配，不需要额外配置——只要用 @ConfigurationProperties，它就生效。
哪些配置写法都能绑定到 camelCase 字段
假设你有一个 Java 属性 serverPort（驼峰式），以下所有配置形式在 application.yml 或 application.properties 中都可被正确识别并绑定：
-
server-port: 8080（推荐用于 YAML/properties 文件） -
server_port: 8080（常见于环境变量风格） -
SERVER_PORT=8080（系统环境变量或命令行参数） -
serverPort: 8080（YAML 中直接驼峰，也支持） -
SERVER-PORT: 8080（极少用，但底层也兼容）
必须满足的基本条件
松散绑定不是“自动生效”的魔法，需确保：
- 使用
@ConfigurationProperties(prefix = "xxx")注解类，并让该类成为 Spring Bean（加@Component或通过@EnableConfigurationProperties注册） - Java 字段有标准 getter/setter（或使用构造器绑定 +
@ConstructorBinding） - 配置文件中的 key 前缀与注解中
prefix完全一致（如prefix="server"，则配置项应为server.port、server-timeout等） - 不要混用
@Value—— 它不支持松散绑定，@Value("${server.port}")只认精确拼写，server.port有效，server-port会报错
实际配置示例
Java 类：
@ConfigurationProperties(prefix = "app")
@Component
public class AppSettings {
private int serverPort;
private String appName;
// getter/setter 省略
}
对应 application.yml 写法任选其一即可：
app: server-port: 9001 # ✅ 推荐，语义清晰 app-name: "my-service" # ✅ 自动映射到 appName
或 application.properties：
app.server_port=9001 app.app_name=my-service
注意大小写和特殊字符边界
Relaxed Binding 对大小写不敏感，但对单词分隔逻辑有约定：
-
myHttpUrl→ 可匹配my-http-url、my_http_url、MY_HTTP_URL -
XMLConfig→ 会尝试匹配xml-config、xml_config，但XML_CONFIG更稳妥（避免首字母缩写歧义） - 含数字或特殊前缀（如
apiV2Endpoint）建议统一用api-v2-endpoint配置，兼容性最好
