Tool Schema 设计：为什么你的 Agent 总是调用错工具？
2026/8/30 5:02:52
在 DFX（Design for X，面向测试 / 运维等的设计）测试中，IPV4/IPV6 双栈的测试核心是验证双栈共存下的功能、兼容性、性能、互通性，需覆盖协议栈独立运行、互访、故障切换、边界场景等维度。以下是系统化的测试方法和实操步骤：
一、测试前提：环境准备
1. 基础环境要求
- 双栈节点：至少 2 台具备 IPV4/IPV6 双栈能力的服务器 / 虚拟机（Linux/Windows 均可，推荐 Linux，便于配置）；
- 网络配置：
- 为节点配置独立的 IPV4 地址（如 192.168.1.10/24）和 IPV6 地址（如 2001:db8::10/64）；
- 确保 IPV4 网关和 IPV6 网关均可达（无防火墙 / ACL 阻断双协议栈流量）；
- 测试工具：
- 基础连通性：
ping/ping6、traceroute/traceroute6、telnet/nc； - 协议栈检测：
ip addr（Linux）、netstat -an/ss -tuln、sysctl（查看 IPV6 内核参数）； - 流量抓包：
tcpdump/wireshark（区分 IPV4/IPV6 报文）； - 性能测试：
iperf3（支持双栈）、tc（模拟网络故障）； - 应用层验证：curl（
curl -4/curl -6）、浏览器、业务客户端。
- 基础连通性：
2. 环境验证
先确认节点双栈已启用（以 Linux 为例）：
# 查看IP配置（同时显示inet/inet6） ip addr show eth0 # 确认IPV6内核参数开启（关键参数） sysctl -a | grep ipv6 | grep -E "disable|forwarding" # 需确保 net.ipv6.conf.all.disable_ipv6 = 0二、核心测试维度与实操步骤
维度 1：双栈基础连通性测试
验证 IPV4/IPV6 协议栈独立可达，无单栈阻断。
| 测试项 | 操作步骤 | 预期结果 |
|---|---|---|
| IPV4 单栈连通性 | 节点 Aping 节点B的IPV4地址；telnet 节点B:端口（如 80） | 丢包率 0，端口可通 |
| IPV6 单栈连通性 | 节点 Aping6 节点B的IPV6地址；telnet6 节点B:端口 | 丢包率 0，端口可通 |
| 双栈同时连通 | 并行执行 ping（IPV4）和 ping6（IPV6），持续 1 分钟 | 两者均无丢包，无互相干扰 |
| 跨网段双栈连通 | 节点 A（网段 1）访问节点 C（网段 2）的 IPV4/IPV6 地址 | 路由可达，traceroute/traceroute6 路径正常 |
维度 2：双栈优先级与协议选择测试
验证系统 / 应用在双栈环境下的协议选择逻辑（如是否支持手动指定、默认优先级是否符合预期）。
- 系统层优先级验证（Linux）：
# 查看IPV6优先级（precedence） cat /etc/gai.conf # 默认配置中IPV6优先级高于IPV4（precedence ::ffff:0:0/96 100），可修改验证 # 测试域名解析的协议选择 nslookup 目标域名 # 同时返回A（IPV4）和AAAA（IPV6）记录 curl 目标域名 # 查看默认使用IPV4/IPV6 curl -4 目标域名 # 强制IPV4 curl -6 目标域名 # 强制IPV6 - 应用层协议选择：
- 验证业务应用（如 Web 服务、数据库）是否支持通过配置指定 IPV4/IPV6；
- 验证应用监听地址是否为
0.0.0.0（仅 IPV4）、::（双栈）或独立的 IPV6 地址。
维度 3：双栈互通与互操作测试
验证 IPV4 节点与 IPV6 节点、双栈节点之间的业务互通性。
| 场景 | 测试操作 | 预期结果 |
|---|---|---|
| 双栈节点→IPV4 节点 | 双栈节点用 IPV4 访问 IPV4 节点的业务（如 HTTP、TCP 服务） | 业务正常响应，流量为 IPV4 报文 |
| 双栈节点→IPV6 节点 | 双栈节点用 IPV6 访问 IPV6 节点的业务 | 业务正常响应，流量为 IPV6 报文 |
| IPV4 节点→双栈节点 | IPV4 节点访问双栈节点的 IPV4 服务端口 | 正常响应，无协议冲突 |
| IPV6 节点→双栈节点 | IPV6 节点访问双栈节点的 IPV6 服务端口 | 正常响应，无协议冲突 |
| 双栈节点双协议并发 | 同时用 IPV4 和 IPV6 访问双栈节点的同一业务（如并发 curl -4 和 curl -6） | 业务无异常，无端口 / 资源抢占 |
维度 4：故障切换与容灾测试
验证单栈故障时，双栈系统是否能自动 / 手动切换至另一栈，保障业务连续性。
- 单栈阻断测试：
- 阻断 IPV4：在双栈节点上禁用 IPV4（
ifconfig eth0 inet down）或防火墙阻断 IPV4 流量；→ 验证业务是否可通过 IPV6 正常访问； - 阻断 IPV6：禁用 IPV6（
sysctl -w net.ipv6.conf.eth0.disable_ipv6=1）或阻断 IPV6 流量；→ 验证业务是否可通过 IPV4 正常访问；
- 阻断 IPV4：在双栈节点上禁用 IPV4（
- 单栈网络故障：
- 模拟 IPV4 网关不可达（
tc qdisc add dev eth0 root netem loss 100%）；→ 验证业务切换至 IPV6（需应用支持自动切换，如基于域名的多协议重试）；
- 模拟 IPV4 网关不可达（
- 恢复测试：
- 恢复被阻断的 IPV4/IPV6 栈，验证业务是否可切回或双栈恢复正常。
维度 5：性能测试
验证双栈并行运行时的性能损耗，以及 IPV4/IPV6 单栈的性能差异。
- 单栈性能对比：
→ 对比吞吐量、时延、丢包率，确认 IPV6 性能无显著劣化（符合设计指标）。# IPV4性能测试 iperf3 -s -4 # 服务端（IPV4） iperf3 -c 节点IPV4 -4 -t 60 # 客户端，压测60秒 # IPV6性能测试 iperf3 -s -6 # 服务端（IPV6） iperf3 -c 节点IPV6 -6 -t 60 # 客户端 - 双栈并发性能：
- 同时运行 IPV4 和 IPV6 的 iperf3 压测，验证 CPU / 内存 / 带宽是否在阈值内，无性能叠加损耗。
维度 6：边界场景测试
覆盖极端 / 异常场景，验证双栈的鲁棒性：
- IPV6 地址异常：
- 测试无效 IPV6 地址（如
2001:db8::gg）、链路本地地址（fe80::xxx）的访问行为； - 测试 IPV6 地址缩写 / 全写形式的兼容性（如
2001:db8::1vs2001:0db8:0000:0000:0000:0000:0000:0001）。
- 测试无效 IPV6 地址（如
- 双栈端口冲突：
- 验证 IPV4 和 IPV6 是否可监听同一端口（如
:::80和0.0.0.0:80，Linux 默认支持），无端口占用冲突。
- 验证 IPV4 和 IPV6 是否可监听同一端口（如
- MTU 差异测试：
- IPV6 默认 MTU 为 1500（IPV4 同理），但 IPV6 无分片（依赖路径 MTU 发现）；
- 模拟不同 MTU（如
tc set dev eth0 mtu 1280），验证大报文传输是否正常。
- 防火墙 / ACL 兼容性：
- 验证防火墙规则是否同时支持 IPV4（iptables）和 IPV6（ip6tables）；
- 测试双栈流量是否被正确匹配和管控（如放行 / 阻断指定端口的 IPV4/IPV6 流量）。
三、测试结果验证与输出
- 抓包验证：用
tcpdump区分 IPV4/IPV6 流量：# 抓取IPV4流量 tcpdump -i eth0 ip host 节点IPV4 # 抓取IPV6流量 tcpdump -i eth0 ip6 host 节点IPV6 - 日志验证：检查系统 / 应用日志（如
/var/log/messages、业务日志），确认无双栈相关报错（如 IPV6 绑定失败、协议解析错误）。 - 测试报告输出：需包含：
- 环境信息（节点 IP、系统版本、网络拓扑）；
- 各维度测试用例、操作步骤、实际结果、是否符合预期；
- 性能数据对比（IPV4/IPV6 吞吐量、时延）；
- 故障场景的切换时长、业务恢复情况；
- 问题记录（如 IPV6 访问超时、双栈并发性能劣化等）及根因分析。
四、常用工具推荐
mtr：网络路径跟踪（支持
mtr -6）tcpdump：抓包分析协议选择
Wireshark：深度分析网络流量
happy-eyeballs：专门的双栈测试工具
五、关键注意事项
- 避免 IPV6 禁用：部分系统默认禁用 IPV6，需提前开启内核参数（
net.ipv6.conf.all.disable_ipv6=0）； - 域名解析：确保测试域名同时配置 A 和 AAAA 记录，避免协议选择单一；
- 工具兼容性：部分老工具不支持 IPV6（如旧版 ping），需使用
ping6/traceroute6等专用工具； - 跨网段 IPV6：需确保路由和邻居发现（ND）正常，避免链路本地地址访问受限。
通过以上维度的测试，可全面验证双栈的功能、兼容性、性能和容灾能力，确保 DFX 设计中双栈特性满足业务要求。