在 Java 项目开发过程中，我们常常会使用 Maven 来管理项目依赖和进行项目打包。当涉及到使用 Freemarker 导出 Excel 文件时，不少开发者可能会遇到一个让人头疼的问题 ------Excel 文件在 Maven 打包后出现乱码。今天，我们就来深入探讨这个问题及其解决方案。
问题现象
在使用 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 文件乱码问题，让项目开发过程更加顺畅。在实际开发中，遇到类似问题时，深入分析问题产生的原因，并合理调整配置，往往能够快速找到解决方案。