maven 编译时报错：编码 UTF-8 的不可映射字符

最新推荐文章于 2025-10-02 09:16:56 发布

原创最新推荐文章于 2025-10-02 09:16:56 发布 · 4.8w 阅读

7 ·

CC 4.0 BY-SA版权

文章标签：

#maven #编码 UTF-8 的不可映射字符

maven 专栏收录该内容

15 篇文章

订阅专栏

本文介绍了解决Maven编译过程中出现“编码gbk的不可映射字符”的问题。该问题通常发生在中文系统环境下，当代码使用UTF-8编码而Maven使用默认的GBK编码时。解决方案是在pom.xml文件中的maven-compiler-plugin插件中明确指定使用UTF-8编码。

解决这个问题的思路：
　　在maven的编译插件中声明正确的字符集编码编码——编译使用的字符集编码与代码文件使用的字符集编码一致。
　　安装系统之后，一般中文系统默认字符集是GBK。我们安装的软件一般都继承使用操作系统的默认字符集。
　　所以，在很多中文XP win7的用户，在使用maven（mvn compile）编译项目的时候，就会出现“编码 gbk 的不可映射字符”： 
　　这个是由于代码使用的UTF-8，而maven编译的时候使用的GBK的缘故。 通过修改pom文件，可以告诉maven这个项目使用UTF-8来编译。在pom的/project/build/plugins/下的编译插件声明 中加入下面的配置：
<plugin>  
    <groupId>org.apache.maven.plugins</groupId>  
    <artifactId>maven-compiler-plugin</artifactId>  
    <version>2.3.1</version>  
    <configuration>  
        <source>1.6</source>  
        <target>1.6</target>  
        <encoding>utf8</encoding>    
    </configuration>  
</plugin>