安卓WiFi开发的核心在于精准控制连接、高效管理状态、保障安全传输，同时兼顾系统兼容性与功耗优化。
开发者需以系统权限为前提、API适配为基础、异常处理为保障，构建稳定可靠的WiFi功能模块,以下从四大维度展开专业实践路径：
权限申请：确保开发前提合规
安卓10（API 29）起，WiFi操作权限大幅收紧，必须明确区分前台/后台权限策略：
- ACCESS_WIFI_STATE：读取WiFi状态（基础权限，普通权限）
- CHANGE_WIFI_STATE：开关WiFi、连接热点（危险权限，需运行时申请）
- ACCESS_FINE_LOCATION：扫描WiFi列表必需（安卓9+强制要求）
- NEARBY_DEVICES（安卓11+）：用于Wi-Fi Direct连接，替代旧版BLUETOOTH权限
⚠️ 注意：若未正确申请定位权限，
getScanResults()将返回空列表,导致功能失效。
核心操作：四大高频场景实现方案
扫描与连接
- 扫描触发：调用
WifiManager.getScanResults()前，必须先启动startScan()，并注册BroadcastReceiver监听SCAN_RESULTS_AVAILABLE_ACTION - 连接策略：
- 预配置网络（
WifiConfiguration）适用于固定SSID/PWD场景 - 动态连接（
addNetwork()+enableNetwork()）需处理返回的networkId，失败时自动重试≤3次 - 优先使用
WifiManager.connect()而非enableNetwork()，避免重复连接冲突
- 预配置网络（
网络状态监听
- 实时监听：注册
ConnectivityManager.NetworkCallback（API 21+）替代旧版NetworkInfo - 关键事件：
networkCallback = new NetworkCallback() { @Override public void onAvailable(Network network) { / 已连接 / } @Override public void onLost(Network network) { / 断开 / } }; connectivityManager.registerDefaultNetworkCallback(networkCallback);
WiFi Direct（P2P）开发
- 初始化：
WifiP2pManager+Channel，必须在主线程外执行所有操作 - 设备发现：调用
discoverPeers()后监听WIFI_P2P_PEERS_CHANGED_ACTION - 连接流程：
connect()传入WifiP2pConfig- 监听
WIFI_P2P_CONNECTION_CHANGED_ACTION - 成功后通过
WifiP2pInfo.groupOwnerAddress建立Socket通信
热点（SoftAP）管理
- Android 10+已限制非系统应用创建热点，仅支持读取状态
- 兼容方案：
- 通过
WifiManager.setWifiApEnabled()（反射调用，高风险） - 或引导用户跳转系统设置页（
Settings.ACTION_WIFI_SETTINGS） - 推荐方案：使用
WifiManager.startLocalOnlyHotspot()（API 26+），但仅限本地通信，无法联网
- 通过
异常处理：提升稳定性三大关键点
-
连接失败重试机制：
- 每次连接失败后等待500ms再重试，累计失败3次后提示用户检查密码
- 使用
WifiManager.saveConfiguration()前务必验证配置有效性
-
权限缺失兜底：
- 在
onResume()中检测定位权限，缺失时弹出系统授权对话框 - 对Android 11+设备，额外检查
MANAGE_ALL_FILES_ACCESS_PERMISSION（若需保存扫描结果）
- 在
-
内存泄漏防护：
- 所有BroadcastReceiver必须在
onDestroy()中注销 - 使用
WeakReference包装回调对象
- 所有BroadcastReceiver必须在
性能与体验优化
- 功耗控制：
- 扫描间隔≥5秒（
setScanAlwaysAvailable(false)） - 连接后及时关闭
WifiManager.startScan()
- 扫描间隔≥5秒（
- 兼容性策略：
- Android 10+：使用
WifiManager.getConnectionInfo()获取BSSID替代SSID（隐私限制） - 华为/小米定制系统：部分机型需添加白名单（如
Settings.Secure.WIFI_MULTI_STA_ENABLED）
- Android 10+：使用
- 用户引导优化：
- 断连时提示“请确认路由器是否开启”
- 连接超时（>15秒）自动弹出重试按钮
相关问答
Q：安卓12+如何绕过定位权限扫描WiFi？
A：无法绕过，Android 12（API 31）延续定位权限要求，唯一例外是使用WifiManager.getContex().getSystemService(WifiManager.class).getScanResults()配合ACCESS_BACKGROUND_LOCATION（需用户手动开启后台定位）。
Q：为什么addNetwork()返回-1？
A：常见原因：① 网络已存在（需先removeNetwork()）；② 系统限制（如企业网络策略）；③ Android 10+未正确处理WPA3加密格式，建议改用WifiNetworkSpecifier（API 29+）实现更安全的连接。
你是否遇到过特定机型WiFi连接异常？欢迎在评论区分享你的解决方案！
首发原创文章，作者：世雄 - 原生数据库架构专家，如若转载，请注明出处：https://idctop.com/article/170821.html
