Go中Unix domain socket需用net.ListenUnix和net.DialUnix,注意路径权限、socket文件存在性及net.UnixAddr类型;stream模式默认支持,packet需ListenUnixgram;SetDeadline跨平台不可靠,应改用context超时;残留socket文件需os.Remove+重试;systemd激活需通过LISTEN_FDS接管fd。

Unix domain socket 的 net.ListenUnix 和 net.DialUnix 怎么用
Go 标准库对 Unix domain socket 的支持是直接的,但接口比 TCP 更“裸”,需要手动处理路径、权限和连接类型。关键不是能不能用,而是路径是否可写、socket 文件是否存在、以及是否用了正确的 net.UnixAddr 类型。
常见错误现象:dial unix /tmp/mysock: connect: no such file or directory —— 多半是服务端没启动,或客户端连的是一个还没被 Listen 创建出来的路径;connect: permission denied —— 路径所在目录不可写,或 socket 文件已有但权限不对(比如被 root 创建,普通用户进程去连)。
- 服务端必须先调用
net.ListenUnix("unix", &net.UnixAddr{Net: "unix", Name: "/tmp/mysock"}),路径父目录得存在且当前用户有写权限 - 客户端用
net.DialUnix("unix", nil, &net.UnixAddr{Net: "unix", Name: "/tmp/mysock"}),第二个参数传nil表示不绑定本地地址 - Unix socket 分
stream(类似 TCP)和packet(类似 UDP),Go 默认只支持stream;若需packet,得用net.ListenUnixgram+net.DialUnixgram,且注意它不保证顺序、不重传
为什么 net.UnixConn.SetDeadline 在某些系统上无效
Unix domain socket 的 deadline 控制依赖底层 poll 或 epoll 对 AF_UNIX 的支持。Linux 从 2.6.27 开始支持,但 macOS 和旧版 FreeBSD 对 SO_RCVTIMEO/SO_SNDTIMEO 的实现不一致,Go 运行时在这些平台会静默降级为无 timeout 的阻塞操作。
使用场景:你写了带 SetReadDeadline 的代码,在 Linux 上正常超时,在 macOS 上却卡死 —— 这不是 bug,是平台限制。
立即学习“go语言免费学习笔记(深入)”;
- 跨平台程序别依赖
SetDeadline做可靠超时,改用context.WithTimeout包裹Read/Write调用(配合UnixConn的非阻塞模式或 goroutine + channel) -
net.ListenUnix返回的*net.UnixListener不支持SetDeadline,只能对 accept 后的*net.UnixConn设置 - 如果真要精确控制,可在
DialUnix后立刻设SetReadDeadline(time.Now().Add(5 * time.Second)),但得在每次读前重设
os.Remove 删除 socket 文件失败,导致下次 Listen 报 address already in use
Unix socket 是文件系统中的一个特殊节点,服务端退出后不会自动清理。如果进程崩溃或未显式 Close listener,socket 文件残留,下次启动就会因地址冲突失败 —— 这和 TCP 的 TIME_WAIT 不同,是实打实的文件存在。
容易踩的坑:有人在 main 开头加 os.Remove("/tmp/mysock"),但没检查错误,或删完立刻 Listen,结果因文件系统延迟仍报错。
- 删之前先
os.Stat确认文件存在且是 socket 类型(fi.Mode()&os.ModeSocket != 0) - 删完后加短延时(
time.Sleep(10 * time.Millisecond))再Listen,尤其在 CI 或容器环境里更稳妥 - 更健壮的做法:用
net.ListenUnix的返回 error 判断是否为syscall.EADDRINUSE,再尝试删除并重试一次
如何让 Go 的 Unix socket 服务支持 systemd socket activation
systemd 可以预创建 socket 并监听,等第一个请求到达时才拉起你的 Go 进程。Go 本身不内置支持,但可通过 systemd 的 LISTEN_FDS 环境变量 + net.FileListener 接入。
性能影响:避免了冷启动延迟,适合低频但要求快速响应的本地服务(如 CLI 工具的守护进程);但要注意 fd 继承后,Go 进程必须用 os.NewFile 包装,且不能用标准 net.Listen。
- 在
.socket单元里配ListenStream=/run/myapp.sock,.service里加ExecStart=/path/to/your/app,并确保Accept=false - Go 代码中读
os.Getenv("LISTEN_FDS"),若为"1",则用os.NewFile(3, "listenfd")(fd 从 3 开始)转成*os.File,再用net.FileListener包装 - 不要忘记在
main开头调用os.Setenv("LISTEN_PID", strconv.Itoa(os.Getpid()))和os.Setenv("LISTEN_FDS", "1"),否则 systemd 不认为你已接管
复杂点在于,一旦用了 socket activation,你就不能再自己 Listen,所有连接都来自 systemd 预置的 fd;路径权限、SELinux 上下文、AppArmor 规则也得同步适配,否则启动就失败。










