Go原生用net.ListenUnix做高并发UDS服务，核心瓶颈在内核队列、路径管理、读写边界和连接生命周期；启动前须转绝对路径、清理旧文件、验证父目录可写。
go 原生用 net.listenunix 做高并发 unix 域套接字（uds）服务，不是加个 go handle(conn) 就能扛住万级连接——核心瓶颈不在 go 调度，而在内核队列、路径管理、读写边界和连接生命周期这四块。不提前掐掉隐患，accept 阻塞、connect: connection refused、粘包、socket 文件残留会轮番出现。
net.ListenUnix 启动前必须做的三件事
服务端启动失败，90% 是卡在监听前的环境准备上，错误如 bind: invalid argument 或 permission denied 其实都在报路径问题，不是代码写错了。
- 用
filepath.Abs(sockPath)强制转绝对路径，net.Listen("unix", "./sock")必挂，Go 不做相对路径补全 - 路径长度 ≤108 字节（Linux 限制），超长直接
EINVAL；避免空格、控制符、非 ASCII 字符；建议只用a-z、0-9、_、-、. - 启动前执行
os.RemoveAll(sockPath)，否则旧 socket 文件残留导致address already in use（本质是文件已存在）；再检查父目录是否存在且可写：os.Stat(filepath.Dir(sockPath))+ 尝试写一个临时文件验证
accept 阻塞或 connection refused 怎么破
客户端报 connect: connection refused，不是服务端没跑，而是内核全连接队列（complete queue）满了——accept() 太慢，新连接被丢弃。这不是 Go 的 bug，是 AF_UNIX 在 Linux 下也严格遵循 TCP-like 连接模型。
- 务必为每个
conn启动独立 goroutine 处理，别在Accept循环里同步Read；否则一个慢连接就堵死整个监听器 -
net.ListenUnix的backlog参数由内核决定（Linux 默认 128），不能靠调大解决根本问题；重点是让handleConnection尽快返回，避免 goroutine 积压 - 若需更高吞吐，考虑用
epoll手动管理 fd（通过syscall.EpollCreate1等），但绝大多数场景下，合理 goroutine 分发 +SetDeadline或context.WithTimeout更稳妥
流式通信粘包和 bufio.Writer 不发数据
UDS SOCK_STREAM 和 TCP 一样无消息边界，conn.Read([]byte) 可能只读到半个消息；而 bufio.Writer 默认缓冲，不 Flush() 就等于没发。
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
- 别依赖
conn.Write([]byte)一次性发完——它可能只写部分，得用io.WriteString或配合io.Copy+bytes.Buffer - 用
binary.Write(w, binary.BigEndian, uint32(len(payload)))写 4 字节头，接收方先io.ReadFull(conn, header[:4])再按长度读正文 -
bufio.NewWriter(conn)后，每次写完必须显式w.Flush()；漏掉这句，客户端永远等不到响应（PHP 客户端挂起就是这个原因）
关闭后 socket 文件残留与跨平台 deadline 失效
服务端 listener.Close() 不删 socket 文件，下次启动必报错；SetReadDeadline 在 macOS 或旧 FreeBSD 上静默失效，不是你代码有问题。
立即学习“go语言免费学习笔记（深入）”；
-
listener.Close()后立刻os.Remove(sockPath)，加重试逻辑（最多 3 次，间隔 10ms），防止内核延迟释放 - 别对
*net.UnixListener调SetDeadline——它不支持；只能对*net.UnixConn（即Accept()返回的连接）设，且每次Read/Write前都得重设 - 跨平台超时必须用
context.WithTimeout包裹conn.Read或conn.Write，配合runtime.LockOSThread()+ 非阻塞模式更可靠，但多数服务用context已足够
真正难的不是写通连接，而是让每个 socket 文件准时消失、每条消息不粘不丢、每个 goroutine 不堆积、每次超时都可控——这些细节不手工验证，上线后只会以“偶发连接失败”“响应变慢”“磁盘 inode 耗尽”等形式反扑。
