Geoserver 2.19.0 安装MapML插件后功能不显示问题咨询

基础问题答复 #

默认管理员账号不影响MapML插件的安装使用，插件能否正常加载只和部署配置相关，和GeoServer后台登录账号的权限没有关联。

常见遗漏配置/操作排查项 #

• 版本匹配校验：必须保证MapML插件版本和当前运行的GeoServer版本完全一致，大版本、次版本号都要对应，比如GeoServer 2.24.0必须使用对应2.24.0版本的MapML插件，跨版本安装会出现加载失败的情况。
• 部署目录校验：确认你放置Jar包的目录是正在运行的GeoServer实例的私有lib目录，如果是Tomcat部署的GeoServer，正确路径为webapps/geoserver/WEB-INF/lib，不要放到Tomcat全局lib目录或者GeoServer安装包的根lib目录下。
• 文件权限校验：检查放入的MapML相关Jar文件的读取权限，保证和目录内原有GeoServer Jar包的权限一致，运行GeoServer进程的系统用户需要拥有这些Jar的读取权限，权限不足会导致启动时跳过加载该插件。
• 启动日志排查：重启GeoServer后查看服务启动日志，搜索MapML相关的报错信息，常见报错原因包括Jar包缺失、依赖冲突（和已安装的其他第三方插件冲突）、插件包下载不完整。
• 功能开启校验：插件加载成功后需要先开启全局配置：进入GeoServer后台「设置」-「发布」页面，找到MapML相关配置项开启全局支持；之后进入对应图层的「发布」标签页，勾选支持MapML输出格式，图层预览页面才会显示对应入口。

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