本文介绍在 go 中安全、可靠地实现进程超时控制的方法，重点解决主进程被杀后子进程（尤其是多级子进程）残留的问题，通过设置进程组并发送信号实现整棵树的清理。
本文介绍在 go 中安全、可靠地实现进程超时控制的方法，重点解决主进程被杀后子进程（尤其是多级子进程）残留的问题，通过设置进程组并发送信号实现整棵树的清理。
在 Go 中使用 os/exec 启动外部命令时，若仅调用 cmd.Process.Kill()，默认只会终止直接创建的父进程，而其派生的子进程（如 shell 启动的管道、后台任务、递归 fork 的守护进程等）将脱离原进程树，成为孤儿进程并继续运行——这极易导致资源泄漏、端口占用或重复执行等严重问题。
根本解法是利用 Unix/Linux 的进程组（Process Group）机制：将主进程及其所有后代统一纳入同一个进程组，再向该组发送信号（如 SIGTERM 或 SIGKILL），从而实现“一键清退”。
✅ 正确做法：启用进程组 + 组信号终止
关键在于启动前配置 SysProcAttr，启用 Setpgid: true：
cmd := exec.Command("sh", "-c", "sleep 2 && echo 'done' & sleep 10")
// ⚠️ 必须设置：使 cmd.Process 成为新进程组的 leader
cmd.SysProcAttr = &syscall.SysProcAttr{
Setpgid: true, // 创建新进程组，且本进程为 PGID
}随后，在超时逻辑中获取该进程组 ID（PGID），并以负值形式传递给 syscall.Kill —— 这是 POSIX 规定：Kill(-pgid, sig) 表示向整个进程组发送信号：
if err := cmd.Start(); err != nil {
return fmt.Errorf("failed to start: %w", err)
}
done := make(chan error, 1)
go func() { done <- cmd.Wait() }()
select {
case err := <-done:
return err // 正常结束
case <-time.After(3 * time.Second):
// 获取进程组 ID（注意：必须在 cmd.Process.Pid 已存在后调用）
pgid, err := syscall.Getpgid(cmd.Process.Pid)
if err != nil {
return fmt.Errorf("failed to get pgid: %w", err)
}
// 向整个进程组发送 SIGTERM（优雅终止）
if err := syscall.Kill(-pgid, syscall.SIGTERM); err != nil {
return fmt.Errorf("failed to kill process group: %w", err)
}
// 可选：等待几秒后强制 SIGKILL（防止僵死）
select {
case <-time.After(1 * time.Second):
syscall.Kill(-pgid, syscall.SIGKILL) // 强制清理
case <-done:
// 已自然退出，无需再杀
}
return fmt.Errorf("command timed out after 3s")
}⚠️ 注意事项与最佳实践
- Setpgid: true 是前提：若不设置，Getpgid() 返回的是父 shell 的 PGID，Kill(-pgid, ...) 将误杀无关进程。
- cmd.Process.Pid 必须已初始化：cmd.Start() 成功后才可安全调用 Getpgid；否则会 panic 或返回错误。
- 使用带缓冲的 channel：如 make(chan error, 1)，避免 goroutine 在 cmd.Wait() 完成后因无人接收而泄漏。
- 优先 SIGTERM，再 SIGKILL：给予子进程清理资源的机会（如关闭文件、释放锁），提升健壮性。
- Windows 兼容性说明：syscall.SysProcAttr.Setpgid 和 syscall.Kill 在 Windows 上不可用；如需跨平台，应使用 cmd.Process.Signal(os.Interrupt) 或第三方库（如 golang.org/x/sys/windows）配合作业对象（Job Object），但语义不完全等价。
✅ 总结
Go 中实现“超时并彻底终止进程树”的核心路径是：
启用进程组 → 启动命令 → 超时后获取 PGID → 向负 PGID 发送终止信号。
这一模式简洁、高效、符合 POSIX 标准，是生产环境中管理外部命令生命周期的推荐实践。务必避免仅依赖 cmd.Process.Kill()，它无法保证子进程收敛。
