Geoserver的WMS 1.3.0 GetCapabilities报错，如何实现CesiumJS数据加载？

问题根源 #

你遇到的XML格式错误（「XML声明仅允许出现在文档开头」）是表象，底层原因是Marlin渲染引擎与Java 9+模块系统的权限冲突：org.marlin.pisces.MarlinRenderingEngine试图访问Java核心模块java.desktop的内部类sun.java2d.pipe.RenderingEngine，但模块化Java默认禁止这种跨模块的内部访问，导致GetCapabilities生成XML时抛出异常，错误信息混入XML输出，破坏了文档结构。

解决方案 #

方案1：禁用Marlin渲染引擎，改用默认Java2D引擎

直接绕过冲突，使用Java自带的渲染引擎：

• 打开GeoServer的启动脚本（Windows为startup.bat，Linux/macOS为startup.sh）
• 在Java启动参数部分添加：-Dsun.java2d.renderer=sun.java2d.pipe.RenderingEngine
• 保存脚本后重启GeoServer，重新请求GetCapabilities

方案2：配置Java模块权限（保留Marlin引擎）

如果需要继续使用Marlin渲染引擎，通过Java参数开放模块访问权限：

• 在GeoServer启动参数中添加以下内容：

  --add-exports java.desktop/sun.java2d.pipe=ALL-UNNAMED
  --add-opens java.desktop/sun.java2d=ALL-UNNAMED
  

• 重启GeoServer后验证GetCapabilities请求是否正常

方案3：降级Java版本到Java 8

Java 8没有模块化系统，不会触发这类权限限制：

• 卸载当前Java 9+版本，安装Java 8（推荐使用AdoptOpenJDK或Oracle JDK 8）
• 修改GeoServer配置中的JAVA_HOME环境变量，指向Java 8的安装路径
• 重启GeoServer

验证与CesiumJS加载测试 #

1. 先单独测试GeoServer的GetCapabilities请求：在浏览器访问

   http://你的GeoServer地址/geoserver/wms?service=WMS&version=1.3.0&request=GetCapabilities
   

   确认返回的XML格式正常，无报错信息。
2. 配置CesiumJS加载WMS图层的示例代码：

   const viewer = new Cesium.Viewer('cesiumContainer');
   viewer.imageryLayers.addImageryProvider(new Cesium.WebMapServiceImageryProvider({
       url: 'http://你的GeoServer地址/geoserver/wms',
       layers: '你的工作区:你的图层名',
       parameters: {
           service: 'WMS',
           version: '1.3.0',
           format: 'image/png'
       }
   }));
   

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