React Native如何检测本地网络权限状态并跳转至设置页

TypeError: null is not an object (evaluating 'RNLocalNetworkPermission.check') 是第三方库原生模块未正确链接导致的，常见触发场景：

• React Native 0.60+ 版本未执行iOS端pod安装，原生依赖未拉取
• 库版本与当前RN版本不兼容，自动链接失效
• iOS项目最低部署版本低于14.0（本地网络权限是iOS14才新增的系统API）
• 两端未配置对应的权限声明，导致库初始化失败

方案1：修复现有第三方库的使用问题 #

按以下步骤逐一校验配置：

1. iOS端配置

• 进入项目ios目录，执行pod install --repo-update拉取最新原生依赖
• 打开Xcode，在项目Info.plist中添加必填权限配置：

<key>NSLocalNetworkUsageDescription</key>
<string>需要访问本地网络以连接同局域网下的设备</string>
<key>NSBonjourServices</key>
<array>
  <!-- 替换为自身业务使用的Bonjour服务标识，例如_yourapp._tcp -->
  <string>_yourapp._tcp</string>
</array>

• 将iOS项目最低部署版本调整为14.0及以上，执行Xcode clean后重新编译

2. 安卓端配置

• 在android/app/src/main/AndroidManifest.xml中添加必要权限声明：

<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.INTERNET" />

• 执行cd android && ./gradlew clean清理缓存后重新打包
  配置完成后即可正常调用库的check()方法：返回granted代表权限已授予，可正常使用本地网络能力；返回denied代表权限被拒绝，直接调用Linking.openURL('app-settings:')跳转到应用设置页引导用户手动开启即可。

方案2：原生轻量实现（无第三方库依赖，推荐） #

如果第三方库维护不及时、修复后仍存在兼容问题，可以直接通过系统原生逻辑实现，不需要额外引入依赖：

• iOS端：iOS14以下版本默认授予本地网络权限，无需检测；iOS14及以上版本，可在首次触发本地网络访问（例如Bonjour服务广播、局域网IP扫描）时，捕获系统抛出的权限错误，一旦捕获到无权限报错，直接弹出提示引导用户跳转设置。注意iOS系统的本地网络权限弹窗仅会在用户首次触发相关能力时弹出1次，用户拒绝后后续不会再主动弹窗，必须引导用户手动到设置页开启，这是系统级限制，无法绕过。
• 安卓端：安卓系统不存在单独的本地网络权限开关，只要在Manifest中声明上述网络相关权限，即可正常访问本地网络，无需做额外的权限状态检测。

注意：不要在应用启动时就触发权限检测，会触发iOS的权限弹窗，最佳实践是在用户真正用到需要本地网络的功能时再触发检测和权限申请，符合应用商店审核要求。

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