ADCampus标杆巡检失败

标杆的版本是多少

检查下连通性情况

用最新版本试试

连通性测试只是 ping 通，标杆巡检不是只 ping，还要调用 ADCampus 北向 API、读取拓扑 / 组件状态、校验账号权限、证书、接口协议、时间、纳管数据；ping 通≠北向接口可用。 版本组合：ADCampus6.5 + 标杆 9.2.0，这个组合本身是配套支持的，优先排除版本不兼容，往下按顺序查：

1、标杆对接 ADCampus 北向账号权限问题（最高发）

标杆对接 ADCampus 需要拥有北向 API 全权限的操作员账号，只读账号、普通运维账号权限不足：

• 账号缺少【北向开放 API、园区拓扑、EIA、WSM、VLAN、VXLAN、设备纳管信息】的查询权限；
• 账号密码近期修改过，但标杆里面保存的密码没同步更新；
• AD-Campus 账号被锁定、会话超限。 ✅ 排查：在 ADCampus 单独新建北向对接专用管理员账号，在标杆对接页面重新录入、测试连通（这里的连通测试≠ping，是 API 连通）。

2、北向端口、中间防火墙 / 安全策略拦截（ping 放行、API 端口不放）

ping 是 ICMP，ADCampus 北向 HTTPS API 是443 端口；很多现场防火墙放通 ICMP，但是：

• 拦截标杆访问 ADCampus 底盘北向 443；
• 开启 SSL 策略、应用识别，拦截了北向 API 的 HTTPS 报文；
• 存在 NAT，源 / 目的端口转换异常。 ✅ 排查：从标杆服务器上直接 curl ADCampus 北向地址 https://控制器IP:443，看能不能正常返回；不要只 ping。

3、证书、SSL 校验问题（标杆 9.2.0 校验严格）

标杆对接 ADCampus6.5 北向默认校验证书：

• ADCampus 是自签证书，标杆服务器没有导入根证书；
• 证书域名 / IP 和对接填写的 IP 不一致、证书过期；
• 标杆配置里开启了 SSL 强校验，证书不通过直接巡检任务失败，但是 ping 不受影响。 ✅ 排查：两种办法：①把 ADCampus 根证书导入标杆信任证书库；②临时在标杆对接配置关闭 SSL 证书校验（现场测试用，生产不推荐长期开）。

4、ADCampus 内部组件状态异常，北向 API 返回报错

控制器 ping 能通，但内部微服务异常，API 返回 500/502 / 超时：

• SeerEngine-Campus、Topo、EIA、WSM 相关容器异常、crash、没就绪；
• 集群节点时间不同步（ADCampus 集群、标杆服务器时间差过大，签名校验失败）；
• 数据库同步异常、拓扑缓存脏数据，北向查询拓扑、设备清单报错。 ✅ 排查：登录 ADCampus 底盘，查看容器状态、集群时间；单独访问北向 API 文档地址，手动调用接口测试返回值。

5、纳管数据不一致、拓扑脏数据（ADCampus6.5 高频坑）

• 设备曾经删除、替换、重新上线，拓扑残留旧链路、无效设备；
• M-LAG/IRF 堆叠、VXLAN 隧道状态异常，控制器拓扑计算告警；
• 部分设备状态 unknown、SNMP/NETCONF 采集异常，巡检脚本遍历设备时触发异常中断，整体标记巡检失败，但 ping 测试项单独是成功。 ✅ 排查：ADCampus 拓扑页面清理无效链路、同步设备信息；确认所有 Fabric 设备控制器连接状态正常。

6、标杆侧配置、巡检模板、超时参数

• 标杆里对接的是集群虚拟 IP，但集群主节点切换、VIP 漂移；
• 巡检任务超时时间设置太短，ADCampus 园区规模大，拉取全量拓扑 / 准入数据耗时久，任务超时失败；
• 选的巡检模板是高规格全量标杆模板，包含 EIA 准入、WSM 无线、安全组等子项，其中任意一个子项 API 查询失败，整体巡检结果失败，连通性子项单独打勾成功。 ✅ 排查：先跑一个极简巡检模板（只查基础拓扑、设备）定位是哪一个子检查项失败；放大标杆对接超时时间。

快速排错顺序（推荐你现场按这个顺序）

1. 标杆对接页，重新录入北向专用管理员账号，执行【对接连通测试】（这个是 API 连通，不是 ping）；
2. 在标杆服务器 curl https:// 控制器 IP，确认 443 和 HTTPS 通、证书正常；
3. 核对标杆服务器和 ADCampus 集群 NTP 时间一致；
4. 看标杆巡检报告详情，找到第一个失败的子检查项（最关键，能直接定位是拓扑 / EIA/WSM 哪一块报错）；
5. 清理 ADCampus 拓扑无效链路、同步设备；检查控制器内部容器告警。

补充避坑

连通性测试只是标杆巡检里众多检查项中的其中一条子项；只要其他任意一个北向查询项异常，最终巡检结果就是失败，ping 项单独显示正常，这就是这个现象最本质的原因。