micronaut 默认将配置属性统一规范化为短横线分隔（kebab-case），无论源配置使用驼峰还是下划线，@eachproperty 绑定时均以 kebab-case 为准；开发者应主动在 yaml/properties 文件中采用 kebab-case 命名，而非依赖框架兼容旧格式。
micronaut 默认将配置属性统一规范化为短横线分隔（kebab-case），无论源配置使用驼峰还是下划线，@eachproperty 绑定时均以 kebab-case 为准；开发者应主动在 yaml/properties 文件中采用 kebab-case 命名，而非依赖框架兼容旧格式。
Micronaut 在设计上严格遵循“配置即契约”原则，其属性绑定机制会在加载阶段对所有配置键进行标准化处理：自动将 camelCase、snake_case 等形式统一转换为 kebab-case（小写字母 + 连字符），以降低内存开销、提升属性解析效率，并确保跨环境配置的一致性。这意味着，即使你在 application.yml 中写 defaultCharset: UTF-8，Micronaut 内部仍将其归一化为 default-charset；而 @EachProperty 所绑定的 POJO 字段名，必须与归一化后的键名语义对齐，而非原始书写形式。
因此，正确做法是在配置文件中直接使用 kebab-case，并在 Java/Kotlin 类中通过 @Bindable 或标准字段命名（支持驼峰）实现映射。例如：
# application.yml
myapp:
services:
- name: "auth-service"
timeout-ms: 5000
enable-ssl: true
- name: "user-service"
timeout-ms: 3000
enable-ssl: false
// 对应配置类（字段名可为 camelCase，Micronaut 自动映射）
@EachProperty("myapp.services")
public class ServiceConfig {
private String name; // ← 映射到 "name"（已为 kebab-case）
private int timeoutMs; // ← 映射到 "timeout-ms"
private boolean enableSsl; // ← 映射到 "enable-ssl"
// getter/setter 省略
}
⚠️ 注意事项：
- 不要试图在配置中写 timeoutMs: 5000 或 enableSsl: true —— Micronaut 不会反向将 kebab-case 转为 camelCase 键名，该写法会导致绑定失败（字段为 null 或默认值）；
- @ConfigurationProperties 同样遵循此规则，无例外；
- 若需兼容遗留配置（如外部系统强制输出 camelCase），可通过自定义 PropertySource 或 Environment 后置处理器预处理键名，但违背 Micronaut 设计哲学，不推荐用于新项目；
- 使用 @Parameter 或 @Value("${...}") 注入单个属性时，也必须使用 kebab-case 形式占位符，例如 @Value("${myapp.services[0].timeout-ms}")。
总结：Micronaut 的 kebab-case 规范不是 bug，而是核心设计约束。拥抱它 —— 统一配置风格、减少歧义、提升可维护性。从 application.yml 开始，坚持使用 kebab-case，让 @EachProperty 绑定清晰、可靠、零意外。
