UnknownHostException表明域名无法解析为IP地址，常见原因包括DNS劫持、运营商LocalDNS故障、应用配置错误或系统DNS缓存污染；应依次验证解析一致性、切换公共DNS、启用HTTPDNS、检查权限与网络配置、刷新DNS缓存。
如果您在Android设备上访问网络时遇到UnknownHostException异常，该异常表明系统无法将域名解析为IP地址。这并不必然意味着DNS被劫持，但DNS劫持确实是常见诱因之一。以下是多种可能原因及对应排查与修复方法：
一、验证是否为DNS劫持导致的解析失败
运营商LocalDNS存在主动劫持NXDOMAIN响应、返回虚假IP或缓存污染的风险，尤其在公共Wi-Fi或特定移动网络下高发。可通过命令行比对解析结果确认是否存在劫持行为。
1、连接电脑并启用ADB调试模式，确保设备已授权USB调试。
2、在终端执行：adb shell nslookup gzhuoli.com，记录返回的A记录IP地址。
3、在同一网络环境下，使用PC执行nslookup gzhuoli.com 8.8.8.8（直连Google DNS），比对IP是否一致。
4、若两者IP不同，或Android端返回空/错误IP/超时，而PC端可正常解析，则高度提示存在LocalDNS劫持或故障。
二、切换至可信公共DNS服务
绕过不可信的运营商DNS，强制应用使用加密或公开可信的DNS服务器，可规避劫持与解析异常。
1、在Android 9及以上版本中，在应用的AndroidManifest.xml的<application>标签内添加：android:usesCleartextTraffic="true"（仅当后端仍使用HTTP且未配置HTTPS时必需）。
2、调用系统API设置私有DNS（Private DNS）：进入「设置 → 网络和互联网 → 高级 → 私有DNS」，输入dns.google或1.1.1.1。
3、若需代码层控制，可在初始化网络请求前调用：DnsResolver.getInstance(context).setDnsServers(new String[]{"8.8.8.8", "1.1.1.1"});（需适配目标Android版本及权限）。
三、启用HTTPDNS替代系统DNS解析
HTTPDNS通过HTTPS协议直接向权威DNS服务商发起查询，完全绕过系统LocalDNS链路，从根本上杜绝运营商劫持与缓存污染。
1、集成阿里云HTTPDNS SDK或腾讯云HTTPDNS SDK，按官方文档完成初始化与Token配置。
2、在发起网络请求前，调用httpDns.getIpByHostAsync("gzhuoli.com", callback)异步获取真实IP。
3、将原始URL中的域名替换为返回的IP地址，构造新URL（如https://103.224.222.222/api），并设置Host头为原域名以满足SNI与虚拟主机要求。
4、对HTTPDNS查询结果实施本地缓存与TTL管理，避免重复查询与过期IP误用。
四、检查应用级网络配置与权限
Android系统级限制（如明文流量禁用、网络权限缺失、私有DNS配置冲突）会导致DNS查询在框架层即被拦截，表现为看似“解析失败”的UnknownHostException。
1、确认AndroidManifest.xml中已声明：<uses-permission android:name="android.permission.INTERNET" />。
2、若目标域为HTTP且Android 9+，必须在<application>中添加：android:usesCleartextTraffic="true"；否则netd可能丢弃明文DNS查询包。
3、检查是否启用了StrictMode或自定义NetworkSecurityConfig，禁止了非加密DNS查询路径。
4、若设备已配置Private DNS（如dns.adguard.com），但该服务器不可达，Android 12+会全局拒绝所有DNS解析——此时需临时关闭私有DNS验证是否恢复。
五、强制刷新系统DNS缓存与网络状态
Android系统维护独立的DNS缓存（位于netd进程），缓存污染或陈旧条目可能导致持续解析失败，即使网络已恢复正常。
1、重启设备，触发netd守护进程重建DNS配置与缓存。
2、在具备root权限的设备上执行：adb shell su -c "setprop net.dns1 8.8.8.8 && setprop net.dns2 1.1.1.1"，重置系统DNS服务器。
3、断开当前Wi-Fi，开启飞行模式5秒后再关闭，强制ConnectivityManager刷新网络绑定的DnsResolver实例。
4、对应用进程执行冷启动：在「设置 → 应用 → [您的应用] → 强制停止」，再重新打开，确保加载最新DNS配置。
