如何在Maven中配置编码？

Question

当我maven install在我的多模块maven项目上运行时,我总是得到以下输出:

[WARNING] File encoding has not been set, using platform encoding UTF-8, i.e. build is platform dependent!

所以,我google了一下,但我能找到的是我必须添加:

<properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
</properties>

...到我的pom.xml.但它已经存在(在父母中pom.xml).

配置<encoding>maven-resources-plugin或maven-compiler-plugin也无法修复它.

所以有什么问题？

Answer 1

好的,我发现了问题.

我使用了一些报告插件.在failsafe-maven-plugin(http://maven.apache.org/plugins/maven-failsafe-plugin/integration-test-mojo.html)的文档中,我发现,<encoding>配置 - 当然 - ${project.reporting.outputEncoding}默认使用.所以我添加了属性作为元素的子元素,project现在一切都很好:

<properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
</properties>

也可以看看 http://maven.apache.org/general.html#encoding-warning

Answer 2

如果有人遇到上述解决方案无法解决的scandic字母问题,那么这将是以前的补充.

如果java源文件包含scandic字母,则需要由用于编译的Java正确解释它们.(例如常量中使用的scandic字母)

即使文件存储在UTF-8中并且Maven配置为使用UTF-8,Maven使用的系统Java仍将使用系统默认值(例如,在Windows中:cp1252).

只有通过maven运行测试才能看到这一点(可能在测试中打印这些常量的值.打印的scandic字母显示为'<？>')如果没有正确测试,这会破坏类文件作为编译结果并且是没有注意到.

要防止这种情况,您必须将用于编译的Java设置为使用UTF-8编码.仅在maven pom.xml中设置编码设置是不够的,您需要设置环境变量:JAVA_TOOL_OPTIONS = -Dfile.encoding = UTF8

此外,如果在Windows中使用Eclipse,则可能需要设置除此之外使用的编码(如果您通过eclipse运行单独测试).

Answer 3

如果你结合上面的答案,最后一个配置为UTF-8的pom.xml应该是这样的.

的pom.xml

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">

    <modelVersion>4.0.0</modelVersion>

    <groupId>YOUR_COMPANY</groupId>
    <artifactId>YOUR_APP</artifactId>
    <version>1.0.0-SNAPSHOT</version>

    <properties>
        <project.java.version>1.8</project.java.version>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
    </properties>

    <dependencies>
        <!-- Your dependencies -->
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>3.7.0</version>
                <configuration>
                    <source>${project.java.version}</source>
                    <target>${project.java.version}</target>
                    <encoding>${project.build.sourceEncoding}</encoding>
                </configuration>
            </plugin>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-resources-plugin</artifactId>
                <version>3.0.2</version>
                <configuration>
                    <encoding>${project.build.sourceEncoding}</encoding>
                </configuration>
            </plugin>
        </plugins>
    </build>
</project>

Answer 4

似乎人们将内容编码与构建的文件/资源​​编码混合在一起。只有 Maven 属性是不够的。有-Dfile.encoding=UTF8没有效果。为避免出现编码问题，您应该遵循以下简单规则

1. 设置maven编码，如上所述：

<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>

2. 在代码中处理文件、字符串、IO 时，始终明确设置编码。如果您不遵循此规则，您的应用程序将依赖于环境。在-Dfile.encoding=UTF8究竟是负责运行时环境的配置，但是我们不应该依赖于它。如果您有数千个客户端，则需要花费更多的精力来配置系统并因此发现问题。你只是对它有一个额外的依赖，你可以通过显式设置来避免它。Java 中使用默认编码的大多数方法都因此被标记为已弃用。

3. 确保您使用的内容也与您期望的编码相同。如果不是，前面的步骤就无所谓了！例如，如果文件的编码不是 UTF8 但您期望它，则文件将不会被正确处理。在 Linux 上检查文件编码：

$ file --mime F_PRDAUFT.dsv

4. 强制客户端/服务器在请求/响应中明确设置编码，以下是示例：

@Produces("application/json; charset=UTF-8")
@Consumes("application/json; charset=UTF-8")

希望这对某人有用。

Answer 5

尝试这个：

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