使用QGIS WMTS加载Mapbox卫星图显示空白的问题排查请求

可能的原因 #

• WMTS配置参数不匹配
  确认WMTS连接中的图层ID为mapbox.satellite，同时检查瓦片矩阵集是否为Web Mercator（EPSG:3857）。Mapbox卫星服务仅支持该投影，若QGIS中选择了其他矩阵集，会导致请求的瓦片范围无数据，返回空白图。
• Token权限或限制
  即使Token本身正确，也要检查其权限设置：是否开启了tiles:read权限，是否设置了IP/域名白名单限制。若当前机器IP不在允许列表内，Mapbox会返回空白瓦片。可登录Mapbox账号查看Access Tokens的权限规则。
• QGIS请求格式差异
  Mapbox瓦片采用XYZ坐标规则（Y轴从顶部起始），部分WMTS配置可能默认使用TMS规则（Y轴从底部起始），导致请求的瓦片位置错误。可手动修改WMTS请求模板，确保Y坐标符合Mapbox的规则。
• 本地瓦片缓存干扰
  QGIS可能缓存了之前错误请求的空白瓦片，尝试通过设置 -> 选项 -> 网络 -> 清除缓存清理后，重新加载图层测试。

测试验证方法 #

QGIS内测试 #

1. 替代方案测试：选择图层 -> 添加图层 -> 添加XYZ瓦片图层，输入URL模板：https://api.mapbox.com/v4/mapbox.satellite/{z}/{x}/{y}.png?access_token=你的Token，若能正常显示，说明WMTS配置存在问题；若仍空白，问题大概率在Token权限或网络层面。
2. 请求URL验证：在QGIS网络面板复制完整请求URL，粘贴到浏览器打开。若浏览器也返回空白，直接使用该URL（替换Token）测试，确认是否为Token或服务端问题。

ArcMap内测试 #

按照官方指南配置ArcMap的WMTS连接并添加图层。若ArcMap能正常显示，说明问题出在QGIS的WMTS配置或版本兼容性；若同样空白，Token权限或Mapbox服务端问题的可能性更高。

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