Maven作为Java项目中广泛使用的构建工具，其打包jar文件的功能是开发流程中的核心环节，通过Maven，开发者可以高效地管理项目依赖、配置构建过程，并最终生成可执行的jar包，本文将详细阐述Maven打包jar的相关命令、配置选项以及常见场景,帮助读者全面掌握这一技能。
Maven提供了多种打包方式，最常用的是通过package生命周期阶段来生成jar包，在项目根目录下执行mvn package命令，Maven会自动编译源代码、运行测试（如果配置了测试阶段），并将项目依赖和资源文件打包到指定的jar文件中，默认情况下，生成的jar文件会存放在target目录下，文件名通常为${project.artifactId}-${project.version}.jar，这个命令是日常开发中最频繁使用的打包指令,适用于大多数标准Java项目。
对于需要将依赖库一同打包的场景，Maven提供了maven-assembly-plugin和maven-shade-plugin等插件。maven-assembly-plugin允许用户通过一个预定义的或自定义的描述符文件（通常是assembly.xml）来灵活控制jar包的结构，可以创建一个包含所有依赖的可执行jar，或者将依赖库单独放置在lib目录下，使用时，需要在pom.xml中配置插件，并指定描述符文件，然后通过mvn package assembly:single命令来执行打包，这种方式生成的jar包结构清晰,适合需要分离依赖库的场景。
而maven-shade-plugin则更常用于创建“胖jar”（Fat Jar）或“超级jar”（Uber Jar），即一个包含所有项目依赖的可执行jar文件，这种jar包可以直接通过java -jar命令运行，无需额外配置类路径，配置shade-plugin时，可以通过transformers选项处理重复的依赖文件（如META-INF/services目录），避免冲突，执行命令通常是mvn package shade:shade，需要注意的是，使用shade-plugin可能会导致某些依赖库的类加载问题，特别是在涉及反射或服务加载机制时,因此需要谨慎配置。
除了上述插件，Maven还内置了maven-jar-plugin，用于控制基础jar文件的生成，通过配置该插件，可以指定Main-Class属性，使生成的jar包可直接执行，在pom.xml的<build>部分添加<mainClass>com.example.Main</mainClass>，执行mvn package后，生成的jar包就可以通过java -jar命令运行，还可以配置manifestEntries来添加其他自定义的清单属性，如Class-Path等。
在实际开发中，打包过程可能需要跳过测试以提高构建速度，尤其是在频繁迭代时，可以使用mvn package -DskipTests或mvn package -Dmaven.test.skip=true命令来跳过测试执行，需要注意的是，跳过测试可能会引入潜在的风险，因此通常建议在持续集成（CI）环境中运行完整测试,而在本地开发时根据实际情况决定是否跳过。
对于多模块项目，Maven的打包命令同样适用，在父模块中执行mvn package会递归构建所有子模块，并生成各自的jar包，如果需要构建整个项目并生成聚合jar，可以结合maven-assembly-plugin或maven-shade-plugin进行配置，Maven还支持通过mvn clean package命令先清理之前的构建产物，再重新打包,确保生成的jar包是最新的代码。
在配置打包插件时，pom.xml的结构至关重要，以maven-shade-plugin为例，其基本配置包括<groupId>、<artifactId>、<version>以及<executions>部分，在<executions>中，可以定义<phase>为package，确保在打包阶段自动执行插件的shade目标，通过<configuration>可以指定transformers，如<transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">来设置Main-Class。
Maven的profiles功能可以用于在不同环境下生成不同配置的jar包，可以定义一个dev profile和一个prod profile，分别包含不同的依赖或资源配置，通过mvn package -Pdev或mvn package -Pprod命令，可以激活对应的profile，生成适合特定环境的jar包，这种方式在需要区分开发、测试和生产环境时非常有用。
在处理依赖冲突时，Maven的<dependencyManagement>和<dependencies>部分可以帮助控制依赖版本，而在打包阶段，maven-shade-plugin的<filters>选项可以用于排除不需要的依赖资源，减少jar包的大小，可以通过<filter>排除META-INF/目录下的某些文件,避免冲突。
生成的jar包可以通过jar tf命令查看其内容，确保依赖和资源文件已正确包含。jar tf target/my-app-1.0.jar会列出jar包中的所有文件，如果发现依赖缺失或配置错误，可以返回pom.xml检查依赖声明和插件配置,然后重新执行打包命令。
相关问答FAQs：
-
问：如何解决Maven打包后jar包无法运行的问题？
答：首先检查pom.xml中是否通过maven-jar-plugin或maven-shade-plugin正确配置了Main-Class，如果使用shade-plugin，确保已添加ManifestResourceTransformer并指定Main-Class，检查依赖是否已正确打包（对于shade-plugin，依赖应包含在fat jar中；对于assembly-plugin，确保依赖已放入lib目录或包含在jar中），使用java -jar命令运行时，确保jar文件路径正确，且系统环境变量配置无误，如果仍无法运行，可通过jar tf命令检查jar包内容,排查依赖或资源文件缺失问题。 -
问：Maven打包时如何排除特定依赖？
答：可以通过maven-shade-plugin的<filters>选项或maven-assembly-plugin的<excludes>配置来排除特定依赖，在shade-plugin的<configuration>中添加<filters>，如<filter><artifact>*:*</artifact><excludes><exclude>META-INF/*.SF</exclude></exclude></filters>，排除签名文件，对于assembly-plugin，可以在描述符文件中使用<excludes>标签指定要排除的依赖或文件路径，也可以在pom.xml的<dependency>中添加<optional>true</optional>，将该依赖标记为可选,避免被默认包含在打包结果中。
