上一篇
HTTPDNSAndroidSDK常见问题索引
HTTPDNS Android SDK常见问题包括：初始化失败（检查APIKey/网络权限）、域名解析异常（确认域名配置/DNS服务器）、缓存失效（清理缓存或调整策略）、网络错误（捕获异常/重试机制）、版本兼容（更新SDK/适配系统），建议结合日志定位具体问题
常见问题说明
SDK集成后无法正常解析域名
现象：集成HTTPDNS Android SDK后，应用仍使用传统DNS解析，或解析失败。
可能原因：
- 未正确初始化SDK（如未调用
HttpDns.init()）。 - 网络权限未声明（缺少
INTERNET权限）。 - 初始化时SSL证书校验失败（如自签名证书未配置）。
解决方案：
- 确保在
Application的onCreate中调用HttpDns.init(context)。 - 检查
AndroidManifest.xml是否包含<uses-permission android:name="android.permission.INTERNET"/>。 - 若使用自建HTTPDNS服务器，需通过
HttpDns.setTrustedCert(cert)配置信任的证书。
域名解析结果与预期不符
现象：解析结果返回错误IP或解析超时。
可能原因：
- 本地缓存未及时更新（如DNS记录变更后仍返回旧IP）。
- 未正确处理网络异常（如服务器不可用）。
- 域名未在HTTPDNS控制台配置。
解决方案：
- 调用
HttpDns.flushCache()强制清除缓存，或设置合理的缓存过期时间。 - 检查网络状态，监听
HttpDns.OnResolveListener的onFailure回调。 - 登录HTTPDNS控制台,确认域名已启用HTTPDNS服务。
网络切换后解析失败
现象：从Wi-Fi切换到移动网络后，域名解析失败。
可能原因：
- SDK未自动适配网络变化。
- 移动网络未配置白名单或存在防火墙限制。
解决方案：
- 确保SDK版本支持网络自动切换（推荐升级至最新版本）。
- 检查移动网络环境是否允许访问HTTPDNS服务器。
关键问题排查表
| 问题现象 | 可能原因 | 解决步骤 |
|---|---|---|
初始化失败，抛出SSLException | 自建HTTPDNS服务器使用自签名证书，未被SDK信任 | 调用HttpDns.setTrustedCert(cert)加载证书，或禁用证书校验（非推荐） |
| 解析结果始终返回默认IP | 未正确配置域名与HTTPDNS的绑定关系，或SDK未生效 | 登录控制台绑定域名，检查SDK初始化日志确认是否成功 |
| 解析超时且无回调 | 网络权限缺失或HTTPDNS服务器不可达 | 检查网络权限，尝试用ping或curl测试HTTPDNS服务器连通性 |
| 多进程场景下解析失败 | 主进程未初始化SDK，子进程独立运行 | 在Application中初始化SDK，确保所有进程共享初始化状态 |
相关问题与解答
问题1：如何验证HTTPDNS SDK是否生效？
解答：
- 初始化后，调用
HttpDns.query("example.com")，若返回IP与HTTPDNS服务器配置一致且非本地DNS解析结果，则表明SDK生效。 - 可通过抓包工具（如Charles）观察是否向HTTPDNS服务器发送请求。
问题2：如何支持自定义DNS服务器地址？
解答：
- 在初始化前调用
HttpDns.setServerHost("custom.dns.server")指定服务器地址。 - 确保自定义服务器支持HTTPDNS协议（如
https://<server>/dns-query接口
(1).jpg)
