Scala 3 不同泛型类型的扩展方法重载报错问题问询

错误原因 #

该错误本质是JVM泛型擦除机制导致的：你定义的两个outcomeListAll扩展方法，擦除泛型参数后签名完全一致——均接收List类型入参、返回Either类型，因此被JVM识别为重复定义。

你提到的官方文档中的重载示例不存在该问题，是因为示例的扩展方法入参的原生类型本身就有差异（比如一个入参是String、另一个是Seq），擦除后签名不会冲突，和你的场景有本质区别。Scala 3的扩展方法最终会编译为普通静态方法，所以会受到JVM方法签名规则的约束。

解决方案 #

方案1：使用@targetName注解（推荐，迁移成本最低）

直接按照编译器提示，给其中一个冲突的方法添加@scala.annotation.targetName注解，指定编译后生成的底层方法名，即可解决擦除后的命名冲突，原有业务逻辑、调用方使用方式完全不需要修改：

import scala.annotation.targetName

type Outcome[+E <: Fail, A] = Either[E, A]

extension[A] (list: List[Outcome[ValidationFail, A]]) {
  def outcomeListAll: Outcome[ValidationFail, List[A]] = {
    val (left, right) = list.partitionOutcome
    if (left.isEmpty) Right(right)
    else Left(left.reduce(_ + _))
  }
}

extension[F <: Fail, A] (list: List[Outcome[F, A]])
  @deprecated
  @targetName("outcomeListAllGeneric") // 指定编译后的底层方法名，避免冲突
  def outcomeListAll: Outcome[Fail, List[A]] = {
    val (left, right) = partitionOutcome
    if (left.isEmpty) Right(right)
    else Left(Fail.generic(left.map(_.getMessage).mkString(", "), left.head))
  }
  def partitionOutcome: (List[F], List[A]) = {
    val left = list.collect { case Left(l) => l }
    val right = list.collect { case Right(r) => r }
    (left, right)
  }

方案2：合并实现用类型分支处理

如果不想依赖注解，可以将两个实现合并到通用扩展中，运行时判断错误类型走对应逻辑：

extension[F <: Fail, A] (list: List[Outcome[F, A]])
  def outcomeListAll: Outcome[Fail, List[A]] = {
    val (left, right) = partitionOutcome
    if (left.isEmpty) return Right(right)
    // 匹配ValidationFail的特殊场景
    if left.forall(_.isInstanceOf[ValidationFail]) then
      Left(left.asInstanceOf[List[ValidationFail]].reduce(_ + _))
    else
      Left(Fail.generic(left.map(_.getMessage).mkString(", "), left.head))
  }
  def partitionOutcome: (List[F], List[A]) = {
    // 原有实现不变
  }

如果需要保留ValidationFail版本的窄返回类型，可以结合Scala 3的匹配类型实现，复杂度更高，迁移场景下优先选择方案1即可。

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