前阵子在帮某物联网项目调试Mesh组网，遇到一个特别典型的卡点：配网器扫描设备时，始终看不到那台待配网的灯控设备。日志显示扫描正常，信道正常，滤波条件也加了，可就是捕捉不到那个关键的广播包。折腾了大半天，最后发现是设备端的Unprovisioned Device Beacon广播没被正确初始化——简单说，这台设备压根就没有向外面“喊”它需要入网。

这个场景在蓝牙Mesh开发里太常见了。很多人一上来就研究配网流程的加密、公钥交换、认证逻辑，却忽略了最前端那个不起眼的beacon。实际上，整个配网能否成功，第一步就取决于这个广播包能不能被配网器稳定地发现。这篇内容我就把Unprovisioned Device Beacon这件事从头到尾拆清楚，包括它在配网链路里的定位、数据包结构、配网时各阶段的状态流转，以及我在不同项目里踩过的坑和排查方法。不管是刚接触蓝牙Mesh的初学者，还是已经被配网问题折磨过的老手，这部分内容应该都能帮上忙。

1. 未入网设备凭什么被“看见”：Unprovision Beacon的定位

1.1 它是配网流程的第一个突破口

蓝牙Mesh网络和传统BLE最直观的区别在于：Mesh里的设备不是天生就能互相通信的。一个新出厂的设备，比如一个灯泡、一个传感器，它内部其实已经跑着完整的Mesh协议栈，但并不知道自己是这个网络里的谁，也不知道网络密钥是什么。在它被配置之前，它就是一个“游离者”——能看到周围的环境，却不被任何现有网络接纳。

这里就出现了一个问题：Mesh网络的配网器（Provisioner）怎么知道周围有这么一个待入网的设备？尤其是当设备没有任何屏幕、没有按键、甚至没有指示灯的时候，配网器总得有个方式发现它。Unprovisioned Device Beacon（未配网设备信标）就是这个机制的最前端。它本质上是一个BLE广播包，周期性地向外发送，包里唯一的目的就是告诉所有在监听的配网器：“我在这里，我是谁，我准备好被配置了。”

我们常说的“beacon”，可能指的是苹果的iBeacon，也可能指各种室内定位用的信标，但Unprovisioned Device Beacon是完全不同的东西。它不承载定位信息，不面向普通手机应用提供数据，而是面向Mesh网络的配网器，承担的是设备发现功能。没有这个广播包，配网器就会对着空气扫描，后面所有流程都无从谈起。

1.2 两套beacon别搞混：发现用beacon，配网事务则是另一套

很多初学者会在这里踩一个概念上的混淆：Mesh里其实有两类和“未配网”密切相关的广播。一类是Unprovisioned Device Beacon，用于让设备被发现；另一类是配网过程中真正传输配网指令的广播包，走的是PB-ADV（Provisioning Bearer Advertising，基于广播承载的配网事务）机制。两者的时间先后和职责完全不同。

实际运行中是这样：设备先以Unprovisioned Device Beacon的身份对外广播，配网器扫描到它之后，由配网器主动发起配网连接，双方进入配网事务阶段。进入事务阶段后，配网双方交换的是配网协议数据包（Provisioning Protocol PDUs），这些数据包通过PB-ADV广播承载，但它们的广播类型已经不再是Unprovisioned Device Beacon，而是带有特定配网事务标识的ADV包。

我在调试时就见过一个项目，开发同学一直盯着检查Unprovisioned Device Beacon的广播是否正确发送，却忘了配网事务是靠另一组广播完成的，导致这两段的链路经常被截断。理解了这个先后关系，后面排查问题时就不会在一个地方死磕。

1.3 什么时候广播，什么时候停：beacon的声明周期

Unprovisioned Device Beacon并不是设备一上电就永远广播个不停。它的生命周期取决于设备的存储状态。设备启动后，协议栈会先检查非易失性存储里有没有保存有效的配网信息（NetKey、AppKey、IV Index等）。如果没有——也就是这台设备从未被配置过，或配置信息被主动清除过——协议栈才会启动beacon广播。

