maven异常解决：编码GBK的不可映射字符

Posted 2020-08-26 艺意

直接将项目改为UTF-8编码，无效！

要通过修改pom.xml文件，告诉maven这个项目使用UTF-8来编译。

一、问题描述

　　今天在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文件中添加下面的配置：

　　<!-- 指明编译源代码时使用的字符编码，maven编译的时候默认使用的GBK编码， 通过project.build.sourceEncoding属性设置字符编码，告诉maven这个项目使用UTF-8来编译 -->
　　<properties>  
        <!-- 文件拷贝时的编码 -->  
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>  
        <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>  
        <!-- 编译时的编码 -->  
        <maven.compiler.encoding>UTF-8</maven.compiler.encoding>  
    </properties>  

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

　　　　<encoding>utf8</encoding>

<plugin>
    <artifactId>maven-compiler-plugin</artifactId>
    <configuration>
        <source>1.6</source>
        <target>1.6</target>
        <!-- 指明编译源代码时使用的字符编码，
        maven编译的时候默认使用的GBK编码， 
          通过encoding属性设置字符编码，
          告诉maven这个项目使用UTF-8来编译 -->
　　　　<!-- 指定编码格式，否则在DOS下运行mvn compile命令时会出现莫名的错误，因为系统默认使用GBK编码 -->
        <encoding>utf8</encoding> 
    </configuration>
</plugin>
<plugin>  
    <groupId>org.apache.maven.plugins</groupId>  
    <artifactId>maven-resources-plugin</artifactId>  
    <version>2.6</version>  
    <configuration>  
       <encoding>UTF-8</encoding><!-- 指定编码格式，否则在DOS下运行mvn命令时当发生文件资源copy时将使用系统默认使用GBK编码 -->  
    </configuration>  
</plugin>  

 

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

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

本文转自：oO归去来兮Oo