使用Maven编译项目遇到——“maven编码gbk的不可映射字符”解决办法

Posted 2022-02-08 oO归去来兮Oo

一、问题描述

　　今天在MyEclipse中使用Maven编译项目源代码时，结果如下了如下的错误

百思不得其解啊，java源代码在MyEclipse中显示是没有任何错误的，可是执行"maven install"命令编译项目时就会出现上述的错误，导致项目编译失败。这个问题还是第一次遇到，还好在这里http://capslk.iteye.com/blog/1419958看到了解决问题的办法。

二、解决办法

　　解决这个问题的思路： 在maven的编译插件中声明正确的字符集编码编码——编译使用的字符集编码与代码文件使用的字符集编码一致！！

　　安装系统之后，一般中文系统默认字符集是GBK。我们安装的软件一般都继承使用操作系统的默认字符集。所以当在中文XP或者win7系统开发，在使用maven（mvn compile）编译项目的时候，就会出现“编码 gbk 的不可映射字符”： 这个是由于代码使用的UTF-8，而maven编译的时候使用的GBK的缘故。 可以通过修改项目的pom文件，可以告诉maven这个项目使用UTF-8编码来编译。在项目的pom.xml文件中添加下面的配置：

1 <!-- 指明编译源代码时使用的字符编码，maven编译的时候默认使用的GBK编码， 通过project.build.sourceEncoding属性设置字符编码，告诉maven这个项目使用UTF-8来编译 -->
2     <properties>
3         <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
4     </properties>

或者在pom.xml的/project/build/plugins/下的 编译插件声明 中加入下面的配置：

1 <encoding>utf8</encoding>

<plugin>
    <artifactId>maven-compiler-plugin</artifactId>
    <configuration>
        <source>1.6</source>
        <target>1.6</target>
        <!-- 指明编译源代码时使用的字符编码，
        maven编译的时候默认使用的GBK编码， 
          通过encoding属性设置字符编码，
          告诉maven这个项目使用UTF-8来编译 -->
        <encoding>utf8</encoding> 
    </configuration>
</plugin>

这两种方案都可以解决上述的问题，可以根据个人习惯来设置，如下图所示方式是采用配置<project.build.sourceEncoding>属性来指明编译采用的字符编码。

今天被这个问题折腾够久了，还好及时找到了解决办法，在此记录一下解决方案。