@ConditionalOnProperty不直接使用松绑定规则

@ConditionalOnProperty 并不直接使用松绑定规则

@ConditionalOnProperty 注解在处理 YAML 配置文件中的属性时，不会自动将短横线（-）命名转换为大写 。YAML 中的属性名通常使用短横线分隔（例如 my-config-property），而 Spring Boot 的 @ConditionalOnProperty 在匹配时，默认情况下是区分大小写的，并且不会自动进行命名风格的转换。

不过，Spring Boot 的属性绑定机制在将 YAML 或 properties 文件中的属性映射到 @ConfigurationProperties 类时，支持松绑定的规则 ，这意味着它能够处理不同命名风格（如短横线、下划线、驼峰等）到标准驼峰命名的转换。但请注意：@ConditionalOnProperty 并不直接使用松绑定规则。

@ConditionalOnProperty 的工作原理是直接检查 Environment 中是否存在指定的属性，并且其值是否满足条件。属性在 Environment 中的名称必须与注解中指定的 name 或 value 完全匹配（包括大小写和分隔符） ，除非您明确使用了 matchIfMissing 等属性。

常见情况说明：

YAML 中的短横线命名：例如，YAML 中有：
yaml 复制代码
```
my-app:
  enable-feature: true
```
在 @ConditionalOnProperty 中，您应该使用：
java 复制代码
```
@ConditionalOnProperty(name = "my-app.enable-feature", havingValue = "true")
```
这里名称必须写为 "my-app.enable-feature"（保持短横线），不能写成 "myApp.enableFeature" 或其他形式。
如果需要匹配多个命名风格 ：@ConditionalOnProperty 本身不提供自动转换，但您可以通过 prefix 和 name 组合，或者使用多个 @ConditionalOnProperty 注解来覆盖不同的属性名变体。
最佳实践 ：建议在 YAML 和 @ConditionalOnProperty 中使用一致的命名风格（通常推荐短横线命名，因为这是 Spring Boot 配置文件的默认风格），以避免不必要的匹配问题。

如果您遇到无法匹配的问题，请检查：

属性在 Environment 中的实际名称（可以通过启用 debug 日志或使用 /actuator/env 端点查看）。
注解中的 name 是否与配置中的名称完全一致。

matchIfMissing

`matchIfMissing` 属性的含义

matchIfMissing 是 @ConditionalOnProperty 注解的一个参数（默认值为 false）。它用于指定：当配置文件中完全不存在该属性时，是否应该满足条件。

如果 matchIfMissing = true：

即使配置文件中没有定义这个属性，条件也会被满足（即条件为 true），相关的 Bean 或配置类会被创建。
如果 matchIfMissing = false（默认）：

只有当配置文件中明确存在 该属性，并且属性值匹配 havingValue（如果设置了）时，条件才满足。

示例说明

假设我们有以下代码：

java 复制代码

@Configuration
@ConditionalOnProperty(
    name = "myapp.feature.enabled", 
    havingValue = "true",
    matchIfMissing = false  // 默认值，可以省略
)
public class MyFeatureConfiguration {
    // 这个配置类仅在 myapp.feature.enabled=true 时生效
}

场景 1 ：配置文件中有该属性，且值为 true

yaml 复制代码

myapp:
  feature:
    enabled: true

✅ 条件满足，MyFeatureConfiguration 生效。

场景 2 ：配置文件中有该属性，但值为 false

yaml 复制代码

myapp:
  feature:
    enabled: false

❌ 条件不满足（因为 havingValue 要求是 "true"），配置类不生效。

场景 3 ：配置文件中没有该属性

yaml 复制代码

# 没有定义 myapp.feature.enabled

❌ 条件不满足（因为 matchIfMissing = false），配置类不生效。

但如果我们将 matchIfMissing 改为 true：

java 复制代码

@ConditionalOnProperty(
    name = "myapp.feature.enabled", 
    havingValue = "true",
    matchIfMissing = true   // 关键变化
)

场景 3 变为 ：配置文件中没有该属性

yaml 复制代码

# 没有定义 myapp.feature.enabled

✅ 条件满足（因为 matchIfMissing = true），配置类会生效。

常见用途

默认启用功能 ：如果您希望某个功能在默认情况下是开启的（即没有配置时也启用），但允许用户通过设置 属性=false 来显式关闭它。
向后兼容 ：在旧版本中某个功能是默认存在的，新版本中允许通过配置禁用，此时可以使用 matchIfMissing = true 来保持默认行为。

注意事项

matchIfMissing 仅适用于属性不存在 的情况。如果属性存在但值不匹配（例如值为 false），即使 matchIfMissing = true，条件也不会满足。
属性名（name）必须与配置文件中的键完全匹配（包括大小写和分隔符），之前提到的命名风格转换规则在这里同样适用。

@ConditionalOnProperty不直接使用松绑定规则

@ConditionalOnProperty 并不直接使用松绑定规则

常见情况说明：

matchIfMissing

matchIfMissing 属性的含义

示例说明

常见用途

注意事项

`matchIfMissing` 属性的含义