一旦配网成功，设备会写入配网数据，此时beacon必须立即停止。这一点在很多项目里看起来理所当然，但实际测试中经常翻车，后面我会专门讲我遇到的一个案例：配网成功后beacon没有停，导致设备被重复配网。

2. 拆包看本质：Unprovisioned Device Beacon数据包结构

2.1 广播类型0x29和AD Structure的组装规则

蓝牙Mesh规范里规定，Unprovisioned Device Beacon的广播类型值为0x29。整个广播包遵循BLE标准的AD Structure格式，也就是Length、Type、Data三段式。我用一个实际抓包得到的数据来拆解：

AD Structure 1: Length : 0x15 (21字节) Type : 0x01 (Flags) Data : 0x06 (LE General Discoverable Mode) AD Structure 2: Length : 0x14 (20字节) Type : 0x29 (Unprovisioned Device Beacon) Data : 16字节Device UUID + 2字节OOB Information

第一个AD Structure是常见的广播标志，告知接收方这是一个通用可发现的广播设备。第二个AD Structure才是核心。当配网器扫描时，就是靠过滤Type字段是否等于0x29来识别潜在的可配网设备。

这里有个细节值得注意：一次广播包里面只能有一个Type为0x29的AD Structure。如果想把Unprovisioned Device Beacon和其他数据（比如厂商自定义数据、服务UUID）拼在一起，必须放在不同的AD Structure里。配网器解析时也是独立解析每个AD Structure的，不是要求整个广播包全是beacon内容。

2.2 Device UUID：设备唯一的身份证明

Device UUID是整个beacon包里最重要的16字节。它不是什么随机数，而是设备的静态标识符，在设备生产阶段就写入非易失性存储，配网后也不会改变。配网器通过它识别设备，Mesh网络后续对设备的操作也基于这个UUID建立对应关系。

生产环节对UUID的管理是个容易被忽视的工作。有些工厂在烧录时用的是同一个UUID模板，导致一批设备全部撞车。那场面很经典：配网器扫描到一个UUID，却对应了好几台物理设备，完全无法区分。更隐蔽的问题是，UUID一旦在生产后需要修改，牵扯到整台设备的重新烧录和配网数据清除，非常麻烦。

正确的是在产线阶段就保证UUID唯一，并且和产品序列号、MAC地址等建立映射关系，写进设备信息表。调试时我习惯先用串口或板载调试工具读取设备的真实UUID，再手动添加进配网器的过滤条件里，而不是通过扫描列表去碰运气。

2.3 OOB Information字段怎么用

Device UUID后面跟着2字节的OOB Information。这个字段描述的是设备在配网认证阶段支持哪些带外信息的输入输出方式。常见值包括：

配网器发现beacon后，会根据OOB值判断这台设备能采用哪种认证方式。实际项目里，如果配网器端配置了固定要求数字输入，而设备端OOB字段声明不支持任何OOB，配网必然失败。这个字段的声明和配网器的要求必须对得上，否则就是白调试半天。

我踩过的一个典型案例是：设备明明带了一块小屏幕，可以显示动态数字用于认证，但SDK里的OOB信息配置被某次固件更新意外改成了0x0000。配网器认为设备没有任何OOB能力，只能走最简单的无认证流程，这在安全性要求高的场景下直接导致配网被服务端策略拒绝。

2.4 可选的URI Hash字段

有部分设备还会在beacon后面追加一个URI Hash字段，用来进一步标识设备类型或产品信息。URI Hash，简单说就是把一个URI（比如https://example.com/light/001）经过哈希算法后得到的固定长度值。配网器可以先通过URI Hash识别出设备的类型，再决定是否发起配网，减少扫描到不相关设备时的干扰。

如果不需要设备类型分类，这个字段可以省略。包长度更短，广播成功率也会更高，尤其是当广播信道比较拥堵时。

