Go net.ListenConfig 怎样设置 socket 选项

如果 net.Listen 没有直接暴露你需要的 socket 选项，可以把监听改成 net.ListenConfig，在 Control 回调里处理底层文件描述符。这个回调发生在 socket 已创建、但还没有绑定本地地址之前，正好适合设置监听前选项。

本文用 Linux TCP 的 SO_REUSEADDR 说明最小写法。它不是一份所有系统都能直接编译的通用实现：syscall 常量和选项语义属于平台边界，Windows、BSD 或其他系统应换成对应平台的 API。

核心做法：把选项写进 ListenConfig.Control，通过 RawConn.Control 取得 fd，设置成功后再让 ListenConfig.Listen 完成绑定。

Control 回调为什么能设置监听 socket

ListenConfig.Listen 负责创建监听器；当 Control 非空时，Go 会在创建网络连接后、绑定到操作系统前调用它。此时 socket 还没有被绑定到目标地址，设置选项的时机不会落到 bind 之后。

回调收到的 network 和 address 不一定与传入 Listen 的字符串完全一致。比如传入 tcp 后，实际回调可能收到 tcp4 或 tcp6；因此代码不要把网络名写死成一个值，更不要把它误解成地址解析已经完成的结果。

用 RawConn.Control 设置选项并传递错误

下面的示例只针对 Linux/Unix 风格的 syscall API。RawConn.Control 会把底层 fd 交给回调；由于这个内部回调没有返回 error，示例用 controlErr 把 SetsockoptInt 的错误带回外层。

package main

import (
    "context"
    "fmt"
    "net"
    "syscall"
)

func listenWithReuse(addr string) (net.Listener, error) {
    lc := net.ListenConfig{
        Control: func(network, address string, raw syscall.RawConn) error {
            var controlErr error
            // RawConn.Control 在 socket 尚未 bind 时提供底层文件描述符。
            err := raw.Control(func(fd uintptr) {
                // 这里的常量和语义依赖 Unix 平台，跨平台实现应替换这一段。
                controlErr = syscall.SetsockoptInt(
                    int(fd), syscall.SOL_SOCKET, syscall.SO_REUSEADDR, 1,
                )
            })
            if err != nil {
                // fd 控制失败时，直接阻止后续监听，避免带着未知状态继续。
                return err
            }
            return controlErr
        },
    }

    // ctx 只参与监听地址解析，不负责 Listener 的生命周期。
    return lc.Listen(context.Background(), "tcp", addr)
}

func main() {
    ln, err := listenWithReuse(":8080")
    if err != nil {
        panic(fmt.Errorf("listen: %w", err))
    }
    // Listener 使用完成后必须关闭，释放监听 socket。
    defer ln.Close()
}

代码中有两层错误需要保留：第一层是 raw.Control 自身失败，第二层是设置选项失败。任一错误都应返回给 Listen，这样调用方不会把“选项没有设置成功但监听已经启动”误认为成功。

tcp4、tcp6 与平台 syscall 的边界

这个接口把 Go 的监听抽象和平台 socket API 接在一起，但不会替你抹平平台差异。SO_REUSEADDR 在不同系统上的重用规则并不完全相同；SO_REUSEPORT 等选项也不能只凭名字就推断出相同效果。

工程上可以把平台相关设置收拢到单独文件：Linux/Unix 文件负责调用对应的 syscall 或 golang.org/x/sys/unix，Windows 文件使用 Windows 的 socket 常量和调用方式；公共代码只负责创建 ListenConfig 和处理返回错误。

如果代码只服务 Linux，可以在文档中明确目标系统，并为平台文件加构建约束；如果代码要发布给多种系统，则不要把 syscall.SOL_SOCKET、SO_REUSEADDR 或某个 fd 转换方式放进无条件编译的公共文件。

创建监听器后，检查什么才算配置完成

最小检查顺序是：先确认 Control 返回错误，随后确认 Listen 返回的 Listener 非空，最后在服务退出路径调用 Close。不要把 context.Context 当成 Listener 的取消开关；官方文档说明它只用于解析监听地址，返回后的 Listener 不受该上下文过期影响。

常见问题

为什么不用 net.Listen 直接设置？

net.Listen 使用默认配置，适合不需要底层选项的场景；要注入监听前回调时才换成 ListenConfig。

Control 里能不能在 bind 之后再改选项？

不要依赖这种做法。Control 的契约是创建 socket 后、绑定前调用；绑定后的调整应使用对应连接或监听器 API，并重新确认平台语义。

记住这条边界即可：ListenConfig.Control 是监听前的底层入口，RawConn.Control 负责拿到 fd，真正的 socket 选项由目标操作系统决定。