“address already in use”错误本质是端口被其他进程占用，需先确认报错端口号（如8080），再用lsof -i :8080（Linux/macOS）或netstat -ano | findstr :8080（Windows）查PID，最后kill或taskkill终止进程。
Go服务启动报错“address already in use”怎么快速定位占用进程
错误本质是端口被占，不是代码写错了。先确认报错里具体端口，比如 listen tcp :8080: bind: address already in use，那目标就是 8080。
Linux/macOS 下直接运行：
lsof -i :8080
或
netstat -tulpn | grep :8080
Windows 下用：
netstat -ano | findstr :8080
- 输出中找
PID列，记下数字 - 再用
kill <PID>（Linux/macOS）或taskkill /F /PID <PID>（Windows）干掉它 - 如果
lsof未安装，macOS 可用brew install lsof，Ubuntu/Debian 用sudo apt install net-tools
为什么 kill 了进程，端口还是被占？TIME_WAIT 是真凶
不是没杀干净，是系统在“善后”。TCP 连接关闭后，主动关闭方会进入 TIME_WAIT 状态（默认约 2 分钟），防止旧包干扰新连接。此时端口不可 bind，但 lsof 可能已不显示对应进程。
这种场景常见于频繁重启的开发服务、HTTP 测试服务器、gost 隧道等。
- 临时解法：换一个端口启动，避开冲突期
- 根本解法：服务端代码加
SO_REUSEADDR（Go 中通过net.ListenTCP+SetReuseAddr(true)实现） - 测试场景更推荐用
httptest.NewUnstartedServer，避免真实监听
Go 代码里怎么安全复用本地端口（比如客户端固定用 54591）
客户端拨号时想复用特定本地端口（如 54591），不能只靠 net.Dial，它不暴露绑定控制权。
必须走两步：先显式 ListenTCP 绑定，再从 listener 拨出连接。
addr := &net.TCPAddr{Port: 54591}
ln, err := net.ListenTCP("tcp", addr)
if err != nil {
log.Fatal(err)
}
defer ln.Close()
ln.SetReuseAddr(true) // 关键
conn, err := ln.Dial("tcp", "example.com:80")
if err != nil {
log.Fatal(err)
}
// conn 可正常使用，ln 可关可不管
-
SetReuseAddr(true)允许立即重用处于TIME_WAIT的地址 - 不用
SetReusePort(true)，除非你要多个 Go 进程监听同一端口（需内核支持） - 注意：此法只适用于客户端主动连接；服务端监听仍用
http.ListenAndServe或net.Listen配置SO_REUSEADDR
Gunicorn / Dubbo / gost 启动也报这个错？和 Go 代码无关，但排查逻辑一致
这类错误和语言无关，全是操作系统级端口管理问题。Gunicorn 报 address already in use，Dubbo 报 Address already in use，gost 启动失败——背后都是同一个机制：端口正被另一个 socket 占着。
- 先统一用
lsof或netstat查 PID，别急着改配置 - Gunicorn 可加
--reuse-port（Linux 3.9+），让多个 worker 安全共享端口 - Dubbo 改
<dubbo:protocol port="20880">是绕开手段，不是根治 - gost 的
gost.yml里改port字段前，务必确认旧实例是否彻底退出（ps aux | grep gost）
真正容易被忽略的是：测试代码里用 http.ListenAndServe 启服务，测试一跑完就以为端口自动释放了——其实没有，它还在后台跑着。这种“幽灵监听”最耗时间排查。