3. 配网链路全解析：从被扫描到完成配置的五个阶段

3.1 建立邀请：邀请是双向的

当配网器通过Unprovisioned Device Beacon发现设备后，会主动向设备发送一个Provisioning Invite包。这一步很多人理解成“配网器向设备打招呼”，实际上它是配网事务的正式启动信号。

设备收到Invite包后，会回复一个Invite Acknowledgement，同时双方基于这个交互确定后续的数据包格式、重传策略和协议版本。如果设备端没有正确维护beacon状态，或者已经进入半配网状态（比如上次配网超时没有清理干净），这一阶段就会多次超时。

值得注意的是，配网器此处不再监听0x29类型的广播，而是直接和该设备建立点对点的配网承载。我在实际调试验证时发现，不少SDK在进入这一步后，设备端的beacon广播仍然在继续，这在协议层面是允许的，但会增加不必要的空口占用，建议在业务层面主动处理。

3.2 公钥交换与认证：安全的关键环节

邀请阶段完成后，配网双方进入Public Key交换阶段。双方各自的公钥如果通过beacon的OOB字段预先声明支持带外交换，也可以先通过带外方式交换，提高安全性。这一步完成后，配网器会发起Authentication阶段。

认证阶段基于之前OOB字段声明的能力来执行。如果声明的是输出显示，设备端生成一个六位数字并显示在屏幕或标签上，用户把这个数字输入到配网器完成认证；如果声明的是输入按钮，则是配网器端生成数字，用户在设备上按键输入。整个过程是为了防止中间人攻击。

我在这个阶段最常碰到的问题是设备端和配网器端的OOB类型配置不一致。很多开发者以为只要配网器端支持某种方式就行，忘了设备端的beacon OOB字段也要同步声明。排查时先看抓包里beacon的OOB值，再对照配网器端的认证策略，往往一眼就能定位。

3.3 下发配网数据：分配网络地址与密钥

认证通过后，配网器给设备分配关键参数：单播地址、NetKey、AppKey、IV Index等，然后通过加密通道发送给设备。这个阶段也是整个配网过程最复杂的一步，包含多条配网协议PDU的往返交互。

设备收到这些数据后，会写入自己的非易失性存储，然后向配网器发送Provisioning Complete消息。配网器收到这条消息后，才会认为配网流程真正完成。此时设备端的协议栈会把自身状态切换为已配网节点，停止Unprovisioned Device Beacon广播。

这里我建议每一条关键PDU的成功与否，都要看两端日志里的状态机转换点。光看一条“配网成功”的日志往往不够，因为有些SDK会在设备本地状态已更新但配网器尚未确认时提前报成功，导致网络里出现一个半配网状态的尴尬节点。

3.4 配网完成后的beacon状态切换

配网完成后，设备从Unprovisioned Device状态变成Provisioned Node状态。此时Unprovisioned Device Beacon必须停止，如果设备支持PB-GATT，可能还会切换到可连接广播状态，允许手机App通过GATT连接对它做后续配置。

这一块是很多产品真正上了产线、或者到了用户手里之后出问题的地方。有些设备明明已经配好网，在售后排查时会发现又被重新配了一次，原因就在于设备重启时存储读取失败，协议栈误判设备仍未配网，重新打开了beacon广播。

配合抓包工具，能够清楚地看到配网成功的瞬间，0x29类型的广播停止发送。如果这个广播没停，基本可以断定是存储写入或者状态标志没有正确完成，这就是一个清晰的排查方向。

4. 现场翻车实录：三个典型问题及定位思路

4.1 扫描不到beacon：先分清“没广播”还是“没扫到”

这个问题我开场就提到了，也是大家问得最多的。它的排查点可以按下面这张表一层层排除：

排查顺序从设备端到配网器端，从简单到复杂。先确认广播有没有发出来，再确认配网器能不能扫到，然后再去查信道和干扰。不要一上来就怀疑空口环境有问题，设备端SDK初始化顺序导致beacon没启动，这种情况我见到的概率远大于信道问题。

