簡(jiǎn)介本資源面向需要在 GeoServer 中發(fā)布 ArcGIS 瓦片服務(wù)的 GIS 開(kāi)發(fā)者與運(yùn)維人員解決切片數(shù)據(jù)遷移、離線(xiàn)地圖服務(wù)搭建及跨平臺(tái)發(fā)布等實(shí)際問(wèn)題適合具備一定 GIS 基礎(chǔ)、希望打通 ArcGIS 與開(kāi)源地圖服務(wù)鏈路的中高級(jí)用戶(hù)。壓縮包共 1571 個(gè)文件約 137.36MB以 png 瓦片圖片、jar 依賴(lài)庫(kù)、xml 配置、prj 投影文件、sld 樣式、shp/dbf/shx 矢量數(shù)據(jù)及 pgw 坐標(biāo)文件為主另含 properties、bat 啟動(dòng)腳本與日志等運(yùn)行支撐文件覆蓋服務(wù)部署所需的完整目錄結(jié)構(gòu)。目前已有 1090 人學(xué)習(xí)下載。資源內(nèi)含可直接運(yùn)行的 GeoServer 環(huán)境與配套瓦片數(shù)據(jù)讀者可據(jù)此完成瓦片圖層發(fā)布、樣式配置與切片預(yù)覽并參考日志與配置文件排查發(fā)布過(guò)程中的常見(jiàn)問(wèn)題快速?gòu)?fù)現(xiàn) ArcGIS 瓦片在 GeoServer 中的發(fā)布流程。1. 從一次瓦片發(fā)布翻車(chē)說(shuō)起為什么我堅(jiān)持用 GeoServer 發(fā) ArcGIS 瓦片去年幫一個(gè)做智慧園區(qū)的朋友處理地圖服務(wù)他們前端用的是 ArcGIS JS API底圖卻想換成自己切的瓦片。我第一反應(yīng)是拿 GeoServer 直接發(fā)結(jié)果第一次就翻車(chē)了——瓦片目錄結(jié)構(gòu)對(duì)不上緩存切片規(guī)則沒(méi)配好前端加載出來(lái)全是灰塊。折騰到凌晨?jī)牲c(diǎn)才發(fā)現(xiàn)問(wèn)題根本不在 GeoServer而在我切瓦片時(shí)用的坐標(biāo)系和網(wǎng)格集沒(méi)對(duì)齊。這件事讓我意識(shí)到用 GeoServer 發(fā)布 ArcGIS 瓦片這件事看起來(lái)只是點(diǎn)幾下鼠標(biāo)實(shí)際上從環(huán)境準(zhǔn)備到參數(shù)配置每一步都有坑。如果你也正卡在「GeoServer 怎么裝」「ArcGIS 瓦片怎么發(fā)布」「GeoServer 環(huán)境搭建」這些問(wèn)題上那這篇筆記就是我從零到跑通的全過(guò)程記錄包括版本選擇、安裝步驟、配置參數(shù)和翻車(chē)后的補(bǔ)救辦法。整套流程在 Windows 和 Linux 上都驗(yàn)證過(guò)新手照著走能跑通熟手也能看到我在參數(shù)取舍上的思考。2. 環(huán)境準(zhǔn)備與版本選擇GeoServer 裝哪個(gè)版本、Java 怎么配2.1 GeoServer 版本與 Java 運(yùn)行時(shí)的對(duì)應(yīng)關(guān)系GeoServer 是基于 Java 的 Web 應(yīng)用裝之前第一件事不是下載 GeoServer而是確認(rèn) Java 版本。我見(jiàn)過(guò)太多人直接下最新版 GeoServer結(jié)果本機(jī) Java 是 8啟動(dòng)直接報(bào)UnsupportedClassVersionError。常見(jiàn)做法是GeoServer 2.20 及以后版本要求 Java 11 或 172.19 及以前可以用 Java 8。如果你不確定去 GeoServer 官網(wǎng)的下載頁(yè)看每個(gè)版本旁邊的「Java Version」標(biāo)注這是最穩(wěn)的。我一般會(huì)選 GeoServer 2.23.x 配 Java 17原因是這個(gè)組合在 Windows 和 Linux 上都有長(zhǎng)期支持且對(duì) ArcGIS 瓦片緩存的支持比較成熟。如果你機(jī)器上已經(jīng)有 Java 8 且不想動(dòng)那就退到 GeoServer 2.19.x但要注意后續(xù)插件兼容性會(huì)差一些。GeoServer 版本推薦 Java 版本適用場(chǎng)景2.23.x 及以上Java 17新部署需要長(zhǎng)期維護(hù)2.20.x ~ 2.22.xJava 11平衡穩(wěn)定與新特性2.19.x 及以下Java 8老系統(tǒng)兼容不推薦新項(xiàng)目提示不要同時(shí)裝多個(gè) Java 版本后不設(shè)JAVA_HOMEGeoServer 啟動(dòng)腳本會(huì)優(yōu)先讀環(huán)境變量讀不到才用默認(rèn)路徑很容易啟動(dòng)到錯(cuò)誤的 Java 上。2.2 下載與安裝 GeoServer 的兩種方式GeoServer 官方提供兩種安裝包平臺(tái)無(wú)關(guān)的二進(jìn)制包zip/tar.gz和 Windows 安裝程序。我強(qiáng)烈建議用二進(jìn)制包因?yàn)榘惭b程序會(huì)往系統(tǒng)里寫(xiě)服務(wù)、注冊(cè)表卸載不干凈而二進(jìn)制包解壓就能用遷移也方便。以 Linux 為例下載和解壓命令如下# 下載 GeoServer 2.23.2 二進(jìn)制包 wget https://sourceforge.net/projects/geoserver/files/GeoServer/2.23.2/geoserver-2.23.2-bin.zip # 解壓到 /opt 目錄 unzip geoserver-2.23.2-bin.zip -d /opt/ # 進(jìn)入目錄并設(shè)置環(huán)境變量 cd /opt/geoserver-2.23.2 export JAVA_HOME/usr/lib/jvm/java-17-openjdk-amd64 export GEOSERVER_HOME/opt/geoserver-2.23.2這段命令里JAVA_HOME必須指向 JDK 17 的根目錄不是bin目錄。GEOSERVER_HOME是 GeoServer 自己的環(huán)境變量啟動(dòng)腳本會(huì)用它定位數(shù)據(jù)目錄和配置文件。如果你不設(shè)GEOSERVER_HOME啟動(dòng)腳本會(huì)默認(rèn)用當(dāng)前目錄一旦你從別的路徑執(zhí)行startup.sh就會(huì)找不到配置。Windows 下同理解壓后編輯startup.bat在開(kāi)頭加上set JAVA_HOMEC:\Program Files\Java\jdk-17然后雙擊運(yùn)行。注意路徑里如果有空格不要加引號(hào)set命令會(huì)自己處理。2.3 啟動(dòng)前必須檢查的三個(gè)配置項(xiàng)解壓完別急著啟動(dòng)先改三個(gè)地方否則后面發(fā)布瓦片時(shí)一定會(huì)回來(lái)改。第一data_dir的位置。默認(rèn)在 GeoServer 安裝目錄下的data_dir但生產(chǎn)環(huán)境我一般會(huì)挪到獨(dú)立磁盤(pán)比如/data/geoserver_data。改法是編輯bin/startup.sh找到-DGEOSERVER_DATA_DIR參數(shù)把路徑改掉。這樣升級(jí) GeoServer 時(shí)直接替換程序目錄數(shù)據(jù)不受影響。第二端口號(hào)。默認(rèn) 8080如果機(jī)器上已經(jīng)有 Tomcat 或其他服務(wù)占了改成 8088 或別的。改etc/jetty.xml里的jetty.port值。第三內(nèi)存分配。默認(rèn)啟動(dòng)腳本給的是 512MB 初始堆發(fā)布大量瓦片時(shí)不夠用。在startup.sh里找到-Xms和-Xmx我一般設(shè)成-Xms1024m -Xmx2048m具體看機(jī)器內(nèi)存別超過(guò)物理內(nèi)存的 70%。# 編輯 startup.sh 中的 JAVA_OPTS JAVA_OPTS-Xms1024m -Xmx2048m -DGEOSERVER_DATA_DIR/data/geoserver_data改完保存執(zhí)行./bin/startup.sh看到日志里出現(xiàn)Started SelectChannelConnector0.0.0.0:8088就說(shuō)明起來(lái)了。瀏覽器訪(fǎng)問(wèn)http://你的IP:8088/geoserver默認(rèn)賬號(hào)admin密碼geoserver能進(jìn)管理界面就算環(huán)境通了。3. 發(fā)布 ArcGIS 瓦片從數(shù)據(jù)準(zhǔn)備到服務(wù)配置的完整鏈路3.1 ArcGIS 瓦片目錄結(jié)構(gòu)與 GeoServer 的對(duì)應(yīng)關(guān)系A(chǔ)rcGIS 瓦片也叫切片緩存的目錄結(jié)構(gòu)是固定的根目錄下是Layers文件夾里面按縮放級(jí)別分_alllayers/L00、L01這樣的子目錄每個(gè)級(jí)別下再按行列號(hào)分R0000C0000.png這樣的文件。GeoServer 要發(fā)布這種瓦片不能直接指向Layers目錄而是要用 GeoServer 的「GeoWebCache」模塊來(lái)識(shí)別。我一般會(huì)先把瓦片目錄整理成 GeoServer 能讀的格式。假設(shè)你的瓦片在/data/tiles/mytiles里面是Layers/_alllayers/L00/R00000000C00000000.png這樣的結(jié)構(gòu)。GeoServer 需要你在「Tile Caches」里新建一個(gè)緩存然后指定這個(gè)目錄作為「Tile Directory」。但這里有個(gè)關(guān)鍵點(diǎn)GeoServer 默認(rèn)的瓦片網(wǎng)格集是 EPSG:900913也就是 Web Mercator而 ArcGIS 瓦片可能是 EPSG:4326 或別的。如果網(wǎng)格集對(duì)不上GeoServer 會(huì)找不到瓦片文件前端加載就是空白。所以第一步是確認(rèn)你的瓦片切圖時(shí)用的坐標(biāo)系和網(wǎng)格集。常見(jiàn)做法是在 ArcGIS 里切瓦片時(shí)如果用的是「Google Maps」或「Bing Maps」的切片方案那就是 EPSG:900913GeoServer 里選EPSG:900913網(wǎng)格集即可。如果是自定義的需要在 GeoServer 里新建一個(gè)對(duì)應(yīng)的網(wǎng)格集參數(shù)包括縮放級(jí)別、分辨率、瓦片尺寸。3.2 在 GeoServer 中新建瓦片緩存并掛載目錄登錄 GeoServer 管理界面左側(cè)菜單找到「Tile Caches」點(diǎn)擊「Create a new tile cache」。填寫(xiě)時(shí)注意幾個(gè)參數(shù)Name隨便起比如arcgis_tilesTile Directory填你的瓦片根目錄比如/data/tiles/mytilesGridset選EPSG:900913或你自定義的Format選image/png或image/jpeg要和瓦片文件后綴一致Zoom Start / Stop填你的瓦片實(shí)際有的級(jí)別比如 0 到 18填完保存GeoServer 會(huì)去掃描目錄。如果目錄結(jié)構(gòu)不對(duì)它會(huì)報(bào)「No tiles found」。這時(shí)候去日志里看一般會(huì)提示它期望的路徑格式。我踩過(guò)的坑是ArcGIS 的_alllayers目錄名必須完全一致大小寫(xiě)敏感少個(gè)下劃線(xiàn)都不行。# 檢查瓦片目錄結(jié)構(gòu)是否正確 ls /data/tiles/mytiles/Layers/_alllayers/ # 應(yīng)該輸出 L00 L01 L02 ... 這樣的級(jí)別目錄如果輸出的是L0而不是L00那說(shuō)明你的瓦片不是標(biāo)準(zhǔn) ArcGIS 格式可能是別的工具切的。這種情況要么重新切要么在 GeoServer 里手動(dòng)改目錄名但改完要確保每個(gè)級(jí)別下的行列號(hào)也是 8 位補(bǔ)零格式。3.3 配置 GeoWebCache 的磁盤(pán)配額與緩存策略瓦片目錄掛上后GeoServer 默認(rèn)會(huì)把它當(dāng)成「已緩存的瓦片」直接讀但如果你后續(xù)要更新瓦片或者想控制磁盤(pán)占用就得配 GeoWebCache 的磁盤(pán)配額。在「Tile Caches」里找到你剛建的緩存點(diǎn)進(jìn)去有個(gè)「Disk Quota」選項(xiàng)。我一般會(huì)設(shè)兩個(gè)值Disk Quota設(shè)成 10GB 或根據(jù)磁盤(pán)剩余空間定Eviction Policy選Least Frequently Used。這樣當(dāng)緩存超過(guò)配額時(shí)GeoServer 會(huì)自動(dòng)清理不常用的瓦片避免磁盤(pán)寫(xiě)滿(mǎn)。另外如果你希望 GeoServer 在找不到瓦片時(shí)自動(dòng)去后端地圖服務(wù)取圖并緩存那就要在「Tile Layers」里把圖層和緩存關(guān)聯(lián)起來(lái)。但注意如果你只有靜態(tài)瓦片沒(méi)有后端 WMS 服務(wù)那就不要開(kāi)「Auto Cache」否則 GeoServer 會(huì)不斷嘗試請(qǐng)求一個(gè)不存在的服務(wù)日志里全是報(bào)錯(cuò)。注意靜態(tài)瓦片發(fā)布時(shí)Tile Layers里的圖層必須和緩存名稱(chēng)一致否則前端請(qǐng)求的 URL 會(huì) 404。我一般會(huì)在「Layer Preview」里先預(yù)覽一下確認(rèn)能出圖再給前端。4. 避坑與排查發(fā)布 ArcGIS 瓦片時(shí)最常見(jiàn)的五個(gè)問(wèn)題4.1 瓦片加載出來(lái)是空白或灰塊現(xiàn)象前端請(qǐng)求瓦片 URL 返回 200但圖片是空白或灰色。原因最常見(jiàn)的是網(wǎng)格集不匹配。GeoServer 按 EPSG:900913 的網(wǎng)格去算行列號(hào)但你的瓦片是按 EPSG:4326 切的行列號(hào)對(duì)不上GeoServer 找不到文件就返回一個(gè)空?qǐng)D片。解決確認(rèn)切圖時(shí)的坐標(biāo)系在 GeoServer 里新建對(duì)應(yīng)的網(wǎng)格集。如果不想重建可以用gdal2tiles重新切一份 Web Mercator 的瓦片。我一般會(huì)在切圖前就統(tǒng)一用 EPSG:900913省得后面折騰。4.2 啟動(dòng)報(bào)錯(cuò) UnsupportedClassVersionError現(xiàn)象執(zhí)行startup.sh后閃退日志里寫(xiě)UnsupportedClassVersionError: geoserver/web/... has been compiled by a more recent version of the Java Runtime。原因GeoServer 版本和 Java 版本不匹配。比如 GeoServer 2.23 需要 Java 17但你機(jī)器上JAVA_HOME指向的是 Java 8。解決java -version確認(rèn)當(dāng)前版本然后改startup.sh里的JAVA_HOME指向正確的 JDK。如果機(jī)器上有多個(gè) Java用update-alternatives --config java切換默認(rèn)版本但更穩(wěn)的是直接在啟動(dòng)腳本里寫(xiě)死路徑。4.3 瓦片目錄掃描不到文件現(xiàn)象在 Tile Caches 里填了目錄保存后提示「No tiles found」但目錄里明明有圖片。原因ArcGIS 瓦片目錄結(jié)構(gòu)是Layers/_alllayers/L00/R00000000C00000000.png但 GeoServer 期望的可能是Layers/_alllayers/L00/R00000000C00000000.png這種格式差一個(gè)字符都不行。另外如果目錄權(quán)限不對(duì)GeoServer 進(jìn)程讀不到也會(huì)報(bào)這個(gè)錯(cuò)。解決用ls -R看目錄結(jié)構(gòu)對(duì)比 GeoServer 日志里提示的期望路徑。權(quán)限問(wèn)題用chown -R geoserver:geoserver /data/tiles改一下確保運(yùn)行 GeoServer 的用戶(hù)有讀權(quán)限。4.4 前端跨域請(qǐng)求被攔截現(xiàn)象瀏覽器控制臺(tái)報(bào)CORS policy: No Access-Control-Allow-Origin header。原因GeoServer 默認(rèn)沒(méi)開(kāi) CORS前端從別的域名請(qǐng)求瓦片時(shí)被瀏覽器攔截。解決編輯webapps/geoserver/WEB-INF/web.xml找到cross-origin相關(guān)的 filter把a(bǔ)llowedOrigins改成*或你的前端域名。改完重啟 GeoServer。如果用的是 Jetty也可以在etc/jetty.xml里加 CORS 配置但改web.xml更通用。4.5 瓦片更新后前端還是舊圖現(xiàn)象重新切了瓦片覆蓋上去但前端加載的還是舊圖。原因?yàn)g覽器緩存或 GeoServer 的瓦片緩存沒(méi)刷新。GeoServer 的 GeoWebCache 會(huì)緩存瓦片元數(shù)據(jù)即使文件變了它可能還讀舊的。解決在 Tile Caches 里找到對(duì)應(yīng)緩存點(diǎn)「Seed/Truncate」選「Truncate」清空緩存然后重新訪(fǎng)問(wèn)。如果只是瀏覽器緩存強(qiáng)制刷新CtrlF5或加個(gè)版本號(hào)參數(shù)。我一般會(huì)在瓦片 URL 后面加?t時(shí)間戳來(lái)繞過(guò)緩存。5. 裝完怎么驗(yàn)證跑通三個(gè)必做的檢查與一個(gè)習(xí)慣5.1 用 Layer Preview 做第一輪驗(yàn)證GeoServer 裝完、瓦片發(fā)布完第一件事不是直接給前端而是用自帶的「Layer Preview」看能不能出圖。在左側(cè)菜單點(diǎn)「Layer Preview」找到你發(fā)布的圖層點(diǎn)「OpenLayers」預(yù)覽。如果能看到地圖說(shuō)明 GeoServer 本身配置沒(méi)問(wèn)題。如果看不到按 F12 看網(wǎng)絡(luò)請(qǐng)求哪個(gè)瓦片 404 或 500就去日志里找對(duì)應(yīng)錯(cuò)誤。這一步能過(guò)濾掉 80% 的配置問(wèn)題比如網(wǎng)格集不對(duì)、目錄權(quán)限不對(duì)、瓦片格式不對(duì)。我一般會(huì)在這個(gè)頁(yè)面多縮放幾級(jí)確認(rèn)每個(gè)級(jí)別都能正常加載因?yàn)橛行﹩?wèn)題只在特定級(jí)別出現(xiàn)。5.2 用 curl 模擬前端請(qǐng)求瓦片Layer Preview 能出圖不代表前端就能用。因?yàn)榍岸苏?qǐng)求的 URL 可能和 GeoServer 內(nèi)部用的不一樣。我一般會(huì)用curl模擬一下# 模擬請(qǐng)求一個(gè)瓦片替換成你的實(shí)際 URL curl -I http://你的IP:8088/geoserver/gwc/service/tms/1.0.0/arcgis_tilesEPSG:900913png/0/0/0.png看返回的 HTTP 狀態(tài)碼。如果是 200且Content-Type是image/png說(shuō)明瓦片能正常訪(fǎng)問(wèn)。如果是 404檢查 URL 里的緩存名稱(chēng)、網(wǎng)格集、格式是否和 GeoServer 里配的一致。如果是 500去日志里看具體報(bào)錯(cuò)。這一步能發(fā)現(xiàn) URL 拼寫(xiě)錯(cuò)誤、緩存名稱(chēng)大小寫(xiě)不一致等問(wèn)題。我踩過(guò)的坑是GeoServer 里緩存名是arcgis_tiles但前端寫(xiě)成了arcgis-tiles橫線(xiàn)和下劃線(xiàn)搞混了排查了半天。5.3 檢查日志里的警告和錯(cuò)誤GeoServer 的日志在logs/geoserver.log啟動(dòng)后如果有配置問(wèn)題日志里會(huì)有WARN或ERROR。我一般會(huì)tail -f盯著日志然后在前端刷新頁(yè)面看有沒(méi)有新的報(bào)錯(cuò)。常見(jiàn)的警告包括「Could not find tile」「GridSet not found」「Permission denied」每個(gè)都對(duì)應(yīng)一個(gè)具體的配置問(wèn)題。如果日志里全是INFO沒(méi)有報(bào)錯(cuò)但瓦片就是出不來(lái)那可能是前端的問(wèn)題比如請(qǐng)求的 URL 路徑不對(duì)或者跨域被攔截。這時(shí)候用瀏覽器的開(kāi)發(fā)者工具看網(wǎng)絡(luò)請(qǐng)求比看日志更直接。5.4 我養(yǎng)成的習(xí)慣每次改配置前先備份 data_dir從那以后我每次動(dòng) GeoServer 配置前都會(huì)先cp -r /data/geoserver_data /data/geoserver_data_bak。因?yàn)?GeoServer 的配置全在data_dir里改壞了直接回滾目錄比重新配一遍快得多。這個(gè)習(xí)慣幫我省過(guò)至少三次通宵。另外發(fā)布瓦片時(shí)我會(huì)先用一個(gè)小范圍的瓦片目錄測(cè)試確認(rèn)能跑通再掛全量避免一上來(lái)就掃幾十萬(wàn)個(gè)文件把 GeoServer 卡死。希望幫到你。本文還有配套的精品資源點(diǎn)擊獲取