解决 Maven 打包项目中 Excel 文件乱码问题

问题现象

在使用 Freemarker 模板生成 Excel 文件，并通过 Maven 对项目进行打包后，当打开生成的 Excel 文件时，会发现文件中的文字内容出现乱码情况。这严重影响了 Excel 文件的可读性和数据展示效果，对于依赖这些 Excel 文件进行业务处理的场景而言，是一个亟待解决的问题。

问题原因分析

Maven 在编译项目时，默认会对资源文件进行过滤处理。在这个过程中，如果没有正确配置，对于像 Excel 这种二进制格式的文件（如.xls文件），也会进行一些不恰当的转换操作，从而导致文件内容乱码。简单来说，Maven 将 Excel 文件当作普通文本文件进行了一些字符编码相关的处理，而这并不是 Excel 文件所期望的处理方式。

解决方案

为了解决这个问题，我们需要对 Maven 的配置进行调整，确保 Excel 文件在编译过程中不会被错误地处理。具体的解决方案如下：

添加 maven - resources - plugin 插件配置

在项目的pom.xml文件中，添加如下maven - resources - plugin插件配置： <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-resources-plugin</artifactId> <version>2.6</version> <configuration> <nonFilteredFileExtensions> <!-- 不对rar和xls进行转码 --> <nonFilteredFileExtension>rar</nonFilteredFileExtension> <nonFilteredFileExtension>xls</nonFilteredFileExtension> </nonFilteredFileExtensions> </configuration> </plugin> 这段配置的作用是告诉 Maven，在资源过滤过程中，不要对.rar和.xls格式的文件进行任何转码操作，保持它们的原始二进制格式。

调整 resources 配置

同时，我们还需要对项目的resources配置进行优化，确保 Excel 文件能够正确地被包含在打包过程中。在pom.xml中的resources标签内添加如下配置： <resources> <resource> <directory>src/main/resources</directory> <filtering>true</filtering> </resource> <resource> <directory>src/main/java</directory> <includes> <include>**/*.xml</include> <include>**/*.json</include> <include>**/*.ftl</include> <include>**/*.xls</include> </includes> </resource> </resources> 这里的配置将src/main/java目录下的.xml、.json、.ftl以及.xls文件都纳入到资源打包范围。其中，src/main/resources目录下的资源按照默认的过滤规则处理（filtering为true），而对于src/main/java目录下指定类型的文件，则会按照我们的配置进行打包处理。 通过以上两步配置，我们既避免了 Maven 对 Excel 文件的错误转码，又确保了 Excel 文件能够正确地被包含在项目打包结果中，从而有效地解决了 Excel 文件在 Maven 打包后出现乱码的问题。 希望通过本文的介绍，能够帮助大家顺利解决在项目开发中遇到的 Maven 打包 Excel 文件乱码问题，让项目开发过程更加顺畅。在实际开发中，遇到类似问题时，深入分析问题产生的原因，并合理调整配置，往往能够快速找到解决方案。