一种高效的定位方式是，在设备旁边放一个支持广播过滤的抓包工具，先看设备上电后有没有发出任何广播。如果没有任何广播报告，那就是设备端的问题；如果有，再对照配网器端的扫描报告，看是不是被滤掉了。这一步能把问题范围缩小一大半。

4.2 多设备同时配网：碰撞和重试的权衡

项目现场，经常是一整箱设备同时上电，然后配网器一个个扫描配网。这种情况下，大量设备同时广播Unprovisioned Device Beacon，三个广播信道很容易发生碰撞，导致部分设备迟迟不被发现。

蓝牙Mesh协议对广播间隔有随机退避机制，设备每次广播的时间间隔会根据一个随机数在设定值附近浮动，避免多设备完全同步广播。但实际项目里，如果不设置随机退避或间隔浮动过窄，碰撞概率会显著上升。

我的做法是把默认广播间隔设置到200ms~500ms范围内浮动，并根据设备数量做动态调节。比如第一次上电的120秒内，广播间隔可以短一点，让配网器尽快发现；之后如果没有被配网，逐步拉长间隔降低功耗。这个策略在实际项目里既保证了配网速度，又照顾了长期待机场景。

4.3 配网成功后设备还在广播：重复入网隐患

刚才提到的重复入网问题，实际调试中绕不开。有一次我排查一个节点的异常行为：它已经成功入网，也能收发Mesh消息，但每次配网器重新扫描时还会发现它。抓包一看，Unprovisioned Device Beacon还在周期性地发。

原因出在设备SDK的通知顺序上：配网完成后，协议栈先发了Provisioning Complete事件给应用层，应用层更新了自身的业务状态，但设备存储中的配网标志位是在另一条逻辑里更新的，而这条逻辑因为某个分支条件没满足被跳过了。设备重启后，存储读不到配网标志，于是又把自己当成未配网设备。

这一类问题排查起来很耗时间，因为表面看起来配网功能是正常的。建议在你的代码里做一个简单的断言：配网完成事件之后，立刻读一次存储标志位，确认已经写成功。这个断言放在量产固件里也是一种保护，防止用户在配网后因设备重启出现“已配网变未配网”的诡异现象。

5. 抓包分析的关键姿势：把beacon从空中钉在纸上

5.1 抓包前的准备工作和过滤条件设置

调试蓝牙Mesh，抓包能力是必须的。不要靠“我觉得应该没问题”来排查，直接把空中报文拿下来看，很多问题当场就清楚了。抓Unprovisioned Device Beacon，准备工作其实就那么几项：抓包工具支持至少3个广播信道的同时监听，天线靠近设备，周围少一些其他2.4GHz设备。

抓包开始后，先不做过滤地监听一段时间，确认能看到设备发出的其他广播，再添加过滤条件。过滤时我是直接过滤广播类型0x29，或者过滤beacon的AD Type字段。具体到抓包软件里，通常是通过自定义AD Type过滤表达式实现的，不同抓包工具写法略有不同，但原理都是匹配ad_type=0x29。

这里特别提醒：很多抓包工具默认只显示设置了“可连接广播”标志的数据包，而Unprovisioned Device Beacon不一定包含Connectable标志，容易被隐藏掉。如果发现抓不到，先检查工具的显示过滤条件，把所有广播类型显示出来再看。

5.2 如何从抓包结果判断广播是否健康

抓包结果里最值得关注的三个指标是广播间隔的稳定性、RSSI的波动范围，以及包内数据的一致性。

广播间隔方面，如果设定值是200ms，实际抓包发现间隔忽长忽短、甚至出现几百毫秒的空档，说明设备端的广播调度有问题，可能被其他高优先级任务抢占。RSSI波动大，说明设备天线和抓包器之间的距离或方位在变化，或者反射干扰严重，这时候就要调整物理位置再测。

