Java原生API直至JDK 21均不直接支持Unix域套接字，因其跨平台设计屏蔽了类Unix系统特有的AF_UNIX机制；JDK 16起通过JEP 380引入UnixDomainSocketAddress及NIO通道支持，但仅限Linux/macOS且不支持传统Socket。
Java原生API在标准JDK（直至JDK 21）中不直接支持Unix域套接字（Unix Domain Sockets, UDS）。这是Java跨平台设计的取舍结果——UDS是类Unix系统（Linux、macOS）特有的IPC机制，而Java虚拟机层抽象屏蔽了此类操作系统特有接口。但实际开发中仍有需求，因此需借助外部方案实现。
为什么标准Java NIO和Socket API无法使用Unix域套接字
java.net.Socket、ServerSocket 及 java.nio.channels.* 中所有通道类型均面向IPv4/IPv6网络协议栈构建，底层调用的是 socket(AF_INET, ...) 或 socket(AF_INET6, ...)。Unix域套接字对应的是 socket(AF_UNIX, ...)，其地址结构（struct sockaddr_un）、文件系统路径绑定、权限控制等与网络套接字完全不同，JVM标准类库未提供对应抽象。
尝试用普通Socket连接本地路径（如 new Socket("/tmp/mysock")）会抛出 UnknownHostException 或 IOException，因为DNS解析器和网络栈根本无法识别路径形式的“主机名”。
可行的替代方案：JEP 380 与 JDK 16+ 的UnixDomainSocketAddress
从JDK 16起，通过
立即学习“Java免费学习笔记（深入）”；
-
java.net.UnixDomainSocketAddress：封装AF_UNIX地址，构造时传入Path对象（如
Paths.get("/tmp/myserver.sock")） - 支持该地址类型的通道：java.nio.channels.SocketChannel 和 java.nio.channels.ServerSocketChannel
注意：仅限NIO通道，传统阻塞式Socket仍不支持；且仅Linux和macOS可用，Windows不支持（即使WSL中运行，JVM需明确运行于Linux内核环境）。
示例服务端片段：
var server = ServerSocketChannel.open();
server.bind(new UnixDomainSocketAddress(Paths.get("/tmp/echo.sock")));
server.configureBlocking(false);
// 后续注册到Selector或accept()兼容旧版本JDK或需更细粒度控制的方案
若项目受限于JDK 8–15，或需自定义超时、凭据传递（如SCM_CREDENTIALS）、非阻塞行为等高级特性，可考虑以下成熟方案：
- netty-incubator-transport-native-unix-common + netty-transport-native-epoll（Linux）或 kqueue（macOS）：Netty封装了本地UDS支持，提供Channel API，与Netty生态无缝集成
- junixsocket（纯Java实现，基于JNI）：提供类似java.net.Socket的API，支持客户端和服务端，适用于嵌入式或需最小依赖场景
- 直接调用JNI封装C函数（如libuv、libc）：灵活性最高，但开发与维护成本大，仅推荐特殊性能/安全要求场景
典型应用场景与注意事项
Unix域套接字常用于同一主机内高吞吐、低延迟、强安全隔离的进程通信，例如：
- Docker CLI 与 dockerd 守护进程通信（
/var/run/docker.sock） - 数据库本地连接（PostgreSQL默认启用
unix_socket_directories） - 微服务间本地gRPC或HTTP/2代理（避免TCP栈开销）
使用时需注意：
- 套接字文件路径需有足够读写权限，服务端应显式设置
chmod（如0755） - 启动前检查并清理残留socket文件（
Files.deleteIfExists(path)），否则bind失败 - 客户端连接失败常见原因是路径错误、权限不足或服务未启动，而非网络超时
- UDS无端口号概念，不可混用IP地址和路径
