Android 11+无线调试需先启用开发者选项、USB调试和无线调试开关，再通过adb pair与adb connect配对连接；HermesAgent正常工作还需App启用Hermes引擎、Debug模式运行，并确保Chrome DevTools或Flipper成功连接调试服务器。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在 Android 11 及更高版本中，无线调试（Wireless Debugging）已取代旧版 ADB over Wi-Fi，成为官方推荐的无线调试方式。HermesAgent 是 React Native 调试体系中的关键组件，负责 JS 线程与原生线程间的通信。要使其在无线调试模式下正常工作，必须确保设备端调试环境完整启用，而不仅仅是打开“无线调试”开关。
开启开发者选项与无线调试基础设置
先确认设备已启用开发者选项：连续点击“关于手机”→“版本号”7次。随后进入“设置 → 系统 → 开发者选项”，开启以下三项：
- USB 调试（部分设备要求先启用才能激活无线调试）
- 无线调试（主开关，开启后会提示配对码和 IP:Port）
- 通过网络启用 ADB（部分厂商定制系统需单独开启，如小米、华为）
配对设备并建立稳定 ADB 连接
无线调试启用后，设备会显示一个临时配对码和监听地址（如 192.168.1.105:42103）。此时需在开发机执行：
adb pair 192.168.1.105:42103 # 输入屏幕上显示的6位配对码 adb connect 192.168.1.105:42103
成功后运行 adb devices 应显示 device 状态。若显示 unauthorized，请检查设备弹出的授权弹窗是否已允许；若连接失败，请确认设备与电脑在同一局域网，且防火墙未拦截端口。
确保 Hermes 引擎与调试服务协同工作
HermesAgent 不是独立进程，而是由 React Native 启动时按需加载的 JS 运行时模块。无线调试生效的前提是：
- App 使用的是 Hermes 引擎（
hermesEnabled: true在android/app/build.gradle中配置） - 调试模式启动（
react-native run-android --variant=debug或摇动设备调出菜单 → “Debug”） - Chrome DevTools 或 Flipper 已连接至
http://localhost:8081/debugger-ui，且控制台无Hermes is not available报错
若 HermesAgent 未响应，可尝试在 App 启动后立即执行：adb shell am broadcast -a com.facebook.react.DEBUG_SERVER_HOST -e DEBUG_SERVER_HOST "192.168.1.105:8081"，手动注入调试服务器地址。
常见问题速查
• 设备重启后无线调试自动关闭？→ 需重新开启“无线调试”开关，配对信息不持久
• Flipper 显示 “No Hermes instance found”？→ 检查是否启用了 Hermes，以及是否在 Debug 构建下运行
• Chrome 调试器断连频繁？→ 关闭设备省电模式，禁用“优化电池使用”对 adb 和 App 的限制
