UnixDomainSocketAddress 仅支持 Linux/macOS 的 Unix 域套接字，需配合 StandardProtocolFamily.UNIX 和 SocketChannel/ServerSocketChannel 使用，Windows 默认不支持，且路径须为绝对路径并具备读写权限。
Java 16 的 UnixDomainSocketAddress 不是“跨平台替代 localhost”的万能方案，它只在支持 Unix 域套接字（UDS）的操作系统上可用，且必须配合 StandardProtocolFamily.UNIX 和 SocketChannel 或 ServerSocketChannel 使用——否则会抛 UnsupportedOperationException。
为什么 new UnixDomainSocketAddress("/tmp/my.sock") 一运行就报错？
常见错误现象：java.lang.UnsupportedOperationException: unix domain socket address 或 java.nio.channels.UnsupportedAddressTypeException。
根本原因不是路径写错了，而是你用错了通道类型。这个类只被 SocketChannel.open(StandardProtocolFamily.UNIX) 和 ServerSocketChannel.open(StandardProtocolFamily.UNIX) 识别；用 SocketChannel.open()（默认 IPv4/IPv6）或 DatagramChannel 都会直接失败。
- 必须显式传入
StandardProtocolFamily.UNIX，不能省略 - 路径必须是文件系统中可访问的绝对路径（
/tmp/xxx、/var/run/xxx.sock），相对路径会被拒绝 - Linux/macOS 支持，Windows（即使 WSL2）默认不支持，JVM 启动时若检测不到 UDS 底层支持，整个类可能不可用
怎么用 SocketChannel 连本地 Unix 域套接字？
典型使用场景：Java 进程连接本地 Node.js/Python/Rust 启动的 UDS 服务（如 Docker daemon 的 /var/run/docker.sock）。
立即学习“Java免费学习笔记（深入）”；
关键步骤：
- 调用
SocketChannel.open(StandardProtocolFamily.UNIX)创建通道 - 用
UnixDomainSocketAddress.of("/path/to/socket")构造地址（推荐用of()而非构造函数，更安全） -
channel.connect(address)是阻塞的，如需非阻塞，得先configureBlocking(false)再轮询finishConnect() - 注意权限：Java 进程必须对 socket 文件有读写权限，否则抛
IOException: Permission denied
简短示例：
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
SocketChannel channel = SocketChannel.open(StandardProtocolFamily.UNIX);
channel.connect(UnixDomainSocketAddress.of("/var/run/docker.sock"));
// 后续可 channel.write() / channel.read()
ServerSocketChannel 怎么监听本地 socket 文件？
使用场景：用 Java 实现本地 IPC 服务端，避免暴露网络端口。
和传统 TCP 监听差异很大：
- 不能用
bind(new InetSocketAddress(port))，必须用UnixDomainSocketAddress - socket 文件路径若已存在，
bind()会失败（除非先Files.deleteIfExists()） - 客户端连接后，
accept()返回的仍是SocketChannel，但协议族固定为UNIX - 没有“端口”概念，所以
getLocalAddress()返回的是UnixDomainSocketAddress，别试图转型成InetSocketAddress
注意：监听路径的父目录（如 /var/run）必须存在且 Java 进程有写权限，否则 bind() 抛 IOException: No such file or directory。
和 Netty / Spring Boot 能否一起用？
目前主流框架基本不原生支持。Netty 5 开始实验性支持 UDS（需引入 netty-transport-native-unix-common），但 Netty 4.x 完全不识别 UnixDomainSocketAddress；Spring Boot 的 WebMvc/WebFlux 默认基于 HTTP/TCP，没有 UDS 适配层。
这意味着：
- 不能把
UnixDomainSocketAddress直接塞进RestTemplate或WebClient - 想用 Spring 管理 UDS 客户端，得自己封装
SocketChannelBean，并处理连接池、超时、异常重试 - 日志里看到
address: /tmp/x.sock并不表示框架真用了 UDS——大概率只是字符串拼接
真正落地时，最易被忽略的是 socket 文件生命周期管理：服务端退出后没清理文件，下次启动就 bind 失败；客户端没正确 close channel，可能导致 socket 文件句柄残留——这些都不会报明显异常，只会让后续连接静默失败。
