在OpenLayers本地加载PBF矢量瓦片时遇Unimplemented type 4错误求助

核心问题：混淆了两种完全不同的PBF格式 #

你直接从OpenStreetMap下载的是OSM原生PBF格式（存储OSM节点、道路、关系等原始数据），而OpenLayers的MVT格式只支持Mapbox Vector Tile规范的PBF瓦片——这两种格式结构完全不兼容，所以才会抛出Unimplemented type: 4错误。

正确处理流程 #

你需要先把OSM原生PBF转换为符合MVT规范的矢量瓦片，再用OpenLayers加载。以下是两种可行方案：

方案1：用tippecanoe快速生成MVT瓦片 #

tippecanoe是专门用于将地理数据转成MVT的工具，操作简单：

1. 安装tippecanoe：
   • macOS：brew install tippecanoe
   • Linux：通过对应发行版的包管理器安装，或从源码编译
   • Windows：使用WSL2安装
2. 将OSM PBF转成mbtiles格式：

   tippecanoe -o korea.mbtiles --drop-densest-as-needed south-korea-latest.osm.pbf
   

   （south-korea-latest.osm.pbf是你下载的韩国地区OSM原始PBF文件）
3. （可选）将mbtiles转成z/x/y目录结构：
   用mb-util工具转换：

   mb-util --image_format=pbf korea.mbtiles ./korea-mvt-tiles
   

   转换后得到的./korea-mvt-tiles/{z}/{x}/{y}.pbf就是OpenLayers能识别的MVT瓦片。

方案2：用osm2vectortiles生成规范化图层（适合生产环境） #

如果你需要将OSM数据按图层（道路、建筑、POI等）拆分，可以用osm2vectortiles项目（基于Docker），它能生成符合标准的MVT瓦片，步骤如下：

1. 安装Docker及Docker Compose
2. 克隆项目并运行：

   git clone https://github.com/osm2vectortiles/osm2vectortiles.git
   cd osm2vectortiles
   docker-compose up
   

3. 将你的韩国OSM PBF文件放入指定目录，按照文档配置生成对应的MVT瓦片或mbtiles。

OpenLayers代码修正 #

确保你的代码指向正确的MVT瓦片路径，坐标系保持Web Mercator（EPSG:3857，OpenLayers默认），现有代码结构没问题，只需替换瓦片路径：

const test1 = new VectorLayer({
    source: new VectorSource({
        format: new MVT(),
        url: './korea-mvt-tiles/{z}/{x}/{y}.pbf', // 替换为转换后的MVT瓦片目录
    }),
});

之前尝试失败的原因 #

你之前用MButil转换失败，是因为MButil只能在mbtiles和目录结构之间转换格式，但你输入的不是MVT格式的PBF，所以转换后依然无法被OpenLayers识别。必须先完成OSM PBF到MVT的转换，再进行格式转换。

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