WebSocket前端new WebSocket()支持IPv6，但必须用方括号包裹地址（如ws://[::1]:8080/），且服务端需显式监听[::]，否则连接失败。
WebSocket 协议本身完全支持 IPv6，但前端 WebSocket 构造函数能否连上，取决于浏览器实现、地址格式写法和网络环境——不是所有写法都有效，也不是所有 IPv6 地址都能直接用。
前端 new WebSocket() 连 IPv6 地址必须加方括号
浏览器要求 IPv6 字面量地址（如 ::1、fe80::1）必须用方括号包裹，否则解析失败。直接写 ws://::1:8080 会报 DOMException: Failed to construct 'WebSocket': The URL's host is invalid。
✅ 正确写法：new WebSocket('ws://[::1]:8080/')✅ 正确写法：new WebSocket('wss://[2001:db8::1]:443/')-
❌ 错误写法：new WebSocket('ws://::1:8080/')（缺少方括号） -
❌ 错误写法：new WebSocket('ws://[::1]:8080')（结尾斜杠缺失，部分服务端拒绝无 path 的 Upgrade 请求）
IPv6 地址不能靠 DNS 自动降级或 fallback
如果传入的是域名（如 ws://example.com），浏览器会查 A 记录（IPv4）和 AAAA 记录（IPv6）。但一旦 DNS 只返回 AAAA 记录，且客户端网络不支持 IPv6（比如某些 NAT64 移动网络），连接就会静默超时——不会自动退到 IPv4，也不会报明确错误。
前端设计与 UI/UX 全方位优化专家。覆盖视觉层次、排版系统、色彩理论、响应式布局、交互体验、动画动效、无障碍访问、性能优化八大维度，帮助开发者将普通页面升级为高品质产品级界面。前端设计与 UI/UX 全方位优化专家。覆盖视觉层次、排版系统、色彩理论、响应式布局、交互体验、动画动效、无障碍访问、性能优化八大维度，帮助开发者将普通页面升级为高品质产品级界面。
- 测试时建议优先用字面量地址（如
[::1]或[2001:db8::1]），绕过 DNS 不确定性 - 若必须用域名，确保它同时有 A 和 AAAA 记录，并在服务端监听双栈（
0.0.0.0+[::]） - 微信小程序的
wx.connectSocket在纯 IPv6 网络下存在已知 handshake 后主动断连问题，目前不建议在小程序中直连 IPv6 字面量地址
服务端监听配置决定前端能否连通
前端能写对地址，不代表服务端接得住。常见问题是服务端只绑定了 0.0.0.0（IPv4 any），而没显式监听 [::]（IPv6 any）。
立即学习“前端免费学习笔记（深入）”；
- Node.js（原生
http.Server）：server.listen(8080, '::')才监听 IPv6；仅listen(8080)默认只开 IPv4 - websocketd：
--address [::] --port 8080启 IPv6；--address 0.0.0.0 --address [::]实现双栈 - Workerman：
start.php中监听['tcp://[::]:8080']，并确认日志输出含[::]:8080而非仅0.0.0.0:8080 - 防火墙常忽略
::1：Linux 上检查ip6tables -L是否放行lo接口；macOS 检查pfctl规则
最容易被忽略的一点是：IPv6 地址写法看似简单，但方括号、端口、路径三者缺一不可；而服务端是否真正监听了 IPv6，光看启动命令不够，得看实际绑定的 socket 地址——用 ss -tln | grep :8080 或 lsof -i :8080 确认输出里有没有 [::]:8080。
