设置maxzoom后Mapbox raster tiles仍在11级消失，是服务器还是代码问题？

代码配置排查方向 #

• 补充tileSize参数
  Mapbox GL JS栅格数据源默认的tileSize为512像素，如果你使用的是256像素的标准瓦片，没有显式声明该参数会导致瓦片加载缩放等级和地图显示等级错位，提前出现瓦片加载失败的情况。你可以调整数据源配置如下：

map.addSource('sourceID', {
  type: 'raster',
  tiles: ['URL_TO_TILES'],
  maxzoom: 22,
  minzoom: 0,
  tileSize: 256 // 替换为你的瓦片实际像素尺寸
});

• 确认图层缩放范围限制
  你当前仅为数据源设置了缩放范围，如果额外给layerID对应图层设置过maxzoom且值小于11，也会导致图层在11级及以上自动隐藏，可排查相关配置。

服务端瓦片排查方向 #

• 确认瓦片服务实际支持的最大缩放等级
  你可以手动拼接11级的瓦片URL直接在浏览器访问，如果返回404、空资源等错误，说明你的瓦片服务本身仅生成到10级及以下的瓦片，此时你需要将数据源的maxzoom调整为瓦片服务实际支持的最大值（比如10），Mapbox会自动放大对应等级的瓦片适配更高的地图缩放，不会出现消失问题。
• 排查请求异常
  打开浏览器控制台的网络面板，查看11级瓦片请求是否存在跨域、权限校验失败、服务响应超时等问题，如有对应报错需调整瓦片服务的CORS规则、访问权限配置或服务可用性。

内容的提问来源于stack exchange，提问作者Daniel.fshr