新 AP 不上线怎么办：用 WiFiman 的设备发现辅助 UniFi 采用排障

给 UniFi 生态加新设备（新 AP、新交换机）时最扫兴的瞬间：控制器里等它上线，它永远「Pending」。官方帮助中心明确提到 WiFiman 的设备发现在「快速诊断设备采用问题」时非常有用——这一页讲怎么用它排障。

采用失败的常见卡点

新设备不被控制器收养，原因十有八九在这几类：设备没起来、网络不通、网段隔离、或控制器发现机制没够着它。WiFiman 能把前两类直接变成「看得见的事实」。

用 WiFiman 排查的四步

第一步：确认设备真的通电上线了。打开Discover 页：

• UniFi Devices 区出现了它：设备本身没问题，问题在网络或控制器侧，跳第三步。
• 没出现：切到其他标签页也认不到它，大概率是设备侧问题（供电不足、交换机口坏、PoE 功率不够），先解决物理层。

第二步：拿 IP 看状态。点进它的设备详情记下 IP——有 DHCP 分到的合法 IP 说明链路通了；IP 是 169.254 开头的自动私有地址说明没拿到 DHCP，查上游交换机的 VLAN 配置。

第三步：排除网段隔离。新设备分到的网段与管理网段不同（多 VLAN 环境）、或交换机开了端口隔离时，控制器与设备互相看不见。确认新设备接的端口在正确的 VLAN 里，别让「插错口」背锅。

第四步：回控制器走正式流程。网络侧确认无碍后，在 UniFi 控制器里重新发起采用；设备已配置过旧账号的，先在设备上执行重置再采用。

一个高频翻车：换了控制器

二手 UniFi 设备、或从旧控制器迁移来的设备，带着「前任」的配置不肯认新家。WiFiman 里能看到它在线（说明硬件正常），但控制器死活收不了——这就是典型的需要重置的场景。重置后它会以全新状态出现在 Discover 页，采用一次通过。

排障时的顺手工具

• 信号页：新 AP 采用成功后立刻看它的信号曲线，确认覆盖符合预期。
• 信道优化：新 AP 上线即按流程分配合适信道，别用默认值开跑。
• Places 巡检：加完 AP 重跑一遍全屋读数，验证这次扩容把薄弱点填掉了。

采用机制的具体报错与控制器侧的详细流程以 UniFi 官方文档为准，本页只覆盖「App 侧能看的部分」。