使用Snakeyaml映射带下划线YAML字段到Java POJO报错如何解决

问题核心原因：SnakeYAML默认严格匹配YAML字段名与POJO属性名，下划线命名和驼峰命名无法自动对应，因此抛出找不到属性的异常。

修复方案 #

• 方案1：字段注解显式指定映射关系
  这是最通用的适配方案，直接在POJO对应驼峰字段上添加注解声明匹配的下划线字段名即可：

  import org.yaml.snakeyaml.yaml2json.PropertyName;
  
  public class Consumer {
      // 显式指定对应YAML中的oauth2_credentials字段
      @PropertyName("oauth2_credentials")
      private String oauth2Credentials;
  
      // 请保留对应字段的getter、setter方法
      public String getOauth2Credentials() {
          return oauth2Credentials;
      }
  
      public void setOauth2Credentials(String oauth2Credentials) {
          this.oauth2Credentials = oauth2Credentials;
      }
  }
  

  如果是结合Jackson使用SnakeYAML，也可以替换为@JsonProperty("oauth2_credentials")注解。

• 方案2：配置全局命名转换规则
  项目中下划线字段较多的场景下，可以自定义SnakeYAML的属性转换策略，实现全局自动下划线转驼峰，不需要逐个字段加注解：

  import com.google.common.base.CaseFormat;
  import org.yaml.snakeyaml.Yaml;
  import org.yaml.snakeyaml.constructor.Constructor;
  import org.yaml.snakeyaml.introspector.BeanAccess;
  import org.yaml.snakeyaml.introspector.PropertyNamingStrategy;
  import org.yaml.snakeyaml.introspector.PropertyUtils;
  
  public class YamlParser {
      public Consumer parseYaml(String yamlContent) {
          Yaml yaml = new Yaml(new Constructor(Consumer.class) {
              @Override
              protected PropertyUtils getPropertyUtils() {
                  PropertyUtils propertyUtils = new PropertyUtils();
                  propertyUtils.setBeanAccess(BeanAccess.DEFAULT);
                  propertyUtils.setPropertyNamingStrategy(new PropertyNamingStrategy() {
                      @Override
                      public String translate(String yamlFieldName) {
                          // 下划线命名转驼峰命名
                          return CaseFormat.LOWER_UNDERSCORE.to(CaseFormat.LOWER_CAMEL, yamlFieldName);
                      }
                  });
                  return propertyUtils;
              }
          });
          return yaml.loadAs(yamlContent, Consumer.class);
      }
  }
  

  上述代码中使用了Guava的CaseFormat工具类做命名转换，不想引入Guava也可以自行实现下划线转驼峰的逻辑。

• 方案3：Spring Boot场景适配
  如果是Spring Boot项目中使用@ConfigurationProperties加载YAML配置，不需要额外修改代码，框架默认支持宽松绑定规则，可自动识别下划线字段映射到驼峰属性。如果不生效请检查是否添加了@EnableConfigurationProperties或@ConfigurationPropertiesScan注解开启配置绑定能力。

不推荐的临时方案：直接将POJO的字段名修改为和YAML一致的下划线命名，虽然可以解决报错，但不符合Java编码规范，后期维护成本更高。

内容的提问来源于stack exchange，提问作者adesai