Maven支持设置哪些编码？插件差异与编码依赖解析

我已经掌握Maven指定编码的配置方法，但想明确Maven支持的编码范围。从官方文档中只能找到maven-resources-plugin的模糊说明，仅列举了ASCII、UTF-8、UTF-16等示例，没有完整的支持列表。

为验证编码支持的标准，我在pom.xml中做了如下配置：

<plugins>
    <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-resources-plugin</artifactId>
        <version>3.2.0</version>
        <configuration>
            <encoding>UTF-8</encoding>
        </configuration>
    </plugin>

    <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-compiler-plugin</artifactId>
        <configuration>
            <encoding>UTF-8</encoding>
        </configuration>
    </plugin>
</plugins>

使用UTF-8编码时，构建正常，maven-resources-plugin日志显示：

[INFO] --- maven-resources-plugin:3.2.0:resources (default-resources) @ maven-encoding ---
[INFO] Using 'UTF-8' encoding to copy filtered resources.
[INFO] Using 'UTF-8' encoding to copy filtered properties files.

但将编码设置为unknown时，maven-compiler-plugin报错，构建失败，日志如下：

[INFO] Building maven-encoding 0.0.1-SNAPSHOT
[INFO] --------------------------------[ jar ]---------------------------------
[INFO] --- maven-resources-plugin:3.2.0:resources (default-resources) @ maven-encoding ---
[INFO] Using 'unknown' encoding to copy filtered resources.
[INFO] Using 'unknown' encoding to copy filtered properties files.
[INFO] skip non existing resourceDirectory <directory>
[INFO]
[INFO] --- maven-compiler-plugin:3.8.1:compile (default-compile) @ maven-encoding ---
[INFO] Changes detected - recompiling the module!
[INFO] Compiling 2 source files to <directory>
[INFO] ------------------------------------------------------------------------
[INFO] BUILD FAILURE
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  4.396 s
[INFO] Finished at: 2022-09-17T21:05:30+01:00
[INFO] ------------------------------------------------------------------------
[ERROR] Failed to execute goal org.apache.maven.plugins:maven-compiler-plugin:3.8.1:compile (default-compile) on project maven-encoding: Fatal error compiling: unknown -> [Help 1]
[ERROR]
[ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch.
[ERROR] Re-run Maven using the -X switch to enable full debug logging.

我注意到maven-resources-plugin未报错，而maven-compiler-plugin报错的差异，以下是核心结论与问题解答：

一、Maven支持的编码范围 #

Maven本身不维护独立的编码支持列表，所有支持的编码均来自运行Maven的JVM所支持的字符集。JVM的字符集列表可通过Java代码Charset.availableCharsets()获取，常见的UTF-8、GBK、ISO-8859-1、UTF-16等均属于标准支持范畴。

二、编码支持是否因插件而异？ #

是，不同Maven插件的编码处理逻辑相互独立，校验严格程度也有区别：

• maven-resources-plugin：仅在日志中提示使用了指定编码，不会提前校验编码有效性。若配置了JVM不支持的编码，可能在实际复制/过滤资源时才会抛出异常（如读取资源文件时出现乱码或解码错误）。
• maven-compiler-plugin：会在编译阶段直接校验编码是否被JVM支持，若配置无效编码（如示例中的unknown），会直接抛出编译错误导致构建失败。

三、支持的编码由Maven定义还是操作系统决定？ #

支持的编码由运行Maven的JVM决定，而非Maven本身或操作系统。JVM的字符集实现通常基于底层操作系统，但会有标准化统一实现（比如Oracle JDK的字符集支持列表不会因Windows/Linux差异出现大幅变化）。

内容的提问来源于stack exchange，提问作者Shaun