一、环境准备与依赖管理

1.1 开发环境配置

CRMEB Java项目基于Spring Boot框架构建，需确保开发环境满足以下要求：

• JDK 8或更高版本（推荐JDK 11）
• Maven 3.6+或Gradle 7.0+构建工具
• IDE（如IntelliJ IDEA或Eclipse）

验证环境：

java -version  # 确认JDK版本
mvn -v         # 确认Maven版本

1.2 依赖管理

项目依赖通过Maven的pom.xml或Gradle的build.gradle管理。关键依赖包括：

• Spring Boot Starter Web
• MyBatis Plus
• Redis/MySQL驱动
• CRMEB核心库

Maven依赖示例：

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    <dependency>
        <groupId>com.baomidou</groupId>
        <artifactId>mybatis-plus-boot-starter</artifactId>
        <version>3.5.3.1</version>
    </dependency>
</dependencies>

二、构建工具配置

2.1 Maven配置

在pom.xml中添加Spring Boot Maven插件，用于打包和运行：

<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
            <version>2.7.0</version>
            <executions>
                <execution>
                    <goals>
                        <goal>repackage</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

2.2 Gradle配置

若使用Gradle，在build.gradle中添加：

plugins {
    id 'org.springframework.boot' version '2.7.0'
    id 'io.spring.dependency-management' version '1.0.11.RELEASE'
}
bootJar {
    mainClass = 'com.crmeb.Application'  # 替换为实际主类
}

三、打包可运行JAR文件

3.1 使用Maven打包

1. 清理项目：

   mvn clean

2. 打包项目：

   mvn package

   生成的可运行JAR位于target/目录下，文件名格式为crmeb-<version>.jar。

3. 运行JAR：

   java -jar target/crmeb-<version>.jar

3.2 使用Gradle打包

1. 执行打包任务：

   gradle bootJar

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

2. 运行JAR：

   java -jar build/libs/crmeb-<version>.jar

四、高级打包配置

4.1 自定义JAR名称

在Maven中通过finalName配置：

<build>
    <finalName>crmeb-custom</finalName>
</build>

4.2 排除测试依赖

打包时排除测试类：

mvn package -DskipTests

4.3 多环境配置

通过application-{profile}.properties管理不同环境配置，打包时指定激活的profile：

java -jar crmeb.jar --spring.profiles.active=prod

五、常见问题与解决方案

5.1 主类未找到错误

错误现象：

Error: Could not find or load main class com.crmeb.Application

解决方案：

• 确认pom.xml或build.gradle中指定的主类路径正确。
• 检查MANIFEST.MF文件是否包含Main-Class属性。

5.2 依赖冲突

错误现象：

java.lang.NoSuchMethodError: com.example.Class.method()

解决方案：

• 使用mvn dependency:tree分析依赖树。
• 通过<exclusions>排除冲突依赖。

5.3 端口占用

错误现象：

Web server failed to start. Port 8080 was already in use.

解决方案：

• 修改application.properties中的端口：

  server.port=8081

• 或终止占用端口的进程。

六、优化与扩展

6.1 瘦身JAR文件

使用maven-shade-plugin排除无用依赖：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-shade-plugin</artifactId>
    <version>3.2.4</version>
    <executions>
        <execution>
            <phase>package</phase>
            <goals>
                <goal>shade</goal>
            </goals>
            <configuration>
                <minimizeJar>true</minimizeJar>
            </configuration>
        </execution>
    </executions>
</plugin>

6.2 Docker化部署

1. 创建Dockerfile：

   FROM openjdk:11-jre-slim
   COPY target/crmeb.jar /app/crmeb.jar
   WORKDIR /app
   ENTRYPOINT ["java", "-jar", "crmeb.jar"]

2. 构建镜像：

   docker build -t crmeb .

3. 运行容器：

   docker run -p 8080:8080 crmeb

七、总结与最佳实践

1. 版本控制：固定构建工具和插件版本，避免兼容性问题。
2. 自动化：集成CI/CD流水线（如Jenkins、GitHub Actions）实现自动化打包。
3. 日志管理：配置logback-spring.xml统一管理日志。
4. 监控：集成Spring Boot Actuator暴露健康检查端点。

通过以上步骤，开发者可高效完成CRMEB Java项目的打包与部署，确保项目在生产环境中稳定运行。