Scala中build.sbt设置fork:=true后自动终止进程PID的方案

我在IntelliJ IDEA中使用Scalapy将Python代码集成到Scala项目，build.sbt配置如下：

import ai.kien.python.Python

lazy val root = (project in file("."))
  .settings(
    name := "my-project"
  )

ThisBuild / version := "0.1.0-SNAPSHOT"

version in Docker:= "0.0.3"
dockerExposedPorts:= Seq(8083)

fork:= true

lazy val python = Python("/usr/bin/python3")

lazy val javaOpts = python.scalapyProperties.get.map {
  case (k, v) => s"""-$k=$v"""
}.toSeq

javaOptions ++= javaOpts

libraryDependencies ++= Seq(
  "me.shadaj" %% "scalapy-core" % "0.5.2"
)

根据Scalapy文档要求必须设置fork:=true，但每次运行主类时会创建新的子进程（比如启动占用8083端口的Akka HTTP服务），即使关闭程序或IDEA，再次运行时仍会提示端口被占用。目前只能通过终端命令手动清理：

# 查看进程
pgrep -a java
# 杀死进程
kill -9 {pid}

需要实现主类运行完成后自动终止fork出的进程。

解决方案 #

1. 在Scala主类中添加关闭钩子 #

在主类代码里加入JVM关闭钩子，确保程序收到终止信号时执行资源清理，比如关闭Akka服务、终止关联的Python进程：

object Main extends App {
  // 初始化业务资源，比如Akka系统
  val akkaSystem = akka.actor.ActorSystem("MySystem")
  
  // 注册关闭钩子
  sys.addShutdownHook {
    println("Cleaning up running processes...")
    // 终止Akka系统
    akkaSystem.terminate()
    // 若有Python相关进程，可在此添加终止逻辑
  }
  
  // 业务逻辑代码
}

这个钩子会在JVM收到终止信号（如IDEA停止按钮、Ctrl+C）时触发，保证子进程被正常关闭。

2. 缩小SBT的fork范围 #

不要设置全局fork:=true，仅在run任务中启用fork，让SBT更精准地管理进程生命周期：

// 替换全局fork配置为以下内容
fork in run := true

这样只有运行主类时才会创建fork进程，SBT在run任务结束后会自动尝试终止该子进程。

3. 调整IntelliJ IDEA运行配置 #

在IDEA的Run/Debug Configurations中：

• 选中你的Scala应用配置
• 切换到SBT标签页，勾选**"Terminate forked process after exit"**（若存在该选项）
• 停止程序时选择**"Terminate Process"**而非"Stop"，确保发送正确的终止信号给fork进程

4. 使用SBT命令行运行程序 #

通过SBT命令行执行run启动程序，退出时按Ctrl+C或Ctrl+D，SBT会自动终止fork出的子进程，比IDEA界面操作的可靠性更高。

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