如何修改Geoserver 2.8.2 WMS服务的异常返回格式

方法1：全局WMS配置（对所有WMS请求生效） #

• 登录Geoserver后台管理界面，依次进入左侧导航栏「服务」→「WMS」设置页面
• 下拉页面找到异常处理配置模块
• 在「默认异常格式」下拉菜单中选择你需要的inimage或者blank选项
• 点击页面底部「保存」按钮，重启Geoserver后配置正式生效

方法2：单请求指定（无需修改全局配置） #

• 发送WMS请求时直接在参数中新增EXCEPTIONS字段赋值即可，示例请求如下：
  http://<你的Geoserver服务地址>/geoserver/wms?service=WMS&version=1.1.0&request=GetMap&layers=测试图层&bbox=xxx&width=768&height=506&srs=EPSG:4326&format=image/png&EXCEPTIONS=inimage

方法3：配置文件直接修改（适用于后台无配置入口的部署场景） #

• 进入Geoserver数据目录，找到data_dir/services/wms.xml配置文件
• 定位到<defaultExceptionFormat>标签，修改标签内容为目标格式，示例：

<defaultExceptionFormat>blank</defaultExceptionFormat>

• 保存配置文件后重启Geoserver服务即可生效

注意事项 #

• 选择inimage作为异常格式时，需要确保WMS请求的返回格式为图片类型（如image/png、image/jpeg），否则异常会自动 fallback 为XML格式返回
• blank格式触发异常时会返回和请求尺寸一致的空白图片，不会携带任何错误描述信息

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