CRMEB Java项目：从开发到可运行JAR的完整打包指南

一、为什么需要打包可运行JAR？

在Java开发中，将项目打包成可运行的JAR文件是部署的核心环节。对于CRMEB这类基于Spring Boot的电商系统，可运行JAR的优势体现在：

1. 环境一致性：打包时锁定所有依赖版本，避免部署环境与开发环境不一致导致的兼容性问题。
2. 简化部署流程：无需单独安装Java运行环境（JRE）以外的任何依赖，通过java -jar命令即可启动。
3. 便于分发：单个文件包含所有代码和资源，适合通过Docker容器或云服务器部署。
4. 支持嵌入式服务器：Spring Boot内置Tomcat/Jetty，无需额外配置Web容器。

以CRMEB Pro版为例，其模块化设计（商品、订单、会员等）通过多模块Maven项目实现，打包时需确保所有子模块的依赖正确传递。

二、准备工作：环境与配置检查

1. 环境要求

• JDK 8+（推荐JDK 11或17，与CRMEB版本匹配）
• Maven 3.6+ 或 Gradle 7.0+
• 确保JAVA_HOME和MAVEN_HOME环境变量已配置

2. 项目结构验证

典型的CRMEB多模块项目结构如下：

crmeb-parent/
├── crmeb-common/       # 公共工具类
├── crmeb-admin/        # 后台管理模块
├── crmeb-api/          # 接口服务模块
└── pom.xml             # 父模块POM

检查各子模块的pom.xml是否正确声明父模块依赖：

<parent>
    <groupId>com.crmeb</groupId>
    <artifactId>crmeb-parent</artifactId>
    <version>1.0.0</version>
</parent>

3. 依赖冲突排查

运行mvn dependency:tree或gradle dependencies检查依赖树，重点关注：

• 不同模块是否引入了相同库的不同版本（如fastjson）
• Spring Boot相关依赖版本是否一致
• 数据库驱动（如MySQL Connector/J）版本兼容性

三、Maven项目打包详解

1. 基础打包命令

在项目根目录执行：

mvn clean package

此命令会：

1. 清理target/目录
2. 编译所有模块
3. 执行单元测试（若配置了<skipTests>false</skipTests>）
4. 生成各模块的JAR文件

2. 生成可执行JAR的关键配置

在父模块的pom.xml中添加Spring Boot Maven插件：

<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
            <version>2.7.0</version> <!-- 与Spring Boot版本一致 -->
            <executions>
                <execution>
                    <goals>
                        <goal>repackage</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

关键点：

• repackage目标会将普通JAR重打包为包含所有依赖的可执行JAR
• 插件版本必须与Spring Boot版本严格匹配
• 对于多模块项目，仅需在启动模块（如crmeb-api）的POM中配置

3. 自定义打包配置

排除测试依赖

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-surefire-plugin</artifactId>
    <version>2.22.2</version>
    <configuration>
        <skipTests>true</skipTests>
    </configuration>
</plugin>

指定主类（非Spring Boot项目）

若项目未使用Spring Boot，需通过<mainClass>指定入口：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-jar-plugin</artifactId>
    <version>3.2.0</version>
    <configuration>
        <archive>
            <manifest>
                <mainClass>com.crmeb.MainApplication</mainClass>
            </manifest>
        </archive>
    </configuration>
</plugin>

资源文件处理

确保src/main/resources下的配置文件（如application.yml）被正确打包：

<resources>
    <resource>
        <directory>src/main/resources</directory>
        <filtering>true</filtering>
    </resource>
</resources>

四、Gradle项目打包方案

1. 使用Spring Boot Gradle插件

在build.gradle中添加：

plugins {
    id 'org.springframework.boot' version '2.7.0'
    id 'io.spring.dependency-management' version '1.0.11.RELEASE'
}
bootJar {
    archiveFileName = 'crmeb.jar'
    mainClass = 'com.crmeb.MainApplication'
}

2. 执行打包命令

gradle clean bootJar

生成的JAR文件位于build/libs/目录。

3. 多模块项目配置

子模块需应用父模块的插件配置：

// 父模块build.gradle
subprojects {
    apply plugin: 'java'
    // 其他公共配置
}
// 启动模块build.gradle
apply plugin: 'org.springframework.boot'

五、打包后验证与调试

1. JAR文件结构检查

使用jar tf crmeb.jar查看内容，应包含：

• BOOT-INF/classes/：项目编译类
• BOOT-INF/lib/：所有依赖JAR
• META-INF/MANIFEST.MF：包含Main-Class信息

2. 运行测试

java -jar crmeb.jar

常见问题及解决方案：

• 端口冲突：添加参数指定端口--server.port=8081
• 配置文件覆盖：使用--spring.config.location=file:/path/to/application.yml
• 内存不足：调整JVM参数-Xms512m -Xmx1024m

3. 日志与调试

启用DEBUG日志：

java -jar crmeb.jar --debug

或通过logging.level.root=DEBUG在application.properties中配置。

六、高级打包技巧

1. 构建多环境JAR

使用Maven Profile区分开发/生产环境：

<profiles>
    <profile>
        <id>prod</id>
        <build>
            <resources>
                <resource>
                    <directory>src/main/resources-prod</directory>
                </resource>
            </resources>
        </build>
    </profile>
</profiles>

打包命令：mvn package -Pprod

2. 生成包含依赖的ZIP包

结合maven-assembly-plugin创建包含启动脚本和配置文件的ZIP：

<plugin>
    <artifactId>maven-assembly-plugin</artifactId>
    <configuration>
        <descriptorRefs>
            <descriptorRef>jar-with-dependencies</descriptorRef>
        </descriptorRefs>
        <archive>
            <manifest>
                <mainClass>com.crmeb.MainApplication</mainClass>
            </manifest>
        </archive>
    </configuration>
</plugin>

3. Docker化部署

创建Dockerfile：

FROM openjdk:11-jre-slim
VOLUME /tmp
ARG JAR_FILE=target/crmeb.jar
COPY ${JAR_FILE} app.jar
ENTRYPOINT ["java","-jar","/app.jar"]

构建镜像：

docker build -t crmeb .

七、常见问题解决方案

1. 主类未找到错误

现象：Error: Could not find or load main class com.crmeb.MainApplication
原因：

• 主类路径配置错误
• 打包时未包含主类
  解决：
• 检查MANIFEST.MF中的Main-Class属性
• 确保主类位于src/main/java目录

2. 依赖冲突导致NoClassDefFoundError

现象：启动时报类找不到错误
解决：

1. 运行mvn dependency:tree -Dverbose分析依赖树
2. 使用<exclusions>排除冲突依赖
3. 统一依赖版本（通过<dependencyManagement>）

3. 打包后文件权限问题

现象：Linux下java -jar报权限拒绝
解决：

• 打包时添加执行权限：chmod +x crmeb.jar
• 或通过脚本启动：

  #!/bin/bash
  java -jar crmeb.jar

八、最佳实践建议

1. 版本控制：在pom.xml中固定所有插件版本，避免构建不一致
2. 持续集成：将打包步骤集成到Jenkins/GitLab CI流程中
3. 多环境配置：使用Spring Profile区分不同环境的配置
4. 轻量化部署：考虑使用JLink创建自定义JRE，减少部署包体积
5. 健康检查：在Spring Boot Actuator中启用健康端点，便于监控

通过以上步骤，您可以高效地将CRMEB Java项目打包为可运行的JAR文件，实现从开发到部署的全流程自动化。实际项目中，建议结合CI/CD工具（如Jenkins）构建自动化流水线，进一步提升部署效率。