一、环境准备与项目结构分析

1.1 开发环境配置要求

CRMEB Java项目基于Spring Boot框架开发，建议使用JDK 1.8+环境。推荐使用IntelliJ IDEA或Eclipse作为开发工具，配合Maven 3.6+构建工具。在打包前需确认：

• JDK版本与项目pom.xml中配置一致
• Maven本地仓库无依赖冲突
• 项目编码统一设置为UTF-8

1.2 项目结构解析

典型CRMEB项目包含以下核心目录：

src/
├── main/
│   ├── java/        # Java源代码
│   ├── resources/   # 配置文件
│   │   ├── application.yml
│   │   └── mapper/   # MyBatis映射文件
│   └── webapp/      # Web资源（如有）
└── test/            # 测试代码

关键配置文件包括：

• pom.xml：Maven项目配置
• application.yml：Spring Boot应用配置
• logback-spring.xml：日志配置

二、Maven打包配置详解

2.1 基础pom.xml配置

确保pom.xml包含Spring Boot Maven插件：

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

2.2 依赖管理优化

建议使用<dependencyManagement>统一管理版本：

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-dependencies</artifactId>
            <version>2.7.5</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

2.3 多环境配置处理

通过profiles实现不同环境配置：

<profiles>
    <profile>
        <id>dev</id>
        <properties>
            <profileActive>dev</profileActive>
        </properties>
        <activation>
            <activeByDefault>true</activeByDefault>
        </activation>
    </profile>
    <profile>
        <id>prod</id>
        <properties>
            <profileActive>prod</profileActive>
        </properties>
    </profile>
</profiles>

对应application.yml需配置：

spring:
  profiles:
    active: @profileActive@

三、打包流程与参数配置

3.1 标准打包命令

在项目根目录执行：

mvn clean package

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

3.2 高级打包选项

3.2.1 跳过测试打包

mvn clean package -DskipTests

3.2.2 指定Profile打包

mvn clean package -Pprod

3.2.3 生成包含依赖的fat jar

Spring Boot插件默认生成包含所有依赖的可执行JAR，如需排除特定依赖：

<plugin>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-maven-plugin</artifactId>
    <configuration>
        <excludes>
            <exclude>
                <groupId>com.example</groupId>
                <artifactId>unnecessary-lib</artifactId>
            </exclude>
        </excludes>
    </configuration>
</plugin>

四、JAR文件运行与调试

4.1 基础运行方式

java -jar crmeb-1.0.0.jar

4.2 常用运行参数

参数	说明	示例
--server.port	指定端口	java -jar app.jar --server.port=8081
--spring.profiles.active	指定环境	java -jar app.jar --spring.profiles.active=prod
--debug	启用调试模式	java -jar app.jar --debug

4.3 内存参数配置

生产环境建议配置JVM参数：

java -Xms512m -Xmx1024m -XX:MetaspaceSize=256m -XX:MaxMetaspaceSize=512m -jar crmeb-1.0.0.jar

4.4 远程调试配置

java -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=5005 -jar crmeb-1.0.0.jar

五、常见问题解决方案

5.1 打包失败处理

5.1.1 依赖下载失败

• 检查网络连接
• 删除本地Maven仓库对应目录（~/.m2/repository/）
• 使用阿里云镜像加速：

  <mirrors>
    <mirror>
        <id>aliyunmaven</id>
        <mirrorOf>*</mirrorOf>
        <name>阿里云公共仓库</name>
        <url>https://maven.aliyun.com/repository/public</url>
    </mirror>
  </mirrors>

5.1.2 主类未找到错误

检查pom.xml中是否配置了主类：

<plugin>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-maven-plugin</artifactId>
    <configuration>
        <mainClass>com.crmeb.Application</mainClass>
    </configuration>
</plugin>

5.2 运行异常处理

5.2.1 端口冲突

使用netstat -ano | findstr 8080（Windows）或lsof -i :8080（Linux）查看占用端口进程

5.2.2 数据库连接失败

检查：

• application.yml中的数据库配置
• 数据库服务是否启动
• 网络连接是否正常

六、最佳实践建议

1. 版本管理：在pom.xml中固定所有依赖版本，避免使用LATEST或RELEASE
2. 配置分离：将敏感配置（如数据库密码）提取到外部配置文件
3. 日志优化：配置合理的日志级别和滚动策略
4. 健康检查：实现/actuator/health端点用于监控
5. 轻量化部署：考虑使用jlink创建定制JRE减少体积

七、进阶技巧

7.1 使用Docker部署

创建Dockerfile：

FROM openjdk:8-jre
VOLUME /tmp
ARG JAR_FILE=target/*.jar
COPY ${JAR_FILE} app.jar
ENTRYPOINT ["java","-Djava.security.egd=file:/dev/./urandom","-jar","/app.jar"]

构建命令：

docker build -t crmeb .
docker run -d -p 8080:8080 --name crmeb-app crmeb

7.2 持续集成配置

示例Jenkinsfile片段：

pipeline {
    agent any
    stages {
        stage('Build') {
            steps {
                sh 'mvn clean package -DskipTests'
            }
        }
        stage('Deploy') {
            steps {
                sh 'docker-compose up -d'
            }
        }
    }
}

通过以上详细步骤，开发者可以系统掌握CRMEB Java项目的打包部署流程。实际项目中，建议结合具体业务需求调整配置参数，并建立完善的发布流程规范。