socket.AF_INET6必须显式指定，Python默认创建IPv4套接字；IPv6绑定需四元组("::", port, 0, 0)，accept返回地址也为四元组，且需检查系统IPv6启用状态与防火墙配置。
socket.AF_INET6 是必须显式指定的地址族
Python 默认 socket.socket() 创建的是 IPv4 套接字，即使你在 IPv6 地址上 bind 也会失败。要支持 IPv6，必须在创建 socket 时明确传入 socket.AF_INET6。不这样做会导致 socket.error: [Errno 22] Invalid argument 或绑定到 ::1 时静默失败。
常见误区是以为只要 bind "::1" 就自动启用 IPv6 —— 实际上它仍尝试用 IPv4 套接字处理，底层会拒绝。
- 正确写法：
sock = socket.socket(socket.AF_INET6, socket.SOCK_STREAM) - bind 地址建议用
("::", port)（监听所有 IPv6 地址），而非仅("::1", port)，否则本地回环外的 IPv6 客户端连不上 - 如果想同时支持 IPv4 和 IPv6，不能靠一个 socket：IPv6 socket 默认可接收 IPv4 映射地址（需开启
sock.setsockopt(socket.IPPROTO_IPV6, socket.IPV6_V6ONLY, 0)），但行为依赖系统配置，不推荐混用；更稳妥是分别启动两个 socket
IPv6 地址 bind 时要注意元组长度和端口类型
IPv6 的 bind() 要求地址元组包含 4 个元素：(ip, port, flowinfo, scopeid)。其中后两个通常为 0，但必须显式提供，否则抛 TypeError: AF_INET6 address must be a tuple of length 4。
尤其容易忽略的是：即使你只传 ("::", 8080)，Python 也会报错 —— 它不会自动补全后两项。
立即学习“Python免费学习笔记（深入）”；
- 正确写法：
sock.bind(("::", 8080, 0, 0)) -
flowinfo和scopeid一般设为 0；若绑定到链路本地地址（如"fe80::1%eth0"），则scopeid需填对应接口索引（可用socket.if_nametoindex("eth0")获取） - 端口号必须是整数，不能是字符串；
bind(("::", "8080", 0, 0))会直接报错
accept() 返回的 client_address 是 4 元组，解析需适配
IPv4 下 accept() 返回的地址是 (host, port) 二元组，而 IPv6 下固定是四元组 (host, port, flowinfo, scopeid)。硬编码取 addr[0] 和 addr[1] 虽然能跑，但读取 addr[2] 或 addr[3] 时在 IPv4 模式下会越界。
更安全的做法是解包时用星号捕获冗余字段，或统一按长度判断：
client_sock, addr = sock.accept() host, port = addr[:2] # 安全取前两个，兼容 IPv4/IPv6 返回格式
- 不要假设
len(addr) == 2，IPv6 下永远是 4 - 日志打印 client 地址时，直接
str(addr[0])即可，Python 自动处理 IPv6 地址格式（含方括号） - 如果要做访问控制（比如只允许特定 scope 的连接），才需要检查
addr[3]（scopeid）
防火墙和系统配置常被忽略
代码跑通不代表客户端真能连上。Linux 上默认可能禁用 IPv6，或 iptables/ip6tables 拦截了端口。macOS 和 Windows 也有各自限制。
- 检查 IPv6 是否启用：
cat /proc/sys/net/ipv6/conf/all/disable_ipv6（0 表示启用） - 测试本地连通性：
nc -6 ::1 8080（-6 强制 IPv6）；失败时先排除 netcat 本身是否支持 IPv6（旧版可能不支持） - 云服务器需确认安全组放行 IPv6 端口（AWS/Azure/GCP 控制台中 IPv6 规则独立于 IPv4）
- 某些路由器不转发 IPv6 流量，局域网内用
fe80::/10地址测试比公网 IPv6 更可靠
IPv6 的地址结构、作用域和系统级支持远比代码层复杂；哪怕 socket 写对了，卡在 connect: Network is unreachable 也大概率是环境问题，不是 Python 的锅。
