<think>我们正在解决特定问题：使用maven
-shade
-plugin时，只生成了`
original-xxx.jar`而没有生成预期的`xxx
-shade.jar`文件。
根据经验，这通常是由于插件配置中缺少`<shadedClassifierName>`参数导致的。maven
-shade
-plugin默认会生成两个文件：
1. `
original-xxx.jar`：仅包含项目自身编译代码，不含依赖（原始JAR）
2. `xxx
-shade.jar`：包含所有依赖的超级JAR（我们需要的）
如果没有配置`<shadedClassifierName>`，插件默认使用`shaded`作为分类器（classifier），因此生成的超级JAR文件名应为`xxx
-shade.jar`。
但是，如果发现只生成了`
original-xxx.jar`，没有生成`xxx
-shade.jar`，可能的原因和解决方案如下：
### 原因分析
1. **未正确配置`<shadedClassifierName>`**（最常见原因）：
如果手动配置了`<shadedClassifierName>`为空字符串，则会导致超级JAR覆盖原始JAR，从而只留下一个重命名后的原始JAR（即`
original-xxx.jar`会被删除，而超级JAR会使用原始名称）。但根据问题描述，我们并没有得到`xxx
-shade.jar`，反而有`
original-xxx.jar`，所以更可能是没有配置分类器。
2. **插件执行被跳过**：
检查是否因为Maven生命周期阶段绑定问题导致插件未执行。
3. **依赖冲突或错误**：
如果项目没有依赖，或者依赖解析失败，也可能导致shade插件没有生成超级JAR。
### 解决方案
#### 步骤1：确认插件配置
在`pom.xml`中，确保`maven
-shade
-plugin`的配置中包含`<shadedClassifierName>`，并设置一个非空值（通常使用`shaded`，也可以自定义）。示例：
```xml
<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven
-shade
-plugin</artifactId>
<version>3.5.0</version> <!
-- 建议使用最新版本
-->
<executions>
<execution>
<phase>
package</phase>
<goals>
<goal>shade</goal>
</goals>
<configuration>
<!
-- 关键：设置分类器名称，生成的JAR将命名为xxx
-{shadedClassifierName}.jar
-->
<shadedClassifierName>shaded</shadedClassifierName>
<!
-- 其他配置如主类等
-->
</configuration>
</execution>
</executions>
</plugin>
</plugins>
</build>
```
这样配置后，Maven将生成两个文件：
- `target/
original-xxx.jar`：原始JAR（不含依赖）
- `target/xxx
-shaded.jar`：包含依赖的超级JAR
#### 步骤2：检查插件执行情况
运行Maven命令时添加`
-X`参数查看详细日志，确认shade插件是否执行：
```bash
mvn clean
package -X
```
在日志中搜索`maven
-shade
-plugin`，查看是否有执行记录和错误信息。
#### 步骤3：检查依赖是否存在
如果项目没有任何依赖，那么超级JAR和原始JAR内容相同，插件可能会跳过合并。但通常这种情况很少见。
#### 步骤4：检查版本兼容性
确保使用的maven
-shade
-plugin版本与Maven版本兼容。建议使用较新版本（如3.5.0+）。
### 配置示例详解
以下是一个完整配置示例，确保生成`xxx
-shaded.jar`：
```xml
<project>
...
<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven
-shade
-plugin</artifactId>
<version>3.5.0</version>
<executions>
<execution>
<phase>
package</phase>
<goals>
<goal>shade</goal>
</goals>
<configuration>
<shadedClassifierName>shaded</shadedClassifierName> <!
-- 指定分类器
-->
<!
-- 如果需要可执行JAR，配置主类
-->
<transformers>
<transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
<mainClass>com.example.Main</mainClass>
</transformer>
</transformers>
</configuration>
</execution>
</executions>
</plugin>
</plugins>
</build>
</project>
```
执行`mvn clean
package`后，检查`target`目录：
- `
original-projectname
-version.jar`：原始JAR
- `projectname
-version
-shaded.jar`：超级JAR（包含依赖）
### 常见错误配置
如果配置了`<shadedClassifierName>`为空字符串，则超级JAR会覆盖主构件（即生成的JAR文件名为`xxx.jar`，同时原始JAR被重命名为`
original-xxx.jar`）。此时，超级JAR和原始JAR都会存在，但超级JAR使用了主构件的名称。但根据问题描述，我们并没有得到`xxx
-shade.jar`，所以这种情况不符合。
因此，我们更倾向于认为问题是由于根本没有配置`<shadedClassifierName>`导致的。在没有配置的情况下，默认分类器是`shaded`，所以应该生成`xxx
-shaded.jar`。如果连这个文件都没有生成，那么可能是插件根本没有执行。
### 总结
1. **添加`<shadedClassifierName>`配置**（即使使用默认值，也建议显式配置）。
2. 运行`mvn clean
package`并检查输出目录。
3. 如果问题依旧，使用`mvn
-X`查看详细日志。
按照上述步骤操作，通常可以解决只生成`
original-xxx.jar`而不生成`xxx
-shade.jar`的问题[^1]。
§§相关问题§§
1. 如何配置maven
-shade
-plugin生成可执行JAR？
2. maven
-shade
-plugin的shadedClassifierName参数有什么作用？
3. 如何排除maven
-shade
-plugin打包中的某些依赖？
</think>
### 解决 maven
-shade
-plugin 未生成 `xxx
-shade.jar` 的问题
#### 问题原因
当 Maven Shade 插件只生成 `
original-xxx.jar` 而未生成预期的 `xxx
-shade.jar` 时，通常是以下原因导致：
1. **缺少 `<shadedClassifierName>` 配置**：插件默认生成 `
original-xxx.jar`（原始 JAR）和带分类器的 `xxx
-shaded.jar`（超级 JAR）。若未显式指定分类器名称，则不会生成 `
-shaded` 后缀的 JAR[^1]。
2. **配置错误**：插件配置位置不正确或未绑定到 `
package` 阶段。
#### 解决方案
##### 步骤 1：添加分类器配置
在插件配置中明确指定 `<shadedClassifierName>`：
```xml
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven
-shade
-plugin</artifactId>
<version>3.5.0</version>
<executions>
<execution>
<phase>
package</phase>
<goals>
<goal>shade</goal>
</goals>
<configuration>
<!
-- 关键配置：指定分类器名称
-->
<shadedClassifierName>shaded</shadedClassifierName>
</configuration>
</execution>
</executions>
</plugin>
```
执行 `mvn clean
package` 后，将在 `target/` 目录生成：
- `
original-yourArtifactId
-version.jar`（原始 JAR）
- `yourArtifactId
-version
-shaded.jar`（超级 JAR）
##### 步骤 2：验证插件绑定
确保插件绑定到 `
package` 阶段（如上述配置中的 `<phase>
package</phase>`），否则插件不会在打包时执行。
##### 步骤 3：检查依赖冲突
如果项目无任何依赖，Shade 插件可能不会生成超级 JAR。添加简单依赖测试：
```xml
<dependencies>
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons
-lang3</artifactId>
<version>3.12.0</version>
</dependency>
</dependencies>
```
#### 配置示例
完整可运行的 `pom.xml` 配置：
```xml
<project>
...
<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven
-shade
-plugin</artifactId>
<version>3.5.0</version>
<executions>
<execution>
<phase>
package</phase>
<goals>
<goal>shade</goal>
</goals>
<configuration>
<shadedClassifierName>shaded</shadedClassifierName>
<!
-- 可选：配置可执行JAR的主类
-->
<transformers>
<transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
<mainClass>com.example.Main</mainClass>
</transformer>
</transformers>
</configuration>
</execution>
</executions>
</plugin>
</plugins>
</build>
</project>
```
#### 结果验证
运行命令查看生成文件：
```bash
mvn clean
package
ls target/*.jar
```
正常输出应包含：
```
target/
original-yourProject
-1.0.jar
target/yourProject
-1.0
-shaded.jar # 包含所有依赖的超级JAR
```
> **关键点**：`<shadedClassifierName>` 是生成 `xxx
-shaded.jar` 的核心配置项。未显式设置时，插件可能仅生成原始 JAR 文件[^1]。
本文详细解析了Manifest.xml中package和original-package标签的用途，包括它们如何设置应用的进程名和源码包名，以及在配置组件时的不同使用方式。注意，虽然package属性告诉系统应用的进程名，但与original-package的值可以不同。
扫一扫
707
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
