Go标准库不支持直接开启SO_REUSEPORT，必须用net.ListenConfig.Control手动设置unix.SO_REUSEADDR和unix.SO_REUSEPORT选项，并传入自定义listener给http.Server.Serve，而不能使用r.Run()。
Go 标准库不支持直接开启 SO_REUSEPORT
你不能靠 r.Run(":8080") 或 http.ListenAndServe 启用多进程共享端口。Gin 本身只是封装了 net/http.Server，而标准库的 net.Listen 默认不设 SO_REUSEPORT。直接起多个 Gin 进程监听同一端口，第二个进程会报错：listen tcp :8080: bind: address already in use。
真正要实现“多个 Go 进程同时 listen :8080”，必须绕过标准库默认行为，用 net.ListenConfig + Control 回调手动设置 socket 选项。
-
SO_REUSEADDR是基础——让进程重启时不卡在TIME_WAIT，但不解决多进程共用问题 -
SO_REUSEPORT才是关键——Linux 3.9+ 内核支持，允许多个进程各自bind同一地址，内核负责连接分发 - Windows/macOS 对
SO_REUSEPORT语义不同（macOS 仅限 UDP，Windows 不支持），生产环境建议只在 Linux 部署
用 ListenConfig.Control 设置 SO_REUSEPORT
核心是构造一个 net.ListenConfig，并在 Control 函数里调用 unix.SetsockoptInt 开启复用。别用已废弃的 syscall 包，用 golang.org/x/sys/unix。
示例片段（只保留关键逻辑）：
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
立即学习“go语言免费学习笔记（深入）”；
lc := net.ListenConfig{
Control: func(network, addr string, c syscall.RawConn) error {
return c.Control(func(fd uintptr) {
unix.SetsockoptInt(fd, unix.SOL_SOCKET, unix.SO_REUSEADDR, 1)
unix.SetsockoptInt(fd, unix.SOL_SOCKET, unix.SO_REUSEPORT, 1)
})
},
}
ln, err := lc.Listen(context.Background(), "tcp", ":8080")
if err != nil {
log.Fatal(err)
}
srv := &http.Server{Handler: r}
srv.Serve(ln)
- 必须在
bind前调用SetsockoptInt，Control正好满足这个时机 - 顺序无关紧要，但
SO_REUSEADDR和SO_REUSEPORT建议都设，兼顾兼容性和功能 - 如果漏掉
SO_REUSEADDR，某些内核版本下SO_REUSEPORT可能被忽略
Gin 启动时替换默认 listener
r.Run() 内部会自己调用 http.ListenAndServe，没法插入手动配置的 listener。所以不能用 r.Run()，得自己构造 http.Server 并传入自定义 listener。
- 调用
r.Engine.Handler()获取底层 handler，而不是直接传r - 不要用
r.Run(":8080")，它会屏蔽 listener 控制权 - 确保
http.Server的Addr字段为空字符串（""），否则Serve会尝试自己Listen - 优雅关闭需额外处理：
srv.Shutdown()要配合信号监听，否则ln.Close()可能中断正在 accept 的连接
多进程部署时的常见陷阱
即使 socket 层配置正确，多进程 Gin 服务仍容易因共享资源出问题。这不是端口复用本身的问题，而是业务层没隔离好。
- 全局变量（如未配连接池的
*sql.DB）会被所有进程共享，但实际每个进程应有自己的连接池实例 - 日志写同一个文件？没加文件锁会导致内容错乱，建议按进程 PID 分日志文件
- 使用本地缓存（如
map）时，各进程数据不互通，不能当成“分布式缓存”用 - 依赖本地状态的服务（如计数器、临时上传目录）必须做进程间同步，或改用 Redis 等外部存储
SO_REUSEPORT 解决的是连接接入层的并发瓶颈，不是业务逻辑的并发安全问题。进程间内存依然隔离，该加锁加锁，该分片分片。
