iPhone 能上网但 App 找不到打印机、配件或附近的 Mac 时,先检查 App 的本地网络权限。互联网连接与访问同一网络中设备的许可是两回事。连接失败也可能是 Bonjour 服务没找到,或者当前 Wi-Fi 不允许设备互通。

先在真机上复现


用已知能工作的服务,在自己能控制的网络上测试。将真机和服务端接入同一个普通 Wi-Fi,把 App 放到前台,从用户实际使用的页面启动发现。记录系统版本、构建、服务类型及是否出现授权提示。Apple 建议在真机测试,因为模拟器不支持本地网络隐私行为。

进入“设置 → 隐私与安全性 → 本地网络”核对权限。App 在首次尝试需要权限的操作前可能不在列表里。如果 Network framework 显示连接在等待,原因是 localNetworkDenied,先查权限,再改端口或重装配件。用户从设置返回后,应能重试并了解授权的用途。

根据现象选择修复方式


使用 Bonjour 时,核对浏览器查询的服务类型与主机实际广播的类型。用 NSBonjourServices 声明所用类型,并给 NSLocalNetworkUsageDescription 写清实际用途。声明不会让配件自动发布服务。如果 App 直接收发组播或广播,另查 Apple 针对该操作的授权要求。

例如,假设 App 要查找发布 _demo._tcp 的测试服务器。若连接等待且原因是 localNetworkDenied,就查授权。授权开启后,若同一网络中的另一台设备也找不到该服务,检查主机是否运行并已发布。若实验室网络能发现,访客 Wi-Fi 上却失败,先查该网络是否隔离客户端。

验证允许和拒绝两种情况


在真机分别验证拒绝与允许。拒绝时,App 应解释为何无法发现附近设备,并给用户一个可执行的下一步。允许时,确认设备出现,而且请求确实到达目标服务。各保存一条日志或测试记录。服务关闭和权限被拒也应给出不同诊断。本文依据 Apple 文档,案例为演示。

官方参考文档