java运行时异常：构建uberjar和zip包时“找不到内容类型的编写器”

Question

使用maven assembly插件构建uberjar然后打包成zip文件时，遇到运行时失败：

java.lang.RuntimeException: could not find writer for content-type text/xml type: java.lang.String

当我在 eclipse 中运行我的项目时，或者当我使用 eclipse Export -> Runnable Jar File 创建和可执行 .jar 时，不会发生这种故障，所以我怀疑我使用 maven 创建 uberjar 的方式有问题。

我该如何解决这个问题？

Answer 1

原来，我的问题的根源是与 Maven 程序集插件创建 jar 时发生的 javax.ws.rs.ext.Providers 文件冲突。（这个文件可以在 uberjar 中的 META-INF -> services -> javax.ws.rs.ext.Providers 中找到）

Providers 文件包含可用提供程序类的列表。在我的项目的依赖项中，这个文件存在于多个地方，不同的副本包含不同的提供者列表。maven 程序集插件只是选择一个版本包含在 jar 中，因此在运行时找不到所需的“编写器”类：该类未列在 jar 的 Providers 文件中。

我使用了 maven shade 插件来解决这个问题。阴影插件包含一个工具，可以选择性地合并依赖树中包含的重复文件。在 pom.xml 中：

  <transformer implementation="org.apache.maven.plugins.shade.resource.AppendingTransformer">
      <resource>META-INF/services/javax.ws.rs.ext.Providers</resource>
  </transformer>

通过附加 javax.ws.rs.ext.Providers 的任何重复项来告诉 Maven 进行合并。

此外，通过设置 maven shade 插件在package我的构建阶段执行，然后在该install阶段执行 maven assembly 插件，我能够创建一个可执行的 uberjar，然后将该 uberjar 打包到一个 .zip 文件中，所有这些都带有一个简单的mvn clean install调用。

这是我的 pom.xml 的样子：

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

   <parent>
      ...
   </parent>

   <groupId>com.foo.bar</groupId>
   <artifactId>my-app</artifactId>
   <packaging>jar</packaging>
   <version>2.1.0.0-SNAPSHOT</version>
   <name>My App</name>

   <url>http://maven.apache.org</url>

   <properties>
      <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
      <issues-product>MyApp</issues-product>
      <issues-component>MY-APP</issues-component>
   </properties>

   <dependencies>
      ...
   </dependencies>

   <build>
   <finalName>${project.artifactId}</finalName>
   <plugins>
    <plugin>
        <artifactId>maven-compiler-plugin</artifactId>
        <version>2.3.2</version>
        <configuration>
            <source>1.6</source>
            <target>1.6</target>
        </configuration>
    </plugin>
     <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-shade-plugin</artifactId>
        <version>2.1</version>
        <executions>
            <execution>
                <phase>package</phase>
                <goals>
                    <goal>shade</goal>
                </goals>
            <configuration>
            <createDependencyReducedPom>false</createDependencyReducedPom>
                <transformers>
                    <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
                        <mainClass>com.foo.bar.MyMainClass</mainClass>
                    </transformer>
                    <transformer implementation="org.apache.maven.plugins.shade.resource.AppendingTransformer">
                        <resource>META-INF/services/javax.ws.rs.ext.Providers</resource>
                    </transformer>
                </transformers>
                <filters>
                    <filter>
                        <artifact>*:*</artifact>
                    </filter>
                </filters>
                </configuration>
            </execution>
        </executions>
    </plugin>

    <plugin>
        <artifactId>maven-assembly-plugin</artifactId>
        <version>2.2.2</version>
        <configuration>
            <finalName>${project.artifactId}</finalName>
            <appendAssemblyId>false</appendAssemblyId>
            <descriptors>
                <descriptor>src/assembly/my-app-assembly.xml</descriptor>
            </descriptors>
         </configuration>
         <executions>
            <execution>
                <phase>install</phase>
                <goals>
                    <goal>single</goal>
                </goals>
            </execution>
        </executions>
    </plugin>
   </plugins>
</project>

这是 my-app-assembly.xml：

<assembly xmlns="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/2.2.2" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/2.2.2 http://maven.apache.org/xsd/assembly-2.2.2.xsd">
  <id>bin</id>
  <formats>
    <format>zip</format>
  </formats>
  <includeBaseDirectory>false</includeBaseDirectory>
  <fileSets>
    <fileSet>
      <directory>${project.basedir}</directory>
      <outputDirectory/>
      <includes>
        <include>Readme.pdf</include>
        <include>config\</include>
        <include>input\</include>
        <include>output\</include>
      </includes>
    </fileSet>
    <fileSet>
      <directory>${project.build.directory}</directory>
      <outputDirectory>bin\java\</outputDirectory>
      <includes>
        <include>my-app.jar</include>
      </includes>
    </fileSet>
  </fileSets>
</assembly>