带WMTS源（epsg:31258）的TileLayer无法加载瓦片，如何调试？

• 检查投影与范围匹配性
  源投影为EPSG:31287，视图为EPSG:3857，需确认：

  • 源的projection参数是否准确设置为'EPSG:31287'
  • 源的tileGrid参数（分辨率、原点、瓦片尺寸）是否严格匹配WMTS服务的瓦片网格，建议直接从capabilities中提取，避免手动配置误差
  • 地图视图的extent是否与WMTS服务的覆盖范围存在交集，若视图完全超出源范围，瓦片会被标记为EMPTY

• 验证WMTS URL模板有效性
  重点排查URL模板的参数正确性：

  • 确认{TileMatrix}、{TileRow}、{TileCol}等占位符与服务要求的命名一致，部分服务可能采用{z}、{y}、{x}格式，需对应调整
  • 手动替换占位符构造瓦片URL，在浏览器直接访问，验证是否能返回有效瓦片资源
  • 检查是否遗漏权限参数（如token、签名），导致请求被服务端拦截

• 排查重投影瓦片的触发逻辑
  OpenLayers的ReprojTile仅在视图需要的瓦片无法直接从源获取、且重投影可行时才会加载：

  • 利用浏览器开发者工具的Layers面板，查看当前视图的瓦片层级与坐标，对比源的瓦片网格，确认存在需重投影的瓦片
  • 检查WMTS源的wrapX设置，若服务不支持横向包裹，关闭该选项避免无效请求
  • 临时将地图视图切换为EPSG:31287，验证源本身是否能正常加载瓦片，排除源端问题

• 调试TileState.EMPTY的触发原因
  在代码中添加瓦片事件监听，跟踪状态变化：

  tileLayer.getSource().on('tileloadstart', (event) => {
    console.log('加载瓦片:', event.tile.getTileCoord());
  });
  tileLayer.getSource().on('tileloaderror', (event) => {
    console.error('瓦片加载失败:', event.tile.getTileCoord(), event.error);
  });
  

  若条件允许，可使用OpenLayers调试版本，在ReprojTile的状态更新逻辑中添加日志，定位标记为EMPTY的具体触发条件

• 确认Capabilities解析准确性
  即便本地capabilities文件内容看似正常，仍需验证：

  • 解析后的layer、matrixSet、tileMatrix等参数是否与实际服务一致
  • 尝试通过ol.format.WMTSCapabilities直接解析在线的capabilities URL，对比本地文件的参数差异，排查格式错误或参数遗漏

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