如何在IntelliJ中调试Scala 3的Scalatest测试？

问题汇总 #

我有一个基于Scala 3的SBT项目，使用Scalatest编写测试，在IntelliJ中尝试以调试模式运行测试时遇到以下问题：

• 设置Scalatest运行配置（含基于SBT的方式）时抛出异常：

  java.lang.NoClassDefFoundError: org/scalatest/tools/Runner
      at org.jetbrains.plugins.scala.testingSupport.scalaTest.ScalaTestRunner.runScalaTest2or3(ScalaTestRunner.java:43)
      at org.jetbrains.plugins.scala.testingSupport.scalaTest.ScalaTestRunner.main(ScalaTestRunner.java:26)
  Caused by: java.lang.ClassNotFoundException: org.scalatest.tools.Runner
      at java.base/jdk.internal.loader.BuiltinClassLoader.loadClass(BuiltinClassLoader.java:581)
      at java.base/jdk.internal.loader.ClassLoaders$AppClassLoader.loadClass(ClassLoaders.java:178)
      at java.base/java.lang.ClassLoader.loadClass(ClassLoader.java:522)
      ... 2 more
  

• 独立终端启动SBT调试会话，通过Remote JVM Debug连接后，测试可运行但断点不生效；
• 使用IntelliJ自带的SBT Shell启动会话并连接，结果同上述情况，断点无反应；
• 设置SBT Task配置，命令设为~testOnly，构建项目时直接卡住。

项目包含多个ScalaJS Lambda，以下是针对这些问题的可行解决经验：

问题1：NoClassDefFoundError: org/scalatest/tools/Runner #

• 确认build.sbt中Scalatest依赖的作用域与完整性：Scala 3环境下需确保依赖包含scalatest-runner模块，且作用域为Test：

  libraryDependencies += "org.scalatest" %% "scalatest" % "3.2.15" % Test
  libraryDependencies += "org.scalatest" %% "scalatest-runner" % "3.2.15" % Test
  

• 刷新SBT项目：在IntelliJ右侧SBT面板点击刷新按钮，或执行sbt reload，确保依赖下载完整；
• 更新IntelliJ Scala插件：使用支持Scala 3的最新稳定版插件，旧版本对Scala 3测试支持存在兼容性bug。

问题2&3：Remote JVM Debug连接后断点不生效 #

• 强制测试进程不fork：在build.sbt中添加配置，避免测试启动子进程（调试器仅连接主SBT进程，子进程无法继承调试端口）：

  Test / fork := false
  

• 启动带调试参数的SBT会话：在终端执行以下命令，确保测试代码在调试模式下编译运行：

  sbt -J-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=5005 testOnly
  

• 配置IntelliJ Remote Debug：创建Remote JVM Debug配置，端口设为5005，连接后触发测试（若需等待调试连接再启动测试，可将suspend=n改为suspend=y）；
• 注意ScalaJS测试差异：ScalaJS端测试编译为JS运行，无法用JVM调试，需使用Chrome DevTools或Node.js调试工具，仅JVM端测试适用上述方法。

问题4：~testOnly构建卡住 #

• 清理编译缓存：执行sbt clean后重新运行~testOnly，排除缓存冲突；
• 排查ScalaJS依赖问题：检查项目中ScalaJS Lambda是否存在循环依赖，或编译时占用大量资源，可先单独测试JVM端测试，逐步引入ScalaJS模块定位问题；
• 增大SBT内存：在IntelliJ的Preferences > Build, Execution, Deployment > Build Tools > SBT中，调整JVM堆内存参数（如-Xmx4g），避免内存不足导致卡住。

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