Maptiler下载的MBTiles转OSM XYZ瓦片异常的原因及解决方法

元数据/格式差异点 #

• 瓦片数据格式不匹配：你使用的Maptiler MBTiles文件，其元数据里的format字段大概率不是png，可能是webp或其他压缩格式。而你用的Python代码默认将导出文件存为.png后缀，但实际写入的是原格式的二进制数据，导致系统无法识别图片属性。对比之下，示例的countries-raster.mbtiles的format字段就是标准png，所以代码能正常工作。
• 瓦片数据被压缩存储：部分MBTiles会对瓦片数据做gzip压缩处理（符合MBTiles规范的可选压缩），你的代码没有做解压操作，直接把压缩后的二进制数据写入文件，导致图片文件损坏，缺失尺寸、位深度等关键信息。

修复步骤 #

1. 确认MBTiles的实际格式
   用SQLite工具打开Maptiler的MBTiles文件，执行查询语句查看格式：

   SELECT value FROM metadata WHERE name='format';
   

   同时可以检查是否有压缩标记：

   SELECT value FROM metadata WHERE name='compression';
   

2. 修改Python代码适配格式

   • 如果查询到format是webp：要么将导出文件的扩展名改为.webp（后续Leaflet加载时对应修改瓦片URL模板），要么在代码中用Pillow库将WebP数据转换为PNG后再写入文件。
   • 如果存在compression为gzip：在读取瓦片二进制数据后，先进行解压处理，示例代码片段：

     import gzip
     # 原代码读取blob_data后添加：
     if compression == 'gzip':
         blob_data = gzip.decompress(blob_data)
     

3. 验证导出结果
   修改代码后重新导出，查看图片文件的属性，确认尺寸、位深度等信息正常，再用Leaflet加载测试。

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