如何用TypeSafeConfig和PureConfig加载Map[String, Any]类型配置？

PureConfig默认不支持直接读取Map[String, Any]，这是因为它的设计核心是类型安全——Any是无约束的宽泛类型，PureConfig无法自动推断该把配置值解码成哪种具体类型（比如字符串、整数还是布尔值）。不过我们可以通过自定义ConfigReader来实现这个灵活需求。

步骤1：自定义ConfigReader[Map[String, Any]] #

我们需要编写一个隐式的ConfigReader，手动处理不同类型的配置值。下面的示例会覆盖常见的基础类型，还支持嵌套Map结构：

import pureconfig._
import pureconfig.generic.semiauto._
import com.typesafe.config.{ConfigObject, ConfigValue, ConfigValueType}

// 先实现Any类型的读取器，处理基础类型和嵌套结构
implicit val anyConfigReader: ConfigReader[Any] = ConfigReader.fromString { str =>
  // 先尝试从字符串字面量解析布尔/整数类型
  str match {
    case "true" => Right(true)
    case "false" => Right(false)
    case s if s.forall(_.isDigit) => Right(s.toInt)
    case s => Right(s)
  }
}.orElse(ConfigReader.fromConfigValue {
  case cv if cv.valueType() == ConfigValueType.NUMBER =>
    Right(cv.unwrapped().asInstanceOf[Number].intValue())
  case cv if cv.valueType() == ConfigValueType.BOOLEAN =>
    Right(cv.unwrapped().asInstanceOf[Boolean])
  case cv if cv.valueType() == ConfigValueType.STRING =>
    Right(cv.unwrapped().asInstanceOf[String])
  case cv: ConfigValue if cv.valueType() == ConfigValueType.OBJECT =>
    // 递归解析嵌套的Map结构
    cv.asInstanceOf[ConfigObject].toConfig.load[Map[String, Any]]
      .left.map(_.toConfigReaderFailure)
  case cv => Left(CannotConvert(cv.render(), "Any", s"不支持的配置值类型: ${cv.valueType()}"))
})

// 基于上面的Any读取器，派生Map[String, Any]的读取器
implicit val mapStringAnyReader: ConfigReader[Map[String, Any]] = deriveReader[Map[String, Any]]

步骤2：用自定义读取器加载配置 #

假设你的application.conf配置内容是：

map-name {
  stringValue = "firstValue"
  intValue = 1
  booleanValue = true
  nestedMap {
    innerInt = 2
    innerBool = false
  }
}

现在可以直接加载配置了：

// 方式1：封装到配置类中
case class AppConfig(mapName: Map[String, Any])
val appConfig = ConfigSource.default.load[AppConfig]

// 方式2：直接读取指定路径的Map
val targetMap = ConfigSource.default.at("map-name").load[Map[String, Any]]

注意事项 #

• 这种方式会牺牲部分类型安全性，后续使用Any类型值时，建议通过模式匹配而非强制转换来处理类型，避免运行时错误：

  targetMap.foreach { case (key, value) =>
    value match {
      case s: String => println(s"字符串值: $s")
      case i: Int => println(s"整数值: $i")
      case b: Boolean => println(s"布尔值: $b")
      case nested: Map[String @unchecked, Any @unchecked] => println(s"嵌套Map: $nested")
      case _ => println(s"未知类型: $value")
    }
  }
  

• 如果你的场景只需要处理几种特定类型，建议用联合类型（比如Either[String, Either[Int, Boolean]]）替代Any，在灵活性和类型安全之间取得平衡。

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