Scala/Play：修改Json.format宏行为以单独处理单个字段

完全理解你的痛点——手动写Reads不仅繁琐还容易出错，能靠宏解决的绝对不想自己动手！针对你说的这种「大部分字段用默认解析，仅单个Seq字段需要把缺失/null转为空序列」的需求，有几个非常优雅的原生方案：

方案一：全局自定义Seq的Reads（适合多个Seq字段的场景） #

如果你的case class里有不止一个类似的Seq字段，或者希望所有Seq类型都自动处理缺失的情况，可以给Seq[T]定义一个通用的隐式Reads：

import play.api.libs.json._

// 定义通用规则：当字段缺失或为null时，返回空序列
implicit def optionalSeqReads[T: Reads]: Reads[Seq[T]] = {
  // readNullable会把缺失/null转为None，再映射为空序列
  Reads.optionNoError(Reads.seq[T]).map(_.getOrElse(Seq.empty[T]))
}

// 然后正常用宏生成整个case class的Reads，完全不用改其他字段
case class MyCaseClass(
  unit_code: String,
  name: Option[String],
  age: Option[Int],
  // 这个Seq字段会自动用上面的Reads，缺失时返回空序列
  positions: Seq[String]
)

implicit val myCaseClassReads: Reads[MyCaseClass] = Json.format[MyCaseClass]

这个方案的好处是一劳永逸，所有Seq[T]类型的字段都会自动遵循「缺失→空序列」的规则，完全不影响其他Option字段的默认解析逻辑。

方案二：仅修改单个字段的解析逻辑（不影响全局） #

如果你只想给特定的Seq字段做特殊处理，不想改变其他Seq的默认行为，可以基于宏生成的基础Reads做局部修改：

import play.api.libs.json._

case class MyCaseClass(
  unit_code: String,
  name: Option[String],
  age: Option[Int],
  positions: Seq[String]
)

// 先让宏生成基础的Reads（此时如果positions字段缺失，会抛出解析错误）
val baseReads = Json.format[MyCaseClass]

// 自定义positions字段的解析逻辑：允许缺失，返回空序列
val customReads: Reads[MyCaseClass] = baseReads.transform {
  case JsSuccess(obj, path) =>
    // 单独读取positions字段，允许缺失，转为空序列
    val positions = (obj.asInstanceOf[JsValue] \ "positions").asOpt[Seq[String]].getOrElse(Seq.empty)
    JsSuccess(obj.copy(positions = positions), path)
  case error: JsError => error
}

// 把自定义的Reads设为隐式
implicit val myCaseClassReads: Reads[MyCaseClass] = customReads

或者更优雅一点，用Reads组合器来替换单个字段的解析：

implicit val myCaseClassReads: Reads[MyCaseClass] = (
  // 复用宏生成的其他字段的解析逻辑
  baseReads.reads and
  // 单独覆盖positions字段的读取规则
  (__ \ "positions").readNullable[Seq[String]].map(_.getOrElse(Seq.empty[String]))
) { (obj, positions) =>
  obj.copy(positions = positions)
}

补充：如果你的case class原本用的是Option[Seq[String]] #

如果你暂时不想修改case class的字段类型（还是保留Option[Seq[String]]），但希望在解析时自动把None转为空序列，只需要在宏生成Reads后做一次map转换即可：

case class MyCaseClass(
  unit_code: String,
  positions: Option[Seq[String]]
)

implicit val myCaseClassReads: Reads[MyCaseClass] = Json.format[MyCaseClass].map { obj =>
  obj.copy(positions = obj.positions.orElse(Some(Seq.empty[String])))
}

这样解析后的对象里，positions永远不会是None，只会是Some(Seq.empty)或者包含元素的序列，完全不用手动写每个字段的读取逻辑。

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