Network Interconnect 常见陷阱

# CNI 陷阱与故障排除 ## 常见错误 ### "Status: Pending" (状态：待处理) **原因:** 交叉连接未安装，RX/TX 光纤接反，光纤类型错误，或光信号强度低 **解决方案:** 1. 验证交叉连接已安装 2. 检查配线架上的光纤 3. 交换 RX/TX 光纤 4. 使用光功率计检查光强度 (目标 > -20 dBm) 5. 联系客户团队 ### "Status: Unhealthy" (状态：不健康) **原因:** 物理问题，光信号弱 (<-20 dBm)，光模块不匹配，或连接器脏污 **解决方案:** 1. 检查物理连接 2. 清洁光纤连接器 3. 验证光模块类型 (10GBASE-LR/100GBASE-LR4) 4. 使用已知良好的光模块测试 5. 检查配线架 6. 联系客户团队 ### "BGP Session Down" (BGP 会话中断) **原因:** IP 地址错误，ASN 错误，密码不匹配，或防火墙阻止 TCP/179 **解决方案:** 1. 验证 IP 与 CNI 对象匹配 2. 确认 ASN 正确 3. 检查 BGP 密码 4. 验证防火墙未阻止 TCP/179 5. 检查 BGP 日志 6. 查看 BGP 定时器 ### "Low Throughput" (低吞吐量) **原因:** MTU 不匹配，分片，单 GRE 隧道 (v1)，或路由效率低下 **解决方案:** 1. 检查 MTU (v1 为 1500↓/1476↑，v2 双向 1500) 2. 测试不同数据包大小 3. 添加更多 GRE 隧道 (v1) 4. 考虑升级到 v2 5. 查看路由表 6. 使用 LACP 进行捆绑 (v1) ## API 错误 ### 400 Bad Request: "slot_id already occupied" **原因:** 其他互联已占用此插槽 **解决方案:** 列出插槽时使用 `occupied=false` 过滤器: typescript await client.networkInterconnects.slots.list({ account_id: id, occupied: false, facility: 'EWR1', }); ### 400 Bad Request: "invalid facility code" **原因:** 拼写错误或不支持的设施代码 **解决方案:** 查看 [位置 PDF](https://developers.cloudflare.com/network-interconnect/static/cni-locations-2026-01.pdf) 获取有效代码 ### 403 Forbidden: "Enterprise plan required" **原因:** 账户非企业级 **解决方案:** 联系客户团队升级 ### 422 Unprocessable: "validate_only request failed" **原因:** 预检验证发现问题 (插槽错误，配置无效) **解决方案:** 查看错误详细信息，在实际创建前修复配置 ### 速率限制 **限制:** 每个令牌 1200 次请求/5 分钟 **解决方案:** 实现指数退避，缓存插槽列表 ## 云特定问题 ### AWS Direct Connect: "VLAN not matching" **原因:** AWS LOA 中的 VLAN ID 与 CNI 配置不匹配 **解决方案:** 1. 订购后从 AWS 控制台获取 VLAN 2. 将确切的 VLAN 发送给 CF 客户团队 3. Ver