本文介绍一种轻量、可靠且跨平台的方案：通过前端心跳机制（heartbeat）检测浏览器关闭事件，并触发 go 后端服务器优雅退出，避免手动终止进程。
本文介绍一种轻量、可靠且跨平台的方案：通过前端心跳机制（heartbeat）检测浏览器关闭事件，并触发 go 后端服务器优雅退出，避免手动终止进程。
在开发本地 Go Web 应用（如原型演示、CLI 工具内嵌服务）时，常希望“浏览器窗口一关，服务即停”——这不仅能提升开发体验，还能防止后台残留进程占用端口。但需明确：HTTP 协议本身无连接状态感知能力，浏览器关闭窗口不会主动通知服务器；因此不能依赖 TCP 连接断开（因连接可能复用、延迟关闭或被代理拦截），而应采用应用层主动探测机制。
✅ 推荐方案：前端心跳 + 后端超时退出
核心思路是让浏览器定期向服务器发送轻量 HTTP 请求（如 /api/heartbeat），服务器记录每个客户端最后活跃时间；若超过阈值（如 5 秒）未收到心跳，则判定该会话已终止，进而安全关闭服务器。
示例实现
1. Go 后端（main.go）
package main
import (
"fmt"
"log"
"net/http"
"sync"
"time"
)
var (
lastHeartbeatMu sync.RWMutex
lastHeartbeat = time.Now()
heartbeatTimeout = 5 * time.Second
server *http.Server
)
func heartbeatHandler(w http.ResponseWriter, r *http.Request) {
lastHeartbeatMu.Lock()
lastHeartbeat = time.Now()
lastHeartbeatMu.Unlock()
w.WriteHeader(http.StatusOK)
}
func startServer() {
http.HandleFunc("/api/heartbeat", heartbeatHandler)
http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
fmt.Fprint(w, `
<!DOCTYPE html>
<html>
<head><title>Go Server Demo</title></head>
<body>
<h2>Server is running — close this tab to shut it down.</h2>
<script>
// 发送心跳，每 2 秒一次
const heartbeat = () => fetch('/api/heartbeat', { method: 'POST' });
const interval = setInterval(heartbeat, 2000);
// 页面卸载前尝试最后一次心跳（非阻塞，尽力而为）
window.addEventListener('beforeunload', () => {
fetch('/api/heartbeat', { method: 'POST' }).catch(() => {});
});
</script>
</body>
</html>
`)
})
server = &http.Server{Addr: ":8080"}
log.Println("Starting server on :8080...")
go func() {
if err := server.ListenAndServe(); err != nil && err != http.ErrServerClosed {
log.Fatal(err)
}
}()
// 后台监控心跳超时
go func() {
ticker := time.NewTicker(1 * time.Second)
defer ticker.Stop()
for range ticker.C {
lastHeartbeatMu.RLock()
elapsed := time.Since(lastHeartbeat)
lastHeartbeatMu.RUnlock()
if elapsed > heartbeatTimeout {
log.Println("No heartbeat received — shutting down server...")
if err := server.Shutdown(nil); err != nil {
log.Printf("Shutdown error: %v", err)
}
return
}
}
}()
}
func main() {
startServer()
select {} // keep main goroutine alive
}2. 关键说明与注意事项
- 心跳间隔 vs 超时阈值：示例中设心跳周期为 2s，超时为 5s，确保网络抖动不影响判断。生产环境可调至 15s/30s 以降低开销。
- beforeunload 的局限性：该事件在页面刷新、导航、关闭时触发，但无法保证请求一定发出（如用户强制 kill 浏览器）。因此它仅作辅助，不可替代超时检测。
- 并发安全：使用 sync.RWMutex 保护共享变量 lastHeartbeat，避免竞态。
- 优雅关闭：server.Shutdown() 会等待活跃请求完成后再退出，比 os.Exit() 更安全。
- 多标签兼容性：当前方案按“单会话”设计（即任一标签存活即维持服务）。如需支持多标签协同，可扩展为基于 session ID 的 Map 管理，但对本地开发场景通常不必要。
总结
该方案无需 WebSocket、长连接或外部依赖，仅用标准 HTTP 和少量 JavaScript，即可实现浏览器关闭 → 服务自动退出的闭环。它简洁、可靠、易调试，特别适合 CLI 工具、本地预览服务等场景。记住：永远以服务端超时为主判据，前端钩子仅为优化体验的补充手段。
