Spring Boot中on/off被转为true/false是因类型转换器扩展支持，而非YAML规范；@Value注入String时保持原值，绑定boolean字段时才触发转换，手动用Boolean.parseBoolean会误判。
YAML 本身只承认 true 和 false（不区分大小写）为合法布尔字面量，像 on、off、yes、no、1、0 等都不是 YAML 规范定义的布尔值——它们在标准解析器（如 SnakeYAML）中会被当作字符串处理。Spring Boot 默认使用 SnakeYAML 解析 application.yml，它严格遵循 YAML 1.2 规范，不会自动将 on 转成 true。所谓“被误解析”，实际多是以下两类混淆导致：
一、YAML 解析层未识别，但 Spring 类型转换器做了隐式转换
当配置项通过 @ConfigurationProperties 绑定到 boolean 字段时，Spring 会调用其内置的 ConversionService 尝试把原始字符串转为布尔值。这个转换器扩展支持了更多语义等价词，包括："true"、"false"、"on"、"off"、"yes"、"no"（源码见 org.springframework.core.convert.support.StringToBooleanConverter）。
这意味着：
-
enabled: on→ 绑定到boolean enabled字段时，会变成true -
active: off→ 绑定到boolean active字段时，会变成false - 但若你用
@Value("${flag}")注入到String flag，则拿到的就是原样"on"，不会变
二、手动调用 Boolean.parseBoolean() 导致静默错误
这是最典型的陷阱：开发者读取配置后，直接用 Boolean.parseBoolean(value) 处理——而该方法只认 "true"（忽略大小写），其余全返回 false。
立即学习“Java免费学习笔记（深入）”；
例如：
Java项目代码review工具。分析Git变更+完整调用链路上下文，推断业务需求，进行多维度评分和分类汇总，生成完整PRD文档。包含细粒度Java代码审查清单（Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...
-
Boolean.parseBoolean("on") → false（不是报错，而是错判） -
Boolean.parseBoolean("off") → false（本意是 false，结果碰巧对，但逻辑不可靠） -
Boolean.parseBoolean("yes") → false（明显语义丢失）
✅ 正确做法是：优先依赖 Spring 的类型转换机制，避免手写解析逻辑；若必须手动处理，改用更健壮的方式：
✔ 推荐封装一个兼容 YAML 常见布尔别名的解析器：
public static Boolean parseYamlBoolean(String s, Boolean defaultValue) {
if (s == null || s.trim().isEmpty()) return defaultValue;
String clean = s.trim().toLowerCase();
if ("true".equals(clean) || "on".equals(clean) || "yes".equals(clean) || "1".equals(clean)) {
return true;
}
if ("false".equals(clean) || "off".equals(clean) || "no".equals(clean) || "0".equals(clean)) {
return false;
}
return defaultValue; // 或抛 IllegalArgumentException
}三、配置类字段命名引发的意外覆盖
Spring Boot 对布尔字段有特殊 getter 命名约定。例如字段叫 isOpen，其 getter 必须是 isOpen()（而非 getIsOpen()）。若命名不规范，可能导致配置无法绑定，回退到默认值 false，看起来像“isOpen: true 没生效”。
检查点：
- 字段声明为
private boolean isOpen; - 确保 Lombok 的
@Data或手动写的 getter 是public boolean isOpen() { return isOpen; } - 避免字段名为
is（如private boolean is;），因为 Spring 会把它和 JavaBean 的isXXX()语法冲突，极易绑定失败
四、YAML 缩进或冒号后空格问题导致类型误判
YAML 对格式敏感。以下写法看似一样，实则含义不同：
-
feature: on→ 正确：keyfeature值为字符串"on" -
feature: on # 注释→ 正确 -
feature:on（冒号后无空格）→ ❌ 非法 YAML，解析失败或被当作文本键 -
feature: on（冒号后多个空格+on）→ 仍为字符串，没问题 -
feature: true→ 明确布尔值，最安全
建议：所有布尔配置项统一使用 true/false 字面量，既符合 YAML 规范，又规避所有转换歧义。