数据一致性方面，我遇到过设备广播里的Device UUID和它实际调试口读出来的UUID对不上，后来发现是同一条SDK代码路径下有两份UUID配置，初始化时用了旧的缓存。这种问题不抓包根本发现不了，通过对比beacon里的UUID和固件配置的UUID就能迅速定位。

5.3 结合协议栈日志做交叉验证

抓包只解决了一部分问题，另一部分要靠设备端协议栈日志。拿配网失败的情况举例：beacon在空中反复发出，配网器也扫到了，但配网流程中途断开。这时候抓包能告诉你的只是“连接建立失败”或“某条消息超时”，但具体是哪一层的状态机出了问题，通常要看设备端日志里的状态转换记录。

联合分析时，我习惯把抓包时间戳和SDK日志时间戳对齐，先看抓包里配网器发送Invite的时间，再在SDK日志里找设备收到Invite的时间。如果两者相差超过几百毫秒，重点看设备端广播接收窗口是否被关闭；如果设备端收到了但没回复，重点看协议栈状态机是否卡在某个中间状态。

时间戳对齐这块，很多日志默认打印的是系统启动后的相对时间，需要换算成Unix时间戳或带上RTC时间，不然两边对不上。我一般会在调试固件里增加一个启动标志日志，打印当前的秒级时间戳，方便和抓包时间对应。

6. 经验沉淀：几句不一定写进文档的实话

6.1 关于广播参数的合作经验

广播间隔和功耗的关系，很多人只看理论值，但实际做产品时的权衡更多。默认广播间隔100ms，单次广播功耗大概0.5秒等效电流的几分之一，看似不夸张，但如果一个设备被放在货架上无人配网，一年下来累积的功耗相当可观。

我后来在量产项目里用的是两段式策略：开机或复位后2分钟内以200ms间隔广播，方便用户快速配网；之后如果一直没被配网，切换到1秒或2秒间隔，同时降低广播发射功率。这个策略在减弱功耗的同时，还要保证配网器靠近设备的时候能发现。具体的间隔数值需要根据产品形态和电池容量来计算，没有放之四海而皆准的答案。

6.2 不同SDK实现里的个性差异

不同厂商的蓝牙Mesh SDK对Unprovisioned Device Beacon的实现有不少细节差异。有的SDK要求开发者在使用配网功能前显式初始化beacon参数，否则默认不广播；有的SDK则把beacon和可发现模式绑定，关闭可发现模式就会连beacon一起关闭。

这就导致一个问题：从一个平台迁移到另一个平台时，不能只看配网主流程的API，还得把beacon初始化、OOB配置、广播参数这些边角功能全部检查一遍。我最开始做跨平台移植的时候就吃过这个亏，原来在某芯片上跑得好好的工程，换到另一家的SDK后死活扫不到设备，最后发现是beacon初始化被另一个功能函数覆盖了。

6.3 还能怎么玩：URI Hash与近场配网

研究Unprovisioned Device Beacon不只是为了配网能跑通，它还可以承载一些产品化的玩法。比如通过URI Hash，配网器可以在扫描阶段就识别出这是一台灯具还是传感器，自动弹出对应的配置页面，省去用户手动选择设备类型的步骤。

还有一种比较实用的扩展思路是结合RSSI做距离门限。利用beacon广播的RSSI强弱，当配网器靠近某台设备到一定距离时，才会触发配网，这样可以防止在设备密集环境下误配到隔壁的设备。这种方案对广播功放射频链路一致性要求高，需要做相对复杂的校准，但在一些高端产品场景里，体验提升非常明显。

现在回看Unprovisioned Device Beacon，它不过是一个只有二十来字节的广播包，却在Mesh网络的入口处扮演着无可替代的角色。很多Mesh配置问题，追根溯源到最后都是回到了这个小小的beacon上。分享这些内容，也是希望大家在调Mesh配网时，先把这个“最初的招呼”打好，再谈后面那些复杂的加密和握手，会顺手很多。