如何使用Android Studio开发可扫描局域网设备的LAN Scanner应用

前置权限配置 #

权限漏申是新手开发时最容易出现“扫描结果全为空”问题的核心原因，必须在Manifest文件中配齐以下条目，适配全Android版本：

• ACCESS_WIFI_STATE：用于获取当前连接Wi-Fi的网关、子网掩码等基础网络信息
• ACCESS_NETWORK_STATE：用于区分当前网络类型，避免在蜂窝移动网络下执行无效的网段扫描
• 重点适配项：Android 8.0以上版本必须申请ACCESS_FINE_LOCATION定位权限，否则系统会屏蔽Wi-Fi网络下的设备信息读取接口，哪怕你连接的是日常使用的家庭Wi-Fi，也拿不到有效扫描结果
• Android 12及以上版本可补充申请NEARBY_WIFI_DEVICES，搭配usesPermissionFlags="neverForLocation"声明，降低用户的权限申请抵触感
• 注意：部分国产ROM（小米、OPPO、vivo）会将系统定位总开关和Wi-Fi扫描能力绑定，即使用户在应用内授予了定位权限，只要系统定位开关处于关闭状态，依然会被拦截扫描能力，需要在应用内做明确的引导提示

核心扫描逻辑实现 #

整体采用“系统缓存优先、轻量探测补漏”的混合扫描策略，比纯手动ping全网段的速度快5-8倍，准确率提升30%以上：

第一步：本地网段计算 #

首先从系统接口获取当前网络的网关地址，推导需要扫描的局域网主机范围，示例实现代码：

val wifiManager = getSystemService(Context.WIFI_SERVICE) as WifiManager
val dhcpInfo = wifiManager.dhcpInfo
// 将系统返回的网关整型值转为常见的点分十进制IP格式
val gatewayIp = Formatter.formatIpAddress(dhcpInfo.gateway)
// 取网关IP的前三段作为局域网基础段，例如网关为192.168.5.1时，基础段为192.168.5
val ipBaseSegment = gatewayIp.split(".").dropLast(1).joinToString(".")
// 生成1-254的主机扫描范围，跳过0（网络地址）和255（广播地址）的无效IP
val scanTargetList = (1..254).map { "$ipBaseSegment.$it" }

第二步：分层扫描执行 #

• 第一优先级：读取系统ARP缓存表
  日常联网过程中，系统会自动将当前局域网内有过通信的设备的IP、MAC地址写入/proc/net/arp文件，不需要额外发包就能直接拿到在线设备列表。实现方式是直接读取该路径下的文本内容，过滤掉标记为无效条目的记录（对应arp表中flags为0x0的行），这部分数据占最终扫描结果的70%以上，且无额外网络开销。
• 第二优先级：补漏探测
  针对ARP缓存中未记录的IP，使用固定并发数的线程池执行轻量探测：
  • 设置20-30个并发任务数（安卓系统下该数值为最优值，既不会因为并发太低拖慢速度，也不会触发系统的网络限流机制）
  • 对每个IP发送1秒超时的ICMP Echo请求，连通即标记为在线
  • 补充探测常见IoT、办公设备的常用开放端口（80、443、22、445等），哪怕设备禁ping，只要端口有响应就判定为在线，避免漏扫

第三步：设备信息识别 #

• 提取在线设备的MAC地址前缀（OUI字段），匹配内嵌在应用Assets目录下的离线OUI厂商库，直接标注设备硬件厂商，不需要联网请求
• 执行反向DNS查询、本地mDNS服务扫描，获取设备的自定义主机名（例如“小米扫地机器人”“客厅智能电视”），优化列表的可读性

实战踩坑优化 #

• 过滤条目去重：扫描结果中要剔除本机IP、网关IP的重复记录，避免把用户自己的手机、路由器本身当成接入设备列出来
• 后台运行适配：Android 9及以上版本会限制后台应用的网络扫描行为，扫描逻辑必须绑定前台服务，添加常驻通知，避免扫描过程中被系统强制杀进程
• 扫描耗时控制：整网段254个IP的扫描全流程要控制在3秒内完成，通过实时回调更新扫描列表，不要等全部扫描完再一次性刷新界面

功能扩展方向 #

• 基于在线设备的端口识别能力，扩展设备服务探测（例如识别开放Web管理页的路由器、开放打印服务的打印机）
• 新增陌生设备提醒能力，当检测到不在用户已标记名单内的新设备接入时，推送通知提醒用户
• 搭配本地流量统计接口，展示每个接入设备的实时带宽占用情况

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