前言在基于 Spring Boot 3 JDK 17 的服务中由于在多个模块都引入了Geotools一开始没问题就没管后面有次突然就报错了java.lang.NoClassDefFoundError:Couldnot initializeclassorg.geotools.referencing.factory.OrderedAxisAuthorityFactory这个报错并不直接指向业务代码而是卡在了 GeoTools 的底层初始化阶段。经过排查我们发现这并非 GeoTools 的 Bug而是多模块项目中典型的“基础设施依赖管理失控”。本文将用图示 可落地的 POM 示例完整复盘这一问题的根本原因并给出 GeoTools 在多模块架构下的标准引入方案。一、错误现象OrderedAxisAuthorityFactory 初始化失败异常堆栈的核心在于OrderedAxisAuthorityFactory这个类的静态初始化失败。OrderedAxisAuthorityFactory是 GeoTools 内部用于按优先级排序坐标系工厂的关键类。它在静态代码块中依赖gt-epsg相关模块来读取 EPSG 坐标系定义。当以下任一条件不满足时就会触发ExceptionInInitializerError进而导致后续的NoClassDefFoundErrorEPSG 工厂实现类在 classpath 中找不到SPI 配置文件META-INF/services被覆盖或丢失依赖的 JTS 版本与 GeoTools 不匹配Spring Boot Fat Jar 未解压导致资源文件不可读下文将逐一分析这些条件是如何被触发的。二、根因分析多模块依赖的“散养”模式大部分人可能都会犯的错——将 GeoTools 的依赖随意分散到了多个模块中。问题一版本分裂不同模块通过不同的传递依赖各自引入了不同版本的 GeoTools Jar 包。同一个 JVM 中GeoTools 的类由不同的 ClassLoader 加载版本不一致。问题二SPI 冲突GeoTools 重度依赖 Java SPIService Provider Interface机制来注册坐标系工厂。多个模块各自携带 SPI 配置文件Spring Boot 打包后这些配置文件相互覆盖或丢失最终使得OrderedAxisAuthorityFactory在寻找实现类时扑空。问题三新旧 JTS 的“宫斗”项目中同时存在旧版com.vividsolutions:jts已废弃和新版org.locationtech.jts:jts-core。GeoTools 29 版本强依赖 LocationTech 的 JTS。当类加载器先加载了旧版 JTS 的类或者两者在 classpath 中打架时GeoTools 的几何工厂初始化会直接失败。三、最终解决方案建立“GIS 基础设施隔离层”核心思路是新增一个独立模块专门承载 GeoTools 和 JTS其他模块只通过依赖这个模块来间接使用 GIS 能力。3.1 正确的模块分层结构假设我们有一个多模块项目包含以下模块test-a业务模块 Atest-b业务模块 Btest-c业务模块 Cgt-spatialGIS 基础设施模块新增boot启动模块正确的分层和依赖方向如下层级模块说明infrastructuregt-spatialGeoTools JTS 的唯一住所domaintest-a业务核心依赖 infrastructurebusinesstest-b / test-c业务模块依赖 test-aapplicationboot启动入口依赖以上所有依赖方向永远向下绝不反向绝不横向互吸。3.2 模块依赖关系图以下文字示意图展示了正确的模块依赖方向gt-spatial (infrastructure 层) ^ | test-a (domain 层) ^ | test-b / test-c (business 层) ^ | boot (application 层)3.3 各模块 POM 文件示例第一步Parent POM 统一版本管理在根 POM 的dependencyManagement中锁定所有 GeoTools 和 JTS 版本dependencyManagementdependencies!-- GeoTools --dependencygroupIdorg.geotools/groupIdartifactIdgt-referencing/artifactIdversion31.2/version/dependencydependencygroupIdorg.geotools/groupIdartifactIdgt-epsg-wkt/artifactIdversion31.2/version/dependencydependencygroupIdorg.geotools/groupIdartifactIdgt-main/artifactIdversion31.2/version/dependencydependencygroupIdorg.geotools/groupIdartifactIdgt-geojson/artifactIdversion31.2/version/dependencydependencygroupIdorg.geotools.jdbc/groupIdartifactIdgt-jdbc-postgis/artifactIdversion31.2/version/dependency!-- JTS --dependencygroupIdorg.locationtech.jts/groupIdartifactIdjts-core/artifactIdversion1.19.0/version/dependency/dependencies/dependencyManagement第二步gt-spatial 模块基础设施层这个模块的唯一职责就是封装 GeoTools 和 JTS相关的GIS方法都统一写在这个模块不写其他任何业务逻辑!-- gt-spatial/pom.xml --artifactIdgt-spatial/artifactIddependencies!-- GeoTools 核心 --dependencygroupIdorg.geotools/groupIdartifactIdgt-referencing/artifactId/dependencydependencygroupIdorg.geotools/groupIdartifactIdgt-epsg-wkt/artifactId/dependencydependencygroupIdorg.geotools/groupIdartifactIdgt-main/artifactId/dependency!-- 实际用到的能力 --dependencygroupIdorg.geotools/groupIdartifactIdgt-geojson/artifactId/dependencydependencygroupIdorg.geotools.jdbc/groupIdartifactIdgt-jdbc-postgis/artifactId/dependency!-- JTS唯一入口 --dependencygroupIdorg.locationtech.jts/groupIdartifactIdjts-core/artifactId/dependency/dependencies第三步test-a 模块业务核心层只依赖gt-spatial不自己引 GeoTools!-- test-a/pom.xml --dependencies!-- 通过 gt-spatial 间接获得 GeoTools --dependencygroupIdcom.example/groupIdartifactIdgt-spatial/artifactId/dependency/dependencies第四步test-b / test-c 模块业务模块层只依赖test-a不直接碰 GeoTools!-- test-b/pom.xml --dependenciesdependencygroupIdcom.example/groupIdartifactIdtest-a/artifactId/dependency/dependencies3.4 GeoTools 多模块引入的铁律经过此次事故我们总结了 GeoTools 在多模块项目中的引入铁律铁律说明单点引入整个项目有且只有一个 Module 负责引入 GeoTools版本托管在 Root POM 的dependencyManagement中锁定版本子模块不写版本号JTS 隔离JTS 必须跟随 GeoTools 待在同一个 Module 里严禁业务模块单独引入最小化依赖按需引入不用的 GeoTools 模块坚决不加减少 SPI 文件冲突概率总结NoClassDefFoundError: OrderedAxisAuthorityFactory这个报错本质上是类加载机制与依赖管理混乱的碰撞。GeoTools 作为一个重度依赖 SPI 和静态初始化的老牌 GIS 库对运行环境的“纯净度”要求极高。在多模块项目中它不应该被当作“工具 Jar”随意散落在各个业务模块中而应该被封装在独立的“基础设施层”像 Spring、Hibernate 一样被对待。通过这次重构我们不仅修复了启动报错更重要的是确立了一种防御性的依赖管理思维对于基础设施级依赖应当将其封装在独立的“防腐层”中严格限制其对外暴露的范围。这样既能避免依赖地狱也能让未来的升级维护变得可控。如果你也在 Spring Boot 多模块项目中遇到了类似的 GeoTools 初始化问题不妨检查一下你的依赖树——也许是时候给 GeoTools 安一个“单间”了。