本指南详细介绍 Java/Maven 项目在 Jenkins 上的自动化构建与部署流程。涵盖环境准备（Jenkins 部署、插件安装、工具配置）、Freestyle 基础模式配置（源码拉取、Maven 构建、SSH 部署）以及 Pipeline 流水线模式实现（Jenkinsfile 编写、多阶段执行）。同时提供凭证管理、依赖加速、常见问题排查等关键注意事项，助力实现从代码提交到自动部署的全链路自动化，提升交付效率。
自动化流程的稳定运行依赖基础环境支撑，需提前完成以下配置，避免后续环节出现权限、依赖缺失等问题。
docker run -d -p 8080:8080 -p 50000:50000 -v jenkins_home:/var/jenkins_home --name jenkins jenkins/jenkins:lts；启动后访问 http://服务器 IP:8080，根据页面提示输入容器内初始密码（命令：docker exec -it jenkins cat /var/jenkins_home/secrets/initialAdminPassword）。java -jar jenkins.war --httpPort=8080，后续访问和初始化步骤同上。yum install git -y；Ubuntu apt install git -y），确保能正常执行 git clone 命令。Jenkins 默认插件不足以支撑完整流程，需在「系统管理」→「插件管理」→「可选插件」中搜索安装以下插件，安装后重启 Jenkins 生效：
在 Jenkins「系统管理」→「全局工具配置」中，配置 JDK、Maven，确保 Jenkins 能找到对应工具（避免构建时出现'命令未找到'错误）：
/usr/local/jdk1.8.0_301），保存。/usr/local/apache-maven-3.8.8）；额外配置「Maven 设置」，选择'文件系统中的 settings.xml 路径'（如 /usr/local/apache-maven-3.8.8/conf/settings.xml），确保 settings.xml 中配置了镜像源（如阿里云），加速依赖下载，保存。ssh-keygen -t rsa -C "[email protected]"，一路回车生成密钥（默认路径 ~/.ssh/id_rsa）。cat ~/.ssh/id_rsa.pub，将公钥添加到 Git 仓库的「个人设置」→「SSH 密钥」中（如 Gitee 的「安全设置」→「SSH 公钥」）。~/.ssh/id_rsa 中的私钥（完整内容，包括 -----BEGIN RSA PRIVATE KEY----- 和 -----END RSA PRIVATE KEY-----），点击确定。~/.ssh/id_rsa.pub）添加到部署服务器的 ~/.ssh/authorized_keys 文件中，测试连接 ssh 部署服务器用户名@部署服务器 IP，确保无需输入密码即可登录。ping github.com 或 git clone 仓库地址）、部署服务器（测试 ping 部署服务器 IP），若有防火墙，需开放 8080（Jenkins 端口）、22（SSH 端口）、443（HTTPS 仓库）等端口。Freestyle 项目是 Jenkins 最基础、易上手的类型，适合快速搭建简单的自动化流程（单模块项目、无复杂流程依赖），核心链路：拉取 Git 代码 → Maven 编译打包 → 部署到远程服务器。
java-maven-demo-auto-deploy），选择「自由风格软件项目」，点击「确定」。[email protected]:xxx/java-maven-demo.git，SSH 地址需配置上述 SSH 凭证；HTTPS 地址需输入 Git 账号密码）。*/main（主分支），可改为 */dev（开发分支）等。根据实际需求选择触发方式，新手建议先选手动触发，熟悉后再配置自动触发：
0 12 * * 1-5 表示工作日中午 12 点构建）。
H 2 * * *：每天凌晨 2 点构建（H 表示随机时间，避免多项目同时触发导致服务器压力大）。H/30 * * * *：每 30 分钟构建一次（适合开发阶段频繁测试）。java-demo-2024），记录触发地址：http://Jenkins 服务器 IP:8080/job/项目名称/build?token=令牌（如 http://192.168.1.100:8080/job/java-maven-demo-auto-deploy/build?token=java-demo-2024）。此步骤实现 Java 项目的编译、清理、打包，核心是执行 Maven 命令：
clean package -DskipTests：清理旧构建产物（clean）→ 编译源码 → 打包（生成 jar/war 包，默认在 target 目录下）→ 跳过单元测试（-DskipTests，适合快速构建；正式环境建议去掉此参数，执行测试）。clean install -DskipTests：在打包的基础上，将产物安装到本地 Maven 仓库（适合多模块项目，依赖本地其他模块）。mvn test，并在后续「构建后操作」中配置测试报告展示。通过「Publish Over SSH」插件将 target 目录下的 jar/war 包上传到远程部署服务器，并执行启动脚本，完成部署：
demo-deploy-server，后续项目中选择使用）。192.168.1.101）。root）。/opt/deploy，可自定义，需确保该目录已存在）。demo-deploy-server）。
target/*.jar（上传 target 目录下所有 jar 包；若为 war 包，填写 target/*.war）。target（避免上传后在部署服务器生成 /opt/deploy/target/xxx.jar，直接上传到 /opt/deploy/xxx.jar）。demo，最终路径为 /opt/deploy/demo，需提前创建）。# 进入部署目录
cd /opt/deploy/demo
# 停止旧服务（根据 jar 包名称查找进程，强制杀死）
ps -ef | grep java-maven-demo-1.0-SNAPSHOT.jar | grep -v grep | awk '{print $2}' | xargs -r kill -9
# 启动新服务（后台运行，输出日志到 nohup.out）
nohup java -jar java-maven-demo-1.0-SNAPSHOT.jar > nohup.out 2>&1 &
java-maven-demo-1.0-SNAPSHOT.jar 替换为实际的 jar 包名称（可在项目 pom.xml 中指定固定名称，避免版本变化导致命令失效）。[Jenkins 构建通知] ${JOB_NAME} - 构建${BUILD_STATUS}）、邮件内容（包含构建日志、失败原因等），实现构建成功/失败的邮件告警。/opt/deploy/demo），执行 ps -ef | grep java，查看项目进程是否存在；访问项目接口（如 http://部署服务器 IP:端口/接口路径），验证服务是否正常。Freestyle 模式适合简单流程，但对于多模块、多环境（开发/测试/生产）、复杂依赖的项目，推荐使用 Pipeline 模式。Pipeline 通过 Jenkinsfile（Groovy 语法）定义全流程，支持版本化管理（将 Jenkinsfile 存入 Git 仓库）、流程可视化、多步骤联动等，是企业级 Jenkins 部署的主流方案。
java-maven-demo-pipeline）→ 选择「流水线」→「确定」。推荐将 Jenkinsfile 存入 Git 仓库（「Pipeline script from SCM」），实现流程的版本化管理；调试阶段可先使用「直接输入脚本」（「Pipeline script」）。
git add Jenkinsfile && git commit -m "add jenkinsfile for pipeline" && git push。Jenkinsfile（默认根目录，若在子目录需指定路径，如 docs/Jenkinsfile）→ 保存。在 Java/Maven 项目的 Git 仓库根目录下，创建文件 Jenkinsfile，写入以下声明式脚本（根据实际项目修改参数）：
// 声明式 Pipeline，指定运行节点（any 表示任意可用节点）
pipeline {
agent any
// 环境变量配置（集中管理，便于修改）
environment {
GIT_URL = '[email protected]:xxx/java-maven-demo.git' // Git 仓库地址
GIT_BRANCH = '*/main' // 构建分支
MAVEN_CMD = 'clean package -DskipTests' // Maven 构建命令
DEPLOY_SERVER = 'demo-deploy-server' // Jenkins 配置的 SSH 服务器名称
DEPLOY_DIR = '/opt/deploy/demo' // 部署服务器目录
JAR_NAME = 'java-maven-demo-1.0-SNAPSHOT.jar' // 项目 jar 包名称（pom.xml 中 finalName）
}
// 构建触发器（与 Freestyle 一致，可配置定时、WebHook）
triggers {
// 定时构建：每天凌晨 2 点
cron('H 2 * * *')
// WebHook 触发：需配合 Git 仓库配置，令牌与 Freestyle 一致
upstream('java-maven-demo-auto-deploy') // 可选：依赖其他项目构建完成后触发
}
// 构建阶段定义（可视化流程）
stages {
// 阶段 1：拉取 Git 代码
stage('拉取代码') {
steps {
echo "===== 开始拉取${GIT_BRANCH}分支代码 ====="
// 拉取代码，指定凭证（Jenkins 中配置的 Git SSH 凭证 ID）
git url: env.GIT_URL, branch: env.GIT_BRANCH, credentialsId: 'git-ssh-key'
}
}
// 阶段 2：Maven 编译打包
stage('编译打包') {
steps {
echo "===== 开始编译打包 ====="
// 执行 Maven 命令，指定 Maven 版本（全局工具配置中的名称）
withMaven(maven: 'Maven_3.8', mavenSettingsConfig: 'maven-settings') {
sh env.MAVEN_CMD
}
// 验证打包结果，若 target 目录下无 jar 包则构建失败
sh "if [ ! -f target/${JAR_NAME} ]; then echo '打包失败，未生成 jar 包'; exit 1; fi"
}
}
// 阶段 3：部署到远程服务器
stage('部署到服务器') {
steps {
echo "===== 开始部署到${DEPLOY_DIR} ====="
// 通过 SSH 上传文件并执行部署命令
sshPublisher(publishers: [
sshPublisherDesc(
configName: env.DEPLOY_SERVER,
transfers: [
sshTransfer(
sourceFiles: "target/${JAR_NAME}",
removePrefix: 'target',
remoteDirectory: env.DEPLOY_DIR,
// 部署命令：停止旧服务→启动新服务
execCommand: """
cd ${DEPLOY_DIR}
ps -ef | grep ${JAR_NAME} | grep -v grep | awk '{print $2}' | xargs -r kill -9
nohup java -jar ${JAR_NAME} > nohup.out 2>&1 &
echo '部署完成，查看日志：tail -f ${DEPLOY_DIR}/nohup.out'
"""
)
]
)
])
}
}
}
// 构建后操作（成功/失败的后续处理）
post {
// 构建成功时执行
success {
echo "===== 构建部署成功！项目地址：http://部署服务器 IP:端口 ="
// 可选：发送成功邮件
// emailext(to: '[email protected]', subject: '【成功】Jenkins 构建通知', body: '项目${JOB_NAME}构建成功，构建编号：${BUILD_NUMBER}')
}
// 构建失败时执行
failure {
echo "===== 构建部署失败！查看日志：${BUILD_URL}console ====="
// 可选：发送失败邮件
// emailext(to: '[email protected]', subject: '【失败】Jenkins 构建通知', body: '项目${JOB_NAME}构建失败，构建编号：${BUILD_NUMBER}，请查看日志排查问题')
}
// 无论成功/失败都执行
always {
echo "===== 构建流程结束 ====="
}
}
}
在项目配置的「流水线」模块，选择「Pipeline script」，将上述 Jenkinsfile 中的脚本直接粘贴到输入框中，修改环境变量（如 GIT_URL、JAR_NAME 等），保存后即可测试构建。
<mirror>），否则依赖下载缓慢或失败；示例镜像配置：
<mirror> <id>aliyunmaven</id> <name>阿里云中央仓库</name> <url>https://maven.aliyun.com/repository/public</url> <mirrorOf>central</mirrorOf> </mirror><finalName>java-maven-demo</finalName>，固定 jar 包名称（避免生成带版本号的 jar 包，导致部署命令失效）。xargs -r kill -9（-r 表示无进程时不执行 kill 命令，避免报错）；启动服务时，使用 nohup（后台运行），并指定日志输出路径（便于排查启动问题）。ENV = dev/test/prod），不同环境对应不同的部署服务器和配置文件。git clone 仓库地址，若失败则排查网络或权限问题。echo $PATH，确认 Maven 的 bin 目录（如 /usr/local/apache-maven-3.8.8/bin）已添加到环境变量。mvn）。nohup.out，排查启动错误（如端口被占用、配置文件错误、依赖缺失）。本文覆盖了 Java/Maven 项目 + Git 源码管理 + Jenkins 自动化构建部署的全流程，核心分为三个层面：
按照本文步骤配置后，即可实现「代码提交→自动构建→自动部署」的全链路自动化，减少手动操作，提升开发部署效率。若项目有特殊需求（如多模块构建、Docker 容器化部署、K8s 部署），可基于本文基础进行扩展。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具，Keycode 信息在线工具，online
JavaScript 字符串转义/反转义；Java 风格 \uXXXX（Native2Ascii）编码与解码。 在线工具，Escape 与 Native 编解码在线工具，online
使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具，JavaScript / HTML 格式化在线工具，online
Terser 压缩、变量名混淆，或 javascript-obfuscator 高强度混淆（体积会增大）。 在线工具，JavaScript 压缩与混淆在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online