iOS 13及以上MKTileOverlay离线瓦片偶尔无法渲染问题求助

我之前在适配iOS13的时候也碰到过几乎一模一样的问题，大概率这是iOS13及以后MapKit的一个已知bug——苹果在iOS13中重构了MapKit的部分渲染逻辑，导致Tile Overlay的加载缓存机制在某些场景下出现异常，尤其是后台切换回来前的瓦片渲染会被莫名跳过。

从你描述的现象（iOS12及以下正常、退后台再返回恢复、两个Overlay都受影响）来看，完全符合这个bug的表现。下面给你几个亲测有效的临时解决方案：

解决方案1：前台激活时强制刷新Overlay #

最简单的办法是在应用从后台回到前台时，触发MapView重新渲染所有Tile Overlay。你可以在SceneDelegate的sceneDidBecomeActive(_:)或者AppDelegate的applicationDidBecomeActive(_:)里添加这段代码：

// 假设你已经持有mapView的引用
for overlay in mapView.overlays {
    if let tileRenderer = mapView.renderer(for: overlay) as? MKTileOverlayRenderer {
        tileRenderer.setNeedsDisplay()
    }
}

如果上面的轻量刷新没用，也可以尝试重新添加Overlay（虽然麻烦一点，但更彻底）：

// 先移除所有现有Overlay
mapView.removeOverlays(mapView.overlays)
// 重新创建并添加你的瓦片Overlay
let tileOverlay = MKTileOverlay(urlTemplate: yourUrlTemplate)
tileOverlay.canReplaceMapContent = true
tileOverlay.maximumZ = 19
mapView.insertOverlay(tileOverlay, at: 0, level: .aboveLabels)
// 重新添加你的网格Overlay
let gridOverlay = YourCustomGridOverlay() // 替换成你的网格Overlay实例
mapView.insertOverlay(gridOverlay, at: 1, level: .aboveLabels)

解决方案2：自定义Tile加载逻辑，绕过系统缓存 #

系统默认的MKTileOverlay加载逻辑在iOS13+可能存在缓存异常，你可以自定义子类，手动管理瓦片加载，避开系统的问题：

class CustomLocalTileOverlay: MKTileOverlay {
    override func loadTile(at path: MKTileOverlayPath, result: @escaping (Data?, Error?) -> Void) {
        // 根据瓦片路径拼接本地文件路径，这里根据你的实际存储结构调整
        guard let tileFilePath = Bundle.main.path(
            forResource: "\(path.x)_\(path.y)",
            ofType: "png",
            inDirectory: "OfflineTiles/\(path.z)"
        ) else {
            result(nil, NSError(domain: "TileLoadError", code: -1, userInfo: [NSLocalizedDescriptionKey: "瓦片不存在"]))
            return
        }
        
        do {
            let tileData = try Data(contentsOf: URL(fileURLWithPath: tileFilePath))
            result(tileData, nil)
        } catch {
            result(nil, error)
        }
    }
}

用这个自定义子类替代默认的MKTileOverlay，可以完全掌控瓦片加载过程，减少系统缓存导致的空白问题。

解决方案3：调整Overlay的层级设置 #

有时候把Overlay的层级从.aboveLabels改成.aboveRoads或者.belowLabels，也能意外解决问题——iOS13+对不同层级的Overlay渲染优先级做了调整，可能你的层级设置刚好触发了渲染跳过的逻辑。

另外补充一句：苹果在iOS14及以后的版本中修复了不少MapKit的Tile渲染问题，如果你的应用可以放弃iOS13早期版本的支持，升级到更高版本的系统可能是一劳永逸的办法。

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