简介本资源面向需要在 GeoServer 中发布 ArcGIS 瓦片服务的 GIS 开发者与运维人员尤其适合已有一定地图服务基础、希望打通切片发布链路的中高级用户。包内共 1571 个文件以 png 切片、jar 依赖库、xml 配置、prj 投影文件、sld 样式、shp/dbf/shx 矢量数据及 pgw 坐标文件为主另含 properties、bat 启停脚本与日志等运行支撑文件压缩包约 137.36MB目录结构完整可直接部署验证。已有 1090 人学习下载说明该方案在实际项目中具备较高参考价值。读者可据此快速搭建可运行的瓦片发布环境理解切片目录组织、样式配置与投影参数设置并借助日志与配置文件排查发布过程中的常见问题减少从零摸索的时间成本。1. 当你的瓦片服务卡在坐标系上GeoServer 发布 ArcGIS 瓦片这件事手里有一批 ArcGIS 切好的瓦片可能是别人交付的也可能是历史项目遗留下来的现在要把它挂到 GeoServer 上对外提供服务。听起来像是把文件夹丢进去点两下就能完事但真正动手的人都知道坐标系对不上、瓦片层级错位、切片方案不匹配随便一个都能让你在预览页面看到一片空白。这个资源解决的就是这类问题让 GeoServer 能够正确识别并发布 ArcGIS 格式的瓦片包括松散型瓦片目录和紧凑型切片包。适合谁适合手里有 ArcGIS 瓦片数据、需要迁移到开源 GIS 服务栈的从业者也适合想搞清楚 GeoServer 瓦片发布底层逻辑的开发者。接下来我会把整个流程拆开从原理到参数再到踩坑一步步走完。2. 先搞懂 GeoServer 认瓦片的逻辑为什么不能直接丢进去2.1 GeoServer 的瓦片发布机制与 ArcGIS 瓦片的差异GeoServer 本身有一套瓦片缓存体系叫 GeoWebCache它支持多种瓦片格式的读写。但 ArcGIS 的瓦片和 GeoServer 自己切出来的瓦片在目录结构、元数据描述、坐标系定义上都有差异。ArcGIS 的松散型瓦片通常按L00/R00000000/C00000000.png这样的层级组织而 GeoServer 的 GeoWebCache 默认用的是EPSG_3857/z/x/y这种结构。如果你直接把 ArcGIS 的瓦片目录丢进 GeoServer 的缓存目录它大概率不认识。关键差异在于切片方案的定义。ArcGIS 的切片方案包含分辨率层级、比例尺、瓦片尺寸、原点坐标等信息这些信息通常记录在conf.xml或者Conf.cdi文件里。GeoServer 需要把这些信息翻译成自己的 GridSet 配置才能正确计算每个瓦片对应的地理范围。如果 GridSet 配错了预览时要么瓦片错位要么直接 404。另一个容易被忽略的点是坐标系。ArcGIS 瓦片常用的坐标系有EPSG:4326、EPSG:3857也有用地方坐标系的。GeoServer 在发布时需要明确指定 native CRS 和 declared CRS两者不一致时还要做投影转换。但瓦片本身是预切好的GeoServer 不会重新投影瓦片它只是按照 GridSet 的定义去拼接。所以如果 GridSet 的原点、分辨率、瓦片尺寸和 ArcGIS 切片方案对不上拼出来的地图就是歪的。2.2 准备工作确认瓦片类型与目录结构在动手之前先确认你手里的瓦片是松散型还是紧凑型。松散型就是一堆 png 或 jpg 文件按层级放在文件夹里紧凑型则是打包成.bundle文件。GeoServer 对两者的支持方式不同松散型可以直接通过 GeoWebCache 的磁盘缓存来识别紧凑型则需要额外的插件或者转换步骤。常见做法是先看一眼目录结构。如果是松散型你会看到类似这样的层级L00/ R00000000/ C00000000.png C00000001.png L01/ R00000000/ C00000000.png ...如果是紧凑型你会看到.bundle文件和conf.xml。确认之后还需要找到切片方案的配置文件。ArcGIS 通常会在瓦片目录的上一级或者同级放一个conf.xml里面记录了TileOrigin、LODInfos等信息。这个文件是后续配置 GridSet 的依据没有它就只能靠猜而猜错的代价就是瓦片对不上。提示如果找不到conf.xml可以尝试从 ArcGIS 的切片方案文件.xml中提取信息或者用已知的坐标系和层级反推。但反推有风险最好还是找到原始配置。3. 把 ArcGIS 瓦片挂到 GeoServer从 GridSet 到预览的完整操作3.1 创建自定义 GridSet让 GeoServer 认识你的切片方案GeoServer 的 GridSet 是瓦片发布的核心。你需要根据 ArcGIS 切片方案里的参数在 GeoServer 里新建一个 GridSet。登录 GeoServer 管理界面进入Tile Caching-Grid Sets-Create a new grid set。关键参数包括CRS选择与 ArcGIS 切片方案一致的坐标系比如EPSG:3857。Tile originArcGIS 的切片原点通常是左上角坐标值需要从conf.xml里的TileOrigin读取。常见的是-20037508.34278925, 20037508.34278925对于 3857。Tile size通常是 256x256但也可能是 512x512必须和实际瓦片尺寸一致。Resolution levels每一层的分辨率需要和 ArcGIS 的 LOD 对应。你可以手动输入也可以从conf.xml里的LODInfos逐条抄过来。下面是一个用 REST API 创建 GridSet 的示例比在界面上点更高效curl -u admin:geoserver -X POST \ -H Content-Type: application/xml \ -d gridSet namearcgis_3857/name srs number3857/number /srs tileHeight256/tileHeight tileWidth256/tileWidth resolutions double156543.03392804097/double double78271.51696402048/double double39135.75848201024/double !-- 按实际 LOD 继续添加 -- /resolutions tileOrigin x-20037508.34278925/x y20037508.34278925/y /tileOrigin /gridSet \ http://localhost:8080/geoserver/rest/gridsets逻辑说明这个请求创建了一个名为arcgis_3857的 GridSet坐标系是 3857瓦片尺寸 256原点在左上角。resolutions列表必须和 ArcGIS 切片方案的层级一一对应顺序不能乱。如果少了一层或者多了一层预览时对应层级的瓦片就会错位。参数说明resolutions里的数值是每像素代表的地图单位数ArcGIS 的conf.xml里通常叫Resolution。tileOrigin的 x 和 y 是切片原点坐标注意 y 轴方向ArcGIS 默认是向北为正但原点在左上角时 y 值最大。3.2 配置 GeoWebCache 磁盘缓存让 GeoServer 找到瓦片文件GridSet 建好之后接下来要让 GeoWebCache 知道去哪里读瓦片。GeoServer 的 GeoWebCache 支持通过磁盘缓存来读取已有的瓦片文件。你需要修改geowebcache.xml或者通过管理界面配置。常见做法是在geowebcache.xml里添加一个arcgisLayer或者wmsLayer的缓存配置指定瓦片目录的路径。但更直接的方式是使用 GeoServer 的Tile Layers功能先创建一个图层然后在Tile Caching里设置缓存参数。具体步骤在 GeoServer 中新建一个工作区比如arcgis_tiles。新建一个数据存储类型选择GeoWebCache或者直接跳过因为瓦片不需要数据源。新建图层选择Tile Layers作为发布类型然后选择之前创建的 GridSet。在Tile Caching选项卡里勾选Create a cached layer for this layer并设置缓存目录。如果你已经有现成的瓦片文件可以直接把它们放到 GeoWebCache 的缓存目录下目录结构要符合 GeoWebCache 的命名规则。比如gwc/ arcgis_3857/ L00/ R00000000/ C00000000.png注意这里的arcgis_3857必须和 GridSet 名称一致L00对应层级R和C对应行和列。GeoWebCache 会按照这个结构去查找瓦片。如果 ArcGIS 的目录结构是L00/R00000000/C00000000.png那正好可以直接用如果是L00/00000000/00000000.png就需要写个脚本重命名。import os import shutil src_dir /path/to/arcgis_tiles dst_dir /path/to/gwc/arcgis_3857 for level in os.listdir(src_dir): level_path os.path.join(src_dir, level) if not os.path.isdir(level_path): continue for row in os.listdir(level_path): row_path os.path.join(level_path, row) if not os.path.isdir(row_path): continue for col in os.listdir(row_path): if not col.endswith(.png): continue # 构造目标路径 dst_level os.path.join(dst_dir, level) dst_row os.path.join(dst_level, fR{row.zfill(8)}) dst_col os.path.join(dst_row, fC{col.zfill(8)}) os.makedirs(dst_col, exist_okTrue) shutil.copy(os.path.join(row_path, col), os.path.join(dst_col, col))逻辑说明这个脚本把 ArcGIS 的瓦片目录结构转换成 GeoWebCache 能识别的格式。zfill(8)确保行号和列号是 8 位数字前面补零。转换完成后GeoWebCache 就能按照 GridSet 的定义去读取瓦片了。参数说明src_dir是原始瓦片目录dst_dir是 GeoWebCache 的缓存目录。注意dst_dir下的子目录名必须和 GridSet 名称完全一致否则 GeoWebCache 找不到。3.3 预览与调试确认瓦片是否正确拼接配置完成后进入 GeoServer 的Tile Layers页面找到你发布的图层点击Preview。如果一切正常你应该能看到地图。如果看到空白或者错位按以下顺序排查检查 GridSet 的 resolutions 是否和 ArcGIS 的 LOD 完全一致。差一点点都会导致瓦片错位。检查瓦片目录的命名是否和 GeoWebCache 的预期一致。特别是行号和列号的位数。检查坐标系是否匹配。如果 ArcGIS 用的是EPSG:4326而你在 GridSet 里选了EPSG:3857那肯定对不上。查看 GeoServer 的日志看是否有File not found或者GridSet not found的错误。注意GeoWebCache 在读取瓦片时会按照 GridSet 的定义计算每个瓦片的地理范围然后去对应的目录查找文件。如果目录结构不对它会直接返回 404而不是报错。所以预览时看到空白不一定是配置错了也可能是文件没放对地方。4. 避坑指南发布 ArcGIS 瓦片时最容易翻车的五个地方4.1 现象预览页面显示空白日志无报错原因瓦片文件没有放在 GeoWebCache 预期的目录下或者目录命名不符合规则。GeoWebCache 在找不到瓦片时会静默返回 404不会在日志里记录详细错误。解决手动检查gwc目录下的结构确认 GridSet 名称、层级目录、行号列号命名都正确。可以用curl直接请求一个瓦片 URL看返回的是 200 还是 404。比如curl -I http://localhost:8080/geoserver/gwc/service/tms/1.0.0/arcgis_tiles:layerEPSG:3857png/0/0/0.png如果返回 404说明路径不对如果返回 200 但内容是空的说明瓦片文件本身有问题。4.2 现象瓦片错位地图看起来被拉伸或偏移原因GridSet 的 resolutions 和 ArcGIS 切片方案的 LOD 不一致或者 tileOrigin 设置错误。常见的是 resolutions 的数值精度不够导致累积误差。解决从 ArcGIS 的conf.xml里逐条复制Resolution值不要手动计算。tileOrigin 的 x 和 y 也要精确复制注意正负号。如果conf.xml里没有可以从LODInfos里推算但最好找到原始文件。4.3 现象紧凑型瓦片.bundle无法识别原因GeoServer 默认不支持直接读取 ArcGIS 的紧凑型瓦片格式。.bundle文件是 ArcGIS 私有的打包格式GeoWebCache 不认识。解决需要先把紧凑型瓦片解包成松散型。ArcGIS 提供了TileCacheExport工具或者用第三方脚本解包。解包后再按照松散型的方式配置。如果不想解包可以考虑用其他支持紧凑型的服务框架但那就不是 GeoServer 了。4.4 现象坐标系不一致导致瓦片无法叠加原因ArcGIS 瓦片用的坐标系和 GeoServer 中其他图层的坐标系不一致叠加时出现偏移。解决在 GeoServer 中发布瓦片图层时确保 native CRS 和 declared CRS 都设置正确。如果需要在不同坐标系之间叠加考虑在客户端做投影转换而不是在 GeoServer 里转瓦片。因为瓦片是预切的GeoServer 不会重新投影。4.5 现象层级数量对不上高层级瓦片缺失原因ArcGIS 切片方案可能只切到了某一层级而 GeoServer 的 GridSet 定义了更多层级。当请求超出范围的层级时GeoWebCache 找不到瓦片返回空白。解决在 GridSet 中只定义实际存在的层级或者在 GeoWebCache 中配置minZoom和maxZoom限制请求范围。如果确实需要更多层级只能用原始数据重新切瓦片。5. 进阶技巧用脚本批量校验瓦片完整性与自动化发布5.1 批量校验瓦片完整性发布之前最好先检查一下瓦片文件是否完整。ArcGIS 切瓦片时可能因为中断导致部分层级缺失如果直接发布预览时会出现局部空白。写个脚本扫一遍目录统计每个层级的瓦片数量和理论值对比。import os import math def check_tiles(base_dir, grid_set_name): grid_dir os.path.join(base_dir, grid_set_name) for level in sorted(os.listdir(grid_dir)): level_path os.path.join(grid_dir, level) if not os.path.isdir(level_path): continue rows os.listdir(level_path) total_tiles 0 for row in rows: row_path os.path.join(level_path, row) if not os.path.isdir(row_path): continue cols [f for f in os.listdir(row_path) if f.endswith(.png)] total_tiles len(cols) # 理论值4^level对于四叉树 expected 4 ** int(level[1:]) print(f{level}: 实际 {total_tiles}, 理论 {expected}, 缺失 {expected - total_tiles}) check_tiles(/path/to/gwc, arcgis_3857)逻辑说明这个脚本遍历每个层级统计实际瓦片数量然后和四叉树的理论值对比。如果缺失数量很大说明瓦片不完整需要重新切或者从其他地方补。参数说明base_dir是 GeoWebCache 的根目录grid_set_name是 GridSet 名称。level[1:]提取层级数字比如L00提取出00转成整数后计算4^level。5.2 自动化发布用 REST API 一键配置如果经常需要发布 ArcGIS 瓦片可以写个脚本把整个流程自动化。GeoServer 的 REST API 支持创建 GridSet、图层和缓存配置。下面是一个简化的流程#!/bin/bash GEOSERVER_URLhttp://localhost:8080/geoserver AUTHadmin:geoserver # 1. 创建 GridSet curl -u $AUTH -X POST -H Content-Type: application/xml \ -d gridset.xml \ $GEOSERVER_URL/rest/gridsets # 2. 创建工作区 curl -u $AUTH -X POST -H Content-Type: application/xml \ -d workspacenamearcgis_tiles/name/workspace \ $GEOSERVER_URL/rest/workspaces # 3. 创建图层需要先有数据存储这里省略 # 4. 配置缓存 curl -u $AUTH -X POST -H Content-Type: application/xml \ -d cache_config.xml \ $GEOSERVER_URL/rest/layers/arcgis_tiles:layer/tilecache逻辑说明这个脚本把创建 GridSet、工作区和缓存配置的步骤串起来。gridset.xml和cache_config.xml是预先写好的配置文件内容参考前面的示例。参数说明GEOSERVER_URL是 GeoServer 的地址AUTH是用户名和密码。注意 REST API 的路径和请求方法创建用 POST修改用 PUT。5.3 一个容易被忽略的细节瓦片格式与压缩ArcGIS 瓦片可能是 PNG 或 JPGGeoWebCache 默认支持这两种格式。但如果瓦片是 WebP 或者带透明通道的 PNG需要在 GridSet 里指定正确的 MIME 类型。另外如果瓦片是压缩过的比如 gzipGeoWebCache 可能无法直接读取需要先解压。我一般会在发布前用file命令检查一下瓦片的实际格式file /path/to/tile.png如果输出是PNG image data, 256 x 256那就没问题。如果是gzip compressed data就需要先解压。这个细节很容易被忽略但一旦踩中预览时就是一片空白日志里还看不出原因。从那以后我每次发布 ArcGIS 瓦片都会先跑一遍完整性校验再确认瓦片格式和目录结构最后才去 GeoServer 里配置。这套流程走下来基本不会再出现预览空白或者错位的问题。希望帮到你。本文还有配套的精品资源点击获取