uvicorn.run()的host参数决定IPv6监听：host="0.0.0.0"仅IPv4，host="::"仅IPv6，host=None启用双栈；需确保系统、容器及防火墙支持IPv6。
uvicorn.run() 的 host 参数决定是否监听 IPv6
Uvicorn 默认不监听 IPv6，除非你显式指定 host 值为 IPv6 地址或让其自动适配双栈。关键不是加什么 flag，而是传什么 host 给 uvicorn.run()。
常见错误是沿用 IPv4 习惯写 host="0.0.0.0"，这只会绑定 IPv4 ANY，哪怕系统有 IPv6 地址也无法响应 [::1]:8000 或公网 IPv6 访问。
-
host="0.0.0.0"：仅监听 IPv4 所有接口（INADDR_ANY） -
host="::"：仅监听 IPv6 所有接口（IN6ADDR_ANY_INIT），能响应::1、2001:db8::1等地址 -
host=None：Uvicorn 自动调用getaddrinfo()，返回 IPv4 和 IPv6 两组 socket 并全部 bind —— 这才是真正的双栈监听
使用 host=None 时要注意端口复用和系统配置
虽然 host=None 最省心，但它依赖底层操作系统支持 IPV6_V6ONLY=0（即一个 socket 同时接受 IPv4 和 IPv6 连接）。Linux 从 2.6.25+ 默认开启该行为，但某些容器环境、精简版云镜像或旧内核可能关闭它。
若发现 host=None 启动后 IPv4 能通、IPv6 不通，先检查：
Uvicorn 0.52.1
下载
Uvicorn 0.52.1 是 Python ASGI Web 服务器，提供异步应用服务及 WebSocket 支持，常用于 FastAPI、Starlette 等应用的开发和部署。本下载为官方 PyPI 通用 wheel 包，可使用 pip 安装，并由包管理器处理所需依赖。
- 运行
ss -tuln | grep :8000，确认输出中同时存在*:8000（IPv4）和*:[::]:8000（IPv6）两行 - 若只有 IPv4 行，说明
host=None回退到了 IPv4-only 模式，此时应改用host="::"并确保客户端用 IPv6 访问 - 检查系统是否禁用了 IPv6：
cat /proc/sys/net/ipv6/conf/all/disable_ipv6返回1则需启用
在 systemd 或 Docker 中部署时别漏掉网络权限
即使代码里写了 host="::" 或 host=None，实际仍可能无法监听 IPv6 —— 原因常出在运行环境限制上。
- systemd service 文件中若含
RestrictAddressFamilies=AF_INET，会直接屏蔽 IPv6 socket 创建，必须删掉或补上AF_INET6 - Docker 容器默认不启用 IPv6，启动时需加
--sysctl net.ipv6.conf.all.disable_ipv6=0，且宿主机 Dockerd 配置要开启 IPv6（"ipv6": true+"fixed-cidr-v6"） - 云服务器安全组/防火墙规则需放行 IPv6 入向流量（不是只配 IPv4 规则），例如腾讯云需单独配置 IPv6 ACL
验证 IPv6 是否真正生效不能只靠 curl ::1
curl http://[::1]:8000 成功只说明本地回环通，不代表服务对局域网或公网 IPv6 可达。真实验证要分三步走：
- 从同一台机器用公网 IPv6 地址访问（如
curl http://[2001:db8::1234]:8000），确认服务监听的是全局地址而非仅::1 - 从另一台 IPv6 网络内的设备 ping 该地址，并用
telnet [2001:db8::1234] 8000测试端口连通性 - 用
tcpdump -i any port 8000 and ip6抓包，确认收到 SYN 包且服务返回 SYN-ACK —— 这能排除 DNS、代理、中间防火墙干扰
很多“IPv6 配置好了但访问不到”的问题，卡在第三步：抓不到入向 IPv6 包，说明流量根本没到本机，得回头查路由、NAT66、校园网隧道（如 Teredo）或云平台 VPC 的 IPv6 CIDR 分配状态。
