Go的net.Listen默认不设SO_REUSEADDR等选项，故端口被占即报“address already in use”；需用net.ListenConfig.Control显式启用复用。
为什么 net.Listen 默认无法复用端口
Go 的 net.Listen 默认调用底层 socket() + bind()，但没设置 SO_REUSEADDR（Unix/Linux）或 SO_EXCLUSIVEADDRUSE（Windows）等 socket 选项，所以一旦端口被占用，就会直接返回 "address already in use" 错误。这不是 Go 特有行为，而是操作系统层面的默认策略：防止 TIME_WAIT 状态下的旧连接干扰新服务，或避免多个进程意外监听同一端口引发冲突。
真正需要端口复用的场景通常是：快速重启服务、多实例负载分发（如 SO_REUSEPORT）、或测试时频繁启停。注意：复用 ≠ 安全共存，必须确保逻辑上允许多个 listener 同时 accept 同一端口的连接。
用 net.ListenConfig 设置 Control 函数启用 SO_REUSEADDR
net.ListenConfig 允许你在 socket 创建后、bind() 前插入自定义控制逻辑，这是 Go 标准库中唯一推荐的、跨平台可控的端口复用方式。
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
- 在
Control回调里调用syscall.SetsockoptInt32或unix.SetsockoptInt32（取决于平台）设置SO_REUSEADDR - Linux 还支持
SO_REUSEPORT（需内核 3.9+），它比SO_REUSEADDR更进一步：允许多个独立进程绑定同一 IP:Port，并由内核做连接负载分发；而SO_REUSEADDR主要解决 TIME_WAIT 占用和 bind 冲突，不能用于多进程并发 accept - Windows 不支持
SO_REUSEPORT，且SO_REUSEADDR行为略有不同（例如不覆盖已绑定的非重用 socket）
示例（Linux/macOS）：
lc := net.ListenConfig{
Control: func(network, address string, c syscall.RawConn) error {
return c.Control(func(fd uintptr) {
syscall.SetsockoptInt32(int(fd), syscall.SOL_SOCKET, syscall.SO_REUSEADDR, 1)
// 若需 SO_REUSEPORT（仅 Linux）：
// unix.SetsockoptInt32(int(fd), unix.SOL_SOCKET, unix.SO_REUSEPORT, 1)
})
},
}
ln, err := lc.Listen(context.Background(), "tcp", ":8080")
使用 SO_REUSEPORT 时要注意内核和 Go 版本兼容性
SO_REUSEPORT 不是所有系统都开箱即用。它依赖：
– Linux 内核 ≥ 3.9（主流发行版基本满足）
– Go ≥ 1.11（net.ListenConfig.Control 引入）
– 编译时链接了 golang.org/x/sys/unix（用于 SO_REUSEPORT 常量和函数）
- 若忘记导入
golang.org/x/sys/unix，直接写unix.SO_REUSEPORT会编译失败 - 在 macOS 上，
SO_REUSEPORT存在但语义与 Linux 不同：它只允许父子进程间复用，且不提供连接级负载均衡 - 启用
SO_REUSEPORT后，多个 Go 进程（如用exec.Command启动的子进程）可同时Listen同一地址，内核自动将新连接分发到任一 listener，适合水平扩展 - 但要注意：HTTP/HTTPS server 的
Shutdown必须逐个调用，不能只关一个 —— 否则残留 listener 仍会收连接
别忽略 SO_LINGER 和连接关闭时的资源残留
端口复用本身不解决连接关闭后的资源滞留问题。如果 listener 崩溃或未优雅 shutdown，大量连接卡在 CLOSE_WAIT 或 TIME_WAIT，仍可能导致端口“看似被占”。
- 可在
Control中设置SO_LINGER控制 close 行为（慎用：设为 0 会强制 RST，破坏 TCP 可靠性） - 更稳妥的做法是：给
http.Server配置ReadTimeout/WriteTimeout，并在退出前调用srv.Shutdown() - 验证是否真复用成功？用
ss -tlnp | grep :8080（Linux）看是否有多个 PID 绑定同一端口；macOS 用lsof -i :8080
复用只是打开门，谁进门、怎么关门、门后怎么协作——这些得靠上层逻辑兜底。
