UWP中如何使用OSM离线地图？无网络连接时的黑屏问题

看起来你的本地瓦片服务器本身是正常工作的（无WiFi时浏览器能访问），问题出在应用使用HttpMapTileDataSource访问本地服务器的环节上。下面是几个针对性的排查和解决方向：

1. 检查应用的网络权限与传输安全配置 #

很多平台在无网络状态下，会对本地HTTP请求有默认限制，或者需要额外配置允许明文请求：

• Android平台：
  • 确保AndroidManifest.xml中声明了<uses-permission android:name="android.permission.INTERNET" />权限。
  • Android 9及以上版本，默认禁止明文HTTP请求，需要在AndroidManifest.xml的<application>标签中添加android:usesCleartextTraffic="true"，或者创建network_security_config.xml文件，允许127.0.0.1的明文请求：

    <?xml version="1.0" encoding="utf-8"?>
    <network-security-config>
        <domain-config cleartextTrafficPermitted="true">
            <domain includeSubdomains="true">127.0.0.1</domain>
        </domain-config>
    </network-security-config>
    

• iOS平台：
  • 在Info.plist中添加NSAppTransportSecurity配置，允许本地网络访问：

    <key>NSAppTransportSecurity</key>
    <dict>
        <key>NSAllowsLocalNetworking</key>
        <true/>
    </dict>
    

  如果需要更精细的控制，可以添加NSExceptionDomains允许127.0.0.1的HTTP请求。

2. 调整HttpMapTileDataSource的配置 #

部分地图SDK默认会在无网络时禁用远程数据源（哪怕是本地服务器），或者没有启用缓存：

• 强制允许离线访问：查看你使用的地图SDK文档，是否有类似allowOffline的配置项，强制数据源在无网络时仍发起请求。比如某些SDK的代码示例：

  var dataSource = new HttpMapTileDataSource(newTileInfo, serverUrl);
  // 假设SDK有此属性，开启离线允许
  dataSource.AllowOffline = true;
  

• 配置本地瓦片缓存：给数据源添加本地缓存，这样瓦片加载一次后就会存在本地存储，无网络时直接读取缓存，无需请求服务器。比如：

  var tileCache = new FileTileCache(Environment.GetFolderPath(Environment.SpecialFolder.LocalApplicationData), "local_map_tiles");
  dataSource.Cache = tileCache;
  

• 延长请求超时时间：无网络时系统的网络调度可能有延迟，适当延长超时时间避免请求被提前判定失败。

3. 验证本地服务器与URL的正确性 #

• 确认本地瓦片服务器绑定的是0.0.0.0而不是特定的WiFi网卡IP，这样即使WiFi关闭，回环地址127.0.0.1仍能正常访问服务器。
• 打印你生成的serverUrl，在无WiFi时用浏览器访问这个完整URL，确认能返回瓦片图片。如果URL有格式错误（比如缺少瓦片的z/x/y参数），也会导致请求失败。

4. 测试应用内的网络请求 #

如果上面的配置都没问题，可以在应用内单独写一个简单的HTTP请求，访问本地服务器的瓦片URL，看是否能正常获取数据：

using (var client = new HttpClient())
{
    var response = await client.GetAsync(serverUrl);
    if (response.IsSuccessStatusCode)
    {
        var content = await response.Content.ReadAsByteArrayAsync();
        // 验证content是否是有效的图片数据
    }
}

如果这个请求能成功，说明是地图SDK的数据源配置问题；如果失败，说明应用的网络访问被系统限制，需要回到第一步检查权限。

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