使用otThreadGetChildNextIp6Address返回OT_ERROR_NOT_FOUND的问题排查

• 测试环境：两台设备分别作为Thread网络的Leader节点、Child节点运行
• 调用目标：在Leader侧通过otThreadGetChildNextIp6Address接口获取目标Child节点的IPv6地址
• 已验证排除的问题：使用索引值0调用otThreadGetChildInfoByIndex可正常返回Child基础信息，不存在Child索引配置错误的问题
• 当前接口调用参数：
  • 入参aChildIndex设置为0
  • 声明otChildIp6AddressIterator类型变量，将其指针作为迭代器入参传入
  • 声明otIp6Address类型变量，将其指针作为地址输出入参传入
• 实际调用结果：接口返回OT_ERROR_NOT_FOUND

• 迭代器未做初始值赋值
  首次调用该接口前，必须将otChildIp6AddressIterator类型的迭代器变量值显式赋值为0。该迭代器是遍历Child地址列表的位置游标，仅声明变量不初始化的情况下，栈上会残留随机值，框架无法识别合法的遍历起始位置，会直接返回OT_ERROR_NOT_FOUND，这是该接口调用中最常见的遗漏步骤。
• Child地址未完成向Leader的注册流程
  Leader侧存储的Child IPv6地址列表，完全来自Child节点通过Child Update Request报文主动上报的注册数据。即使otThreadGetChildInfoByIndex能正常返回Child的基础元数据（如超时时间、设备模式等基础字段），如果Child侧未完成地址注册（如SLAAC地址尚未生成、Child设备模式配置为不上报非稳定地址、注册报文未被Leader正确解析），Leader侧的Child地址缓存表将为空，查询时自然无法找到有效条目。
• 对接口返回值语义的认知偏差
  OT_ERROR_NOT_FOUND并非只在“找不到对应Child”的场景下返回：当遍历游标移动到当前Child地址列表的末尾、没有更多可返回的地址时，接口同样会返回该错误。如果此前多次循环调用接口时，游标已经停在列表末尾，哪怕Child状态正常，也会持续返回该错误。
• 编译配置开关未使能
  需确认OpenThread编译配置中，Leader侧缓存Child IPv6地址的功能开关已开启。若未使能对应编译宏，框架内部不会在Leader侧留存Child上报的地址条目，无论Child侧如何正常注册，查询接口都会返回空结果。

内容的提问来源于stack exchange，提问作者Tester