Flutter安卓（小米MIUI）：.local mDNS主机名解析SocketException故障

问题背景 #

我正在开发一款Flutter应用，用于通过Wi-Fi发现本地设备并调用其本地REST API。该流程在其他安卓设备上正常运行，但在小米/红米（MIUI）设备上，.local主机名的DNS解析失败，导致本地模式无法使用。虽然使用直接IP地址可以正常工作，但由于IP可能随DHCP/网络变化而改变，我希望使用主机名。

错误日志 #

[RESPONSE] [REST REQUEST] ************* ERROR *************
           {
             "method": "GET",
             "url": "https://type-macaddres.local/...",
             "stage": "connection",
             "error": "SocketException: Failed host lookup: 'type-macaddres.local' (OS Error: No address associated with hostname, errno = 7)",
             "mappedError": {
               "url": "https://type-macaddres.local/...",
               "statusCode": 503,
               "description": "Failed host lookup: 'type-macaddres.local'",
               "type": "ConnectionError",
               "errors": {
                 "code": 503,
                 "message": "Failed host lookup: 'type-macaddres.local'"
               }
             }
           }
           *********************************

使用的依赖及配置 #

• nsd包：用于服务发现（DNS-SD/mDNS），服务类型如_name_secondaname._tcp
• dart:io HttpClient：用于REST请求
• connectivity_plus：用于连接状态检测
• 发现配置：autoResolve: true 和 ipLookupType: IpLookupType.any

示例发现调用代码 #

final discovery = await startDiscovery(
  '_name_secondaname._tcp.',
  autoResolve: true,
  ipLookupType: IpLookupType.any,
);

上下文信息 #

• Flutter安卓应用
• 请求地址格式：http(s)://<device-name>.local/...
• 仅在小米/红米（MIUI）设备上出现失败情况，测试设备为小米Redmi 8T

已检查项 #

• 安卓权限：已配置INTERNET、ACCESS_NETWORK_STATE、CHANGE_WIFI_MULTICAST_STATE
• 检查过Private DNS开关状态
• 已禁用MIUI电池/数据限制
• 已设置ipLookupType: any

问题 #

1. 这是Flutter/Dart HttpClient在MIUI上解析.local主机名的已知限制吗？
2. 在小米设备上，使用直接IP是唯一可靠的方案吗？
3. 有没有针对小米的可靠解决方法可以修复mDNS主机名解析问题？

注：我已配置所有清单权限，尝试了所有能找到的方法但均无效。

解答 #

1. 是否为已知限制？ #

是的，这是MIUI系统对mDNS解析的特殊限制导致的，并非Flutter/Dart HttpClient本身的问题。MIUI默认修改了系统DNS解析逻辑，会优先使用公共DNS而非本地mDNS服务来解析.local域名，从而导致解析失败。

2. 直接IP是唯一可靠方案吗？ #

不是唯一方案，但确实是最稳定的备选方案。不过可以通过其他手段绕过MIUI的限制，无需依赖动态变化的IP地址。

3. 可行的解决方法 #

方法一：利用nsd包的解析结果直接获取IP

既然已经使用nsd包完成了服务发现且配置了autoResolve: true，服务发现结果中应该已经包含了目标设备的IP地址。可以直接使用该IP构造请求URL，绕过系统DNS解析：

// 假设discovery返回的服务实例为service
final url = Uri.parse('https://${service.host}/...');
// 后续使用该URL发起请求

方法二：通过平台通道调用安卓原生解析

可以通过Flutter平台通道（MethodChannel）调用安卓原生API，使用系统原生的InetAddress.getByName("<device-name>.local")获取IP，避免Dart HttpClient使用MIUI修改后的DNS逻辑：

1. 在安卓原生端编写解析方法，调用原生API获取IP
2. 在Flutter端通过MethodChannel调用该方法，拿到IP后构造请求URL

方法三：引导用户修改MIUI DNS设置

部分MIUI版本中，开启Private DNS会强制使用公共DNS导致mDNS解析失效，可引导用户将Private DNS设置为自动或关闭。此方法需要用户手动操作，仅作为备选方案。

内容的提问来源于stack exchange，提问作者Reborned BBIAJ