SpringBoot中GeoTools转换GRIB2到GeoTIFF失败问题排查

核心原因 #

1. SpringBoot类加载机制差异：普通Maven项目使用系统类加载器，而SpringBoot采用LaunchedURLClassLoader，导致GeoTools的GRIB模块无法从自身JAR包中加载HSQLDB所需的Schema定义文件（比如对应Low_cloud_cover_surface_layer的元数据文件）。GeoTools处理GRIB2时，依赖内置HSQLDB存储变量元数据，这些Schema文件打包在gt-grib的JAR资源中，SpringBoot的类加载路径规则可能阻碍了资源读取。

2. SpringBoot自动配置干扰：即便未引入spring-boot-starter-data-jpa，SpringBoot 3.x仍会默认初始化嵌入式DataSource相关逻辑，这会和GeoTools内置的HSQLDB实例产生冲突，导致Schema无法正常初始化。

解决步骤 #

1. 禁用SpringBoot的DataSource自动配置 #

在SpringBoot启动类上添加排除配置，避免自动配置干扰GeoTools的HSQLDB使用：

@SpringBootApplication(exclude = {
    DataSourceAutoConfiguration.class,
    DataSourceTransactionManagerAutoConfiguration.class,
    HibernateJpaAutoConfiguration.class
})
public class YourApplication {
    public static void main(String[] args) {
        SpringApplication.run(YourApplication.class, args);
    }
}

2. 确保GeoTools资源被正确加载 #

在pom.xml中配置SpringBoot Maven插件，强制将GeoTools的JAR包资源纳入类加载路径（若使用可执行JAR启动）：

<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
            <configuration>
                <includeSystemScope>true</includeSystemScope>
                <!-- 确保GeoTools的资源文件被正确打包 -->
                <resources>
                    <resource>
                        <directory>${project.basedir}/src/main/resources</directory>
                    </resource>
                    <resource>
                        <directory>${project.build.directory}/dependency</directory>
                        <includes>
                            <include>**/*.properties</include>
                            <include>**/*.db</include>
                            <include>**/*.sql</include>
                        </includes>
                    </resource>
                </resources>
            </configuration>
        </plugin>
    </plugins>
</build>

3. 手动指定GeoTools的HSQLDB Schema路径 #

在GRIB转换代码执行前添加配置，确保类加载器能找到Schema资源：

// 设置GeoTools GRIB Schema的资源路径
System.setProperty("org.geotools.grib.schema.location", "classpath:/org/geotools/grib/schema/");

4. 验证GeoTools依赖一致性 #

确认SpringBoot项目中GeoTools的所有依赖版本（包括gt-grib、gt-hsql等相关模块）和原非SpringBoot项目完全一致，避免版本冲突导致的资源加载问题。

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