经纬志
首页 / OpenLayers / 使用示例

瓦片错误处理

底图服务偶发 404 或跨域失败时,tileloaderror 是唯一可靠信号;监听它才能做降级或重试。

OpenLayers 10.3.1 · 更新 2026-10-28
源码与运行效果
运行效果

说明

tileloaderror 事件在单块瓦片请求失败时触发,回调里的 tile.getTileCoord() 给出 [z, x, y] 编号。 示例的「模拟故障」按钮把底图源换成无效域名,触发连续失败; 「恢复底图」把源换回 ol.source.OSM,同一位置不刷新页面即可恢复显示。

操作结果
点击「模拟故障」瓦片空白,失败计数增加并列出编号
点击「恢复底图」重新请求正常瓦片,画面恢复
点击「清空记录」错误列表与计数归零

切换数据源会造成全部瓦片重载,生产中更常用的是降级到备用地址再配合退避重试。