Scala 3项目中sbt runMain报错找不到主方法的排查求助

1. 核对main方法签名是否符合Java规范 #

sbt的runMain依赖Java标准的main方法入口，要求：

• 方法为静态（Scala 3中顶级方法或@main注解会自动生成符合规范的静态方法，自定义main需手动保证）
• 参数类型必须是Array[String]，而非Scala的List[String]
• 返回值为Unit
• 方法名严格为main且可见性为public

你能在控制台调用CallMe.main(List())，大概率是因为源码里的main方法参数用了List[String]，导致sbt找不到符合规范的入口。示例对比：

// 不符合规范（runMain无法识别）
def main(args: List[String]): Unit = { /* ... */ }

// 符合规范（runMain可识别）
def main(args: Array[String]): Unit = { /* ... */ }

// 推荐：Scala 3 @main注解方式
@main def CallMe(args: String*): Unit = { /* ... */ }

2. 检查@main注解的调用路径是否正确 #

如果用了Scala 3的@main注解，runMain的目标是注解标注的方法名，而非类名。比如：

package com.example.projects.data

object CallMe {
  @main def start(args: String*): Unit = { /* ... */ }
}

此时需执行sbt "runMain com.example.projects.data.start"，而非com.example.projects.data.CallMe；只有当@main直接标注在与类同名的无参方法上时，才能用类名作为runMain目标。

3. 清理编译缓存后重新编译 #

旧字节码残留可能导致识别异常，执行以下命令重置编译状态：

sbt clean compile

完成后再尝试runMain命令。

4. 检查SBT配置变更 #

查看build.sbt及project/目录下的配置文件，确认是否修改过scalaVersion、mainClass设置，或添加了混淆、自定义编译任务等插件——这些变更可能篡改或隐藏main方法。

5. 查看编译后字节码确认main方法存在 #

进入编译输出目录，用javap命令验证字节码：

cd target/scala-3.1.2/classes
javap com.example.projects.data.CallMe

若输出中无public static void main(java.lang.String[])方法，说明编译产物不符合runMain要求，需调整源码。

6. 排查类/包冲突 #

确认项目中不存在其他同名的com.example.projects.data.CallMe类，或不同模块的类覆盖了目标类。可检查target目录下的class文件路径，确认编译的是预期源码。

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