Typesafe Config中如何将字符串与列表统一解析为Java列表

不需要修改HOCON原文件，直接在配置读取层做包装即可，两种常用实现方式：

1. 轻量工具类封装（小项目优先用） #

config.resolve()本身只做配置引用解析，不会做类型自动转换，你可以在resolve执行完之后，封装一个通用的取值方法，自动判断字段类型做适配：

import com.typesafe.config.Config;
import com.typesafe.config.ConfigValueType;
import java.util.Collections;
import java.util.List;

public class HoconUtils {
    /**
     * 读取字符串列表，自动将单个字符串值包装为单元素列表
     */
    public static List<String> getStringList(Config config, String configPath) {
        ConfigValueType type = config.getValue(configPath).valueType();
        if (type == ConfigValueType.LIST) {
            return config.getStringList(configPath);
        }
        if (type == ConfigValueType.STRING) {
            return Collections.singletonList(config.getString(configPath));
        }
        throw new IllegalArgumentException("配置项[" + configPath + "]类型非法，仅支持字符串或字符串列表");
    }
}

读取foo数组下每个对象的f字段时，统一调用HoconUtils.getStringList(config, "foo." + index + ".f")即可，不管f是单个字符串还是数组，返回值都是统一的List<String>类型，原有resolve逻辑完全不用改。

2. 自定义类型转换器（适配全局自动转换） #

如果项目里需要大量做这类单值转列表的适配，或者用了配置自动绑定Java Bean的能力，可以实现自定义的类型读取逻辑，注册到配置解析体系里，后续直接调用原生get方法或者Bean注入就能自动完成转换，不需要每次调用工具类。
核心判断逻辑和上面的工具类一致：如果是字符串就包装为单元素列表，如果是列表就直接读取。如果用Spring Boot绑定HOCON配置，直接实现Converter<String, List<String>>注册即可；如果直接用原生Typesafe Config，可以把转换逻辑封装到自定义的Config包装类里，替代原生Config实例对外提供读取方法。

踩坑提醒：不要尝试修改Config实例的内部结构做值替换，HOCON的Config实例是不可变的，强行修改内部实现会破坏resolve、配置合并等原生能力，上层包装读取逻辑是兼容性最高、改造成本最低的方案。

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