使用Implicit Reads将JSON转为Map时遇StackOverflow错误求排查

嘿，我来帮你搞定这个栈溢出问题！首先咱们梳理下你的场景：你想把嵌套的JSON对象转换成Map[String, Pass]，但自定义Reads的时候触发了StackOverflowError，对吧？

问题根源分析 #

你遇到的栈溢出大概率是因为自定义Reads时不小心写了无限递归逻辑。比如如果你的reads方法里调用了jv.validate[Map[String, Pass]]，而这个validate又依赖了你自己定义的mapReads，就会陷入无限调用reads方法的死循环，最终把栈撑爆。

正确解决方案：利用Play JSON内置的推导能力 #

其实根本不需要手动实现Map[String, Pass]的Reads！Play JSON已经内置了对Map类型的支持，只要你有Pass类的隐式Reads，就能自动推导出来Map[String, Pass]的Reads。

步骤1：定义Case Class并自动推导其Reads

import play.api.libs.json._

case class Pass(field1: String, field2: String)

// 自动推导Pass的隐式Reads（Play 2.10+版本支持）
implicit val passReads: Reads[Pass] = Json.reads[Pass]

步骤2：直接使用内置的Map Reads（或自动推导）

你有两种方式获取Map[String, Pass]的Reads：

1. 显式调用内置方法生成：

implicit val mapPassReads: Reads[Map[String, Pass]] = Reads.mapReads[Pass]

2. 更简单：只要有Pass的隐式Reads，解析时直接用as[Map[String, Pass]]或validate[Map[String, Pass]]即可，Play会自动推导。

测试你的JSON数据

用你的JSON来验证：

// 你的JSON数据
val jsonStr = """
{
  "pass": {
    "key-1": { "field1": "aaaa", "field2": "aaaa" },
    "key-2": { "field1": "aaaa", "field2": "aaaa" },
    "key-3": { "field1": "aaaa", "field2": "aaaa" }
  }
}
"""

val json = Json.parse(jsonStr)

// 解析pass字段为Map[String, Pass]
val parseResult = (json \ "pass").validate[Map[String, Pass]]

parseResult match {
  case JsSuccess(passMap, _) => println(s"解析成功：$passMap")
  case JsError(errors) => println(s"解析失败：$errors")
}

运行后会输出：解析成功：Map(key-1 -> Pass(aaaa,aaaa), key-2 -> Pass(aaaa,aaaa), key-3 -> Pass(aaaa,aaaa))

为什么你的自定义Reads会出问题？ #

举个典型的错误写法例子，这种写法会直接触发栈溢出：

// ❌ 错误示例：无限递归导致StackOverflowError
implicit val mapReads: Reads[Map[String, Pass]] = new Reads[Map[String, Pass]] {
  def reads(jv: JsValue): JsResult[Map[String, Pass]] = {
    // 这里调用validate会再次使用这个mapReads，无限递归调用reads方法
    jv.validate[Map[String, Pass]]
  }
}

这种情况下，每次调用reads都会触发新的validate，而validate又会调用reads，循环往复直到栈耗尽。

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