ScalaJS+Scala3编译报错：引用不存在的MainNode类

可能原因 #

• ScalaJS插件版本与Scala3不兼容：未明确指定ScalaJS插件版本时，sbt默认版本可能无法适配Scala 3.3.5。
• 代码/依赖引用JVM特有类：scala.collection.concurrent.MainNode是JVM平台ConcurrentLinkedQueue的内部实现类，ScalaJS标准库中不存在该类，若代码或依赖库间接引用了它就会报错。
• 覆盖率工具兼容性问题：sbt-scoverage与当前ScalaJS/Scala3版本不匹配，也可能触发此类IR引用错误。

解决方案 #

1. 明确指定兼容的ScalaJS插件版本 #

在project/plugins.sbt中添加（或修改）ScalaJS插件版本，确保与Scala 3.3.5兼容（推荐使用ScalaJS 1.14.0及以上版本）：

addSbtPlugin("org.scala-js" % "sbt-scalajs" % "1.15.0")

2. 排查并替换JVM特有集合类 #

检查项目代码中是否直接使用了scala.collection.concurrent包下的类（比如ConcurrentLinkedQueue），替换为ScalaJS支持的集合类：

• 若不需要并发特性，改用scala.collection.mutable.Queue
• 若需要前端并发场景，使用ScalaJS适配的并发工具或原生JS的并发API

3. 调整覆盖率工具配置（若启用了coverage） #

如果是覆盖率工具导致的IR检查错误，尝试：

• 升级sbt-scoverage到兼容Scala3的版本（推荐2.0.10及以上），在project/plugins.sbt中添加：

  addSbtPlugin("org.scoverage" % "sbt-scoverage" % "2.0.12")
  

• 临时关闭覆盖率验证，注释掉coverageEnabled := true，先确保构建正常，再逐步排查覆盖率相关问题

4. 升级依赖库版本 #

检查laminar等依赖是否适配当前ScalaJS和Scala3版本，尝试升级到最新兼容版本：

"com.raquo" %%% "laminar" % "18.0.0" // 最新稳定版，适配Scala3和ScalaJS

5. 清理并重新构建 #

执行以下命令清理缓存并重新构建，排除缓存导致的问题：

sbt clean fullLinkJS
npm run dev

内容的提问来源于stack exchange，提问作者Ghignatti Nicolò