GeoLite2数据库打包进WAR文件后损坏问题排查求助

我太懂这种二进制文件在Maven打包时被改坏的糟心了——GeoLite2的.mmdb是二进制格式，哪怕是不小心的编码转换或文本过滤操作，都会直接让数据库彻底失效。下面给你一步步排查和解决的思路：

一、先排查全局资源过滤的默认坑 #

Maven的maven-resources-plugin默认会过滤文本文件（比如.properties、.xml），替换里面的变量，但如果把二进制文件当成文本处理，就会因为编码转换损坏文件。你之前尝试了这个插件，但可能配置没到位：

• 先检查你的pom.xml里有没有全局开了资源过滤，比如这种配置：

  <build>
    <resources>
      <resource>
        <directory>src/main/resources</directory>
        <filtering>true</filtering> <!-- 全局开过滤会影响所有文件！ -->
      </resource>
    </resources>
  </build>
  

  如果全局设了filtering=true，你的.mmdb文件肯定会被当成文本处理损坏。

二、精准配置资源插件，隔离二进制文件 #

正确的做法是把资源分成两类：需要过滤的文本文件，和原封不动的二进制文件。修改pom.xml的build部分：

<build>
  <resources>
    <!-- 只处理需要变量替换的文本资源 -->
    <resource>
      <directory>src/main/resources</directory>
      <filtering>true</filtering>
      <includes>
        <include>**/*.properties</include>
        <include>**/*.xml</include>
        <!-- 其他你需要过滤的文本文件类型 -->
      </includes>
    </resource>
    <!-- 单独处理.mmdb这类二进制文件，完全跳过过滤 -->
    <resource>
      <directory>src/main/resources</directory>
      <filtering>false</filtering>
      <includes>
        <include>**/*.mmdb</include>
      </includes>
    </resource>
  </resources>
</build>

这样配置后，Maven只会对指定的文本文件做变量替换，.mmdb文件会原封不动复制到WAR包的WEB-INF/classes目录下。

三、排查其他可能动手脚的插件 #

如果上面的配置还是没解决，那可能是其他Maven插件在打包阶段修改了文件：

• 检查maven-war-plugin的配置，有没有开启不必要的过滤：

  <plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-war-plugin</artifactId>
    <version>3.3.2</version>
    <configuration>
      <!-- 这里如果有<filtering>true</filtering>一定要关掉 -->
      <warSourceDirectory>src/main/webapp</warSourceDirectory>
    </configuration>
  </plugin>
  

• 排查是否用到了maven-assembly-plugin、maven-filter-plugin这类插件，它们也可能在打包时处理资源文件，需要确保它们不会触碰.mmdb文件。

四、验证打包后的文件完整性 #

打包完成后，你可以通过对比MD5值确认文件是否完好：

• 先获取原文件的MD5：
  Linux/macOS执行：md5sum src/main/resources/GeoLite2-City.mmdb
  Windows执行：certutil -hashfile src/main/resources/GeoLite2-City.mmdb MD5
• 解压生成的WAR文件，找到WEB-INF/classes/GeoLite2-City.mmdb，对它执行同样的命令，如果MD5值一致，说明文件没被修改。

五、临时测试：跳过所有资源过滤 #

如果还是有问题，可以临时在打包时跳过资源过滤，确认是不是资源处理的锅：

mvn package -Dmaven.resources.filtering=false

如果这样打包后文件正常，那肯定是资源过滤的配置没调好，回到第二步重新调整即可。

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