如何在Maven中配置编码？

Question

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

[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）。

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

所以有什么问题？

Answer 1

好的，我发现了问题。

我使用了一些报告插件。在failafe-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.hml

<?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

试试这个：

<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>

Answer 5

似乎人们将内容编码与内置文件/资源​​编码混合在一起。只有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 6

在我的情况下，我使用maven-dependency-plugin所以为了解决这个问题我必须添加以下属性：

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

见Apache Maven Resources Plugin / Specifying a character encoding scheme