Geotools部署Flink集群遇ellipsoid参数空值异常求助

针对你遇到的java.lang.IllegalArgumentException: Argument "ellipsoid" should not be null异常，结合本地正常、集群报错的现象，核心原因大概率是打包时资源文件丢失、服务类合并不完整，或者Flink类加载机制与Geotools冲突，以下是针对性解决步骤：

1. 替换Geotools为稳定版本 #

28-SNAPSHOT是快照版，存在未知稳定性问题，建议切换到同系列稳定版（如27.5），避免快照版的潜在bug：

<dependency>
    <groupId>org.geotools</groupId>
    <artifactId>gt-epsg-hsql</artifactId>
    <version>27.5</version>
</dependency>
<!-- 同时确保核心依赖版本一致 -->
<dependency>
    <groupId>org.geotools</groupId>
    <artifactId>gt-referencing</artifactId>
    <version>27.5</version>
</dependency>
<dependency>
    <groupId>org.geotools</groupId>
    <artifactId>gt-metadata</artifactId>
    <version>27.5</version>
</dependency>

2. 修复maven-shade-plugin打包配置 #

确保打包时正确合并服务类、保留Geotools的EPSG数据库资源文件，避免集群运行时无法读取关键数据：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-shade-plugin</artifactId>
    <version>3.2.4</version>
    <executions>
        <execution>
            <phase>package</phase>
            <goals>
                <goal>shade</goal>
            </goals>
            <configuration>
                <transformers>
                    <!-- 合并META-INF/services下的服务类配置，避免Geotools的工厂类被覆盖 -->
                    <transformer implementation="org.apache.maven.plugins.shade.resource.ServicesResourceTransformer"/>
                    <!-- 强制包含EPSG-HSQL的数据库文件，集群环境下才能加载坐标系数据 -->
                    <transformer implementation="org.apache.maven.plugins.shade.resource.IncludeResourceTransformer">
                        <resource>*.db</resource>
                        <directory>${project.build.outputDirectory}/org/geotools/referencing/factory/epsg/hsql</directory>
                    </transformer>
                </transformers>
                <!-- 排除签名文件，避免打包冲突 -->
                <filters>
                    <filter>
                        <artifact>*:*</artifact>
                        <excludes>
                            <exclude>META-INF/*.SF</exclude>
                            <exclude>META-INF/*.DSA</exclude>
                            <exclude>META-INF/*.RSA</exclude>
                        </excludes>
                    </filter>
                </filters>
            </configuration>
        </execution>
    </executions>
</plugin>

3. 调整Flink集群类加载策略 #

Flink的自定义类加载器可能导致Geotools的类/资源加载顺序异常，修改flink-conf.yaml调整类加载优先级：

# 设置父类加载优先，确保Geotools依赖能被正确加载
classloader.resolve-order: parent-first
# 或者针对Geotools相关包单独设置优先加载
classloader.parent-first-patterns-additional: org.geotools.,org.opengis.

4. 替换EPSG实现为WKT版本（备选方案） #

如果HSQL数据库文件在集群环境下仍存在加载问题，可改用纯WKT格式的EPSG实现，避免依赖数据库文件：

<!-- 移除gt-epsg-hsql，替换为gt-epsg-wkt -->
<dependency>
    <groupId>org.geotools</groupId>
    <artifactId>gt-epsg-wkt</artifactId>
    <version>27.5</version>
</dependency>

验证步骤 #

1. 执行mvn clean package重新打包，解压Jar包检查：
   • META-INF/services/org.opengis.referencing.crs.CRSAuthorityFactory文件是否包含org.geotools.referencing.factory.epsg.EPSGCRSAuthorityFactory
   • org/geotools/referencing/factory/epsg/hsql目录下是否存在EPSG.db等文件
2. 提交Jar到Flink集群运行，观察异常是否消失

内容的提问来源于stack exchange，提问作者K.M