SpringBoot 3.3无法读取类路径下GeoLite2-Country.mmdb文件返回null

核心问题分析 #

你遇到的getResource()返回null的问题，主要有两个原因：

1. 资源路径错误：@Value注入的路径带了classpath:前缀，而ClassLoader.getResource()的参数不需要该前缀，导致无法定位资源。
2. 文件访问方式错误：当项目打包成Jar后，资源文件并非独立存在于文件系统，而是嵌入在Jar内部，直接用File对象无法访问。

解决方案 #

1. 修正资源加载代码（推荐） #

改用Spring的Resource类型直接注入资源，通过输入流加载数据库，兼容Jar包运行环境：

import org.springframework.beans.factory.annotation.Value;
import org.springframework.core.io.Resource;
import com.maxmind.geoip2.DatabaseReader;
import java.io.InputStream;

// 直接注入资源对象
@Value("classpath:maxmind/GeoLite2-Country.mmdb")
private Resource mmdbResource;

@Bean(name = "GeoIPCountry")
public DatabaseReader databaseReader() throws IOException {
    // 通过输入流加载数据库，适配Jar包内资源访问
    try (InputStream inputStream = mmdbResource.getInputStream()) {
        return new DatabaseReader.Builder(inputStream).build();
    }
}

2. 修复原路径问题（仅本地开发可用） #

如果坚持用File方式（仅适用于本地未打包的开发场景），需要去掉路径中的classpath:前缀：

// 修改@Value注入，移除classpath:前缀
@Value("maxmind/GeoLite2-Country.mmdb")
private String dblocation;

@Bean(name = "GeoIPCountry")
public DatabaseReader databaseReader() throws IOException {
    URL resourceUrl = this.getClass().getClassLoader().getResource(dblocation);
    if (resourceUrl == null) {
        throw new IOException("GeoLite2 database file not found in classpath: " + dblocation);
    }
    // 仅本地开发场景可用，Jar环境下会报错
    final File resource = new File(resourceUrl.getFile());
    return new DatabaseReader.Builder(resource).build();
}

3. 验证资源配置与打包 #

• 确认数据库文件确实存在于src/main/resources/maxmind/GeoLite2-Country.mmdb，注意大小写敏感（Linux/JVM环境下严格区分文件名大小写）。
• 清理application.properties中的冗余配置，保留必要项即可：

  maxmind.geoip2.database=classpath:maxmind/GeoLite2-Country.mmdb
  

4. 排查其他潜在问题 #

• 确认数据库文件未损坏：使用官方提供的License Key重新下载文件，避免第三方来源的损坏文件。
• 检查依赖兼容性：SpringBoot 3.3要求Java 17+，可升级geoip2依赖到最新稳定版（如2.17.0），确保版本兼容：

  implementation 'com.maxmind.geoip2:geoip2:2.17.0'
  

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