Scala3中为单元素样例类生成适配Play表单的unapply方法

问题背景 #

Scala 3 修改了样例类自动生成的unapply方法签名，Play 框架表单映射逻辑会显式调用该方法，导致原 Scala 2 中正常运行的表单映射代码在 Scala 3 中直接失效。Play 官方文档虽建议手动定义兼容的unapply，但手动实现繁琐，可通过元编程自动完成适配。

核心矛盾 #

现有FormHelper.unapply处理单元素样例类时，返回类型为Option[Tuple1[T]]，但 Play 的mapping函数要求的参数类型是Option[T]，二者不匹配，需要扩展FormHelper做类型适配，且必须通过元编程实现，避免手动转换。

元编程适配实现 #

借助 Scala 3 的编译时反射（Quotes）和 inline 方法，可在编译期自动判断样例类字段数量，对单元素样例类的unapply结果做类型转换，同时兼容多字段场景：

import scala.quoted.*
import play.api.data.{Form, mapping}
import play.api.data.Forms.text

object FormHelper {
  // 对外暴露的适配unapply方法
  inline def unapply[T](value: T): Option[Any] = ${ unapplyImpl[T]('value) }

  // 编译期实现逻辑
  private def unapplyImpl[T: Type](value: Expr[T])(using Quotes): Expr[Option[Any]] = {
    import quotes.reflect.*
    // 获取样例类的伴生对象及原生unapply方法
    val companion = TypeTree.of[T].symbol.companionModule
    val unapplyMethod = Select.unique(Ref(companion), "unapply")
    val rawResult = Expr.betaReduce(unapplyMethod.appliedTo(value))

    // 编译期获取样例类字段数量
    val fieldCount = TypeTree.of[T].symbol.caseFields.size

    if (fieldCount == 1) {
      // 单元素样例类：将Option[Tuple1[T]]转换为Option[T]
      '{
        $rawResult match {
          case Some(Tuple1(content)) => Some(content)
          case None => None
        }
      }
    } else {
      // 多元素样例类：直接返回原生unapply结果
      '{ $rawResult }
    }
  }

  // 封装Play表单映射的辅助方法（可根据字段类型扩展）
  inline def forCaseClass[T]: Form[T] = {
    // 示例：针对单String字段的样例类，可根据实际字段类型调整Forms的类型
    Form(mapping(
      "value" -> text
    )(companion.apply)(unapply))
  }
}

使用示例 #

定义单元素样例类后，直接使用FormHelper生成表单映射：

case class User(name: String)

// 生成符合Play要求的表单映射
val userForm: Form[User] = FormHelper.forCaseClass[User]

该实现会在编译期自动完成类型适配：

• 单元素样例类：自动将unapply返回的Option[Tuple1[T]]转换为Option[T]，匹配 Play mapping的参数要求
• 多元素样例类：完全沿用 Scala 3 原生unapply的行为，与 Scala 2 逻辑一致

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