iOS设备上无法成功运行Flutter HTTP服务器的排查求助

问题背景 #

基于Dart的HttpServer实现的本地服务，在Android设备上可通过局域网正常访问，但在iPhone12（iOS 16.0.2）上出现连接超时：

• curl访问8080端口超时，其他未占用端口直接提示连接拒绝
• 设备局域网IP可正常ping通
• 已在Info-Debug.plist和Info-Release.plist添加NSLocalNetworkUsageDescription和NSBonjourServices配置，但无效

排查建议 #

1. 修正HttpServer绑定地址

确保代码中HttpServer绑定的是所有网卡地址，而非本地回环地址：

// 错误写法（仅本地可访问）
await HttpServer.bind('localhost', 8080);
// 正确写法（允许局域网设备访问）
await HttpServer.bind(InternetAddress.anyIPv4, 8080);

绑定InternetAddress.anyIPv4会监听设备所有网络接口的请求，确保局域网设备能连接到服务。

2. 完善iOS网络权限配置

• 确认本地网络权限已授权：进入iOS「设置-隐私与安全性-本地网络」，找到你的App并开启权限。仅添加plist描述而未授权，权限仍不生效。
• 添加NSAllowsLocalNetworking键：在Info.plist中加入以下配置，强制允许本地网络访问：

<key>NSAllowsLocalNetworking</key>
<true/>

• 检查防火墙状态：若设备开启了「设置-通用-VPN与设备管理-防火墙」，尝试关闭后测试连接。

3. 端口与沙箱检查

• 更换端口测试：8080端口可能被iOS系统或其他App占用，尝试切换到8082、9000等端口，确认是否是端口占用导致的监听失败。
• 验证服务器绑定状态：在代码中打印服务器启动日志，确认HttpServer成功绑定目标端口：

final server = await HttpServer.bind(InternetAddress.anyIPv4, 8080);
print('Server running on ${server.address}:${server.port}');

4. 网络环境排查

• 确认同局域网同VLAN：测试设备与iOS设备需处于同一局域网的同一网段，避免路由器访客网络与主网络隔离的情况。
• 关闭AP隔离：检查路由器设置中的「AP隔离」功能，若开启会阻止局域网内设备互相通信，需关闭该选项。

5. 代码逻辑验证

• 确保HttpServer实例未被意外销毁：检查异步逻辑，避免服务器启动后被提前关闭（如未正确持有server实例）。
• 验证请求处理逻辑：确保服务器能正常响应请求，可在iOS设备本地用http://localhost:8080/helloworld测试，确认服务本身正常运行。

内容的提问来源于stack exchange，提问作者Sora Shiro