全网最细！Maven 编译构建 Java Web 项目从入门到实战一文吃透-平芜编程栈

使用Maven编译并构建java web项目

一、Maven概述

Maven，是一个专为Java平台设计的项目管理和构建工具。其核心思想在于“约定优于配置，通过提供一套默认的构建和依赖管理规则，降低了项目配置的复杂性，使开发者能够专注于业务逻辑的实现。Maven不仅支持项目的构建、依赖管理，还涵盖了项目文档生成、版本控制集成、部署发布等多个方面，为Java项目的全生命周期管理提供了全面的解决方案。

二、Maven的构建生命周期

Maven定义了三个主要的构建生命周期：Clean生命周期、Default（Build）生命周期和Site生命周期。

1、Clean生命周期

用于清理项目。它包含pre-clean、clean和post-clean三个阶段。执行mvn clean命令时，会删除上一次构建生成的文件，确保项目从一个干净的状态开始。

2、Default（Build）生命周期

这是Maven最常用的生命周期，涵盖了项目构建的主要阶段。从validate到deploy，共包括14个阶段。每个阶段都有特定的任务和目标，如编译源代码、运行测试、打包项目等。通过执行相应的Maven命令（如mvn compile、mvn test、mvn package等），可以触发这些阶段的执行。其中：

命令	作用	输出产物
`mvn compile`	编译源码	target/classes 下的 .class 文件
`mvn test`	运行单元测试	测试报告
`mvn package`	打包项目	JAR（普通项目）/ WAR（Web 项目）
`mvn clean package`	清理 + 打包	最终可部署包（最常用）

mvn clean package 这是一个组合命令，包含两个阶段：

`clean`阶段：

含义：清理项目构建产物
作用：删除target目录及其所有内容，确保从干净的状态开始构建

`package`阶段：

含义：将项目打包成可分发的格式
作用：

- 执行完整的构建生命周期：validate→compile→test→package
- 对于普通 Java 项目，会打成 JAR 包
- 对于 Web 项目，会打成 WAR 包
- 打包后的文件存放在target目录中

使用场景：当需要生成可部署的应用包时，通常会先清理再打包，确保没有旧的构建产物影响新的构建结果。

3、Site生命周期

用于生成项目的文档和站点信息。它包含pre-site、site、post-site和site-deploy等阶段。通过执行mvn site命令，可以生成项目的站点文档并将其发布到远程服务器。

三、Maven的安装与配置

下面的操作均在openEuler下完成。注意，安装Maven 之前，需要先装并配置好 JDK（配置JAVA_HOME环境变量），否则任何mvn compile/package都会报错“找不到 javac”。Maven 默认调用javac把.java编译成.class，javac只在 JDK 里提供，JRE 没有。因此，Maven 必须依赖 JDK（不仅仅是 JRE），需要提前安装好。

1、安装jdk

可使用两个jdk发行版，Oracle JDK和OpenJDK：

Oracle JDK：https://www.oracle.com/java/
OpenJDK：https://openjdk.org/

Oracle JDK 与 OpenJDK 在技术代码层面几乎一样，最大分水岭是许可证，OpenJDK基于GPLv2 完全免费，Oracle JDK 生产环境必须付费；功能、性能差异已缩小到 1% 以内，选谁主要看“要不要为法律风险买单”。

个人、开源、云原生、CI/CD、企业不想付许可费，可选 OpenJDK；金融、电信等强监管行业，且已购买 Oracle 服务合同，需要官方背书，长期支持与专属补丁，可选择选 Oracle JDK。

这里安装Oracle JDK，以jdk11为例，将二进制安装包上传到服务器/data目录中，然后执行如下操作：

[root@server ]# mkdir /usr/java [root@server data]# tar -xvf ./java-11-openjdk-11.0.20.0.8-1.portable.jdk.el.x86_64.tar.xz -C /usr/java [root@server data]# cd /usr/java [root@server java]# mv java-11-openjdk-11.0.20.0.8-1.portable.jdk.el.x86_64 jdk11

最后，还需要添加java环境变量，打开/etc/profile文件

vi /etc/profile

在文件最后，添加如下内容：

export JAVA_HOME=/usr/java/jdk11 export PATH=${JAVA_HOME}/bin:$PATH

最后，进行验证：

[root@server ]# source /etc/profile [root@server ]# java -version

安装成功如下所示

2、下载Maven

进入官网下载地址：https://maven.apache.org/download.cgi ，maven提供了二进制和源码安装包，推荐使用二进制包，选择合适的版本下载即可。

3、解压安装

[root@server ]# tar -zxvf apache-maven-x.x.xx-bin.tar.gz -C /usr/local [root@server ]# cd /usr/local/ [root@server ]# mv apache-maven-x.x.xx maven

这里将maven解压安装到了/usr/local下。

4、设置环境变量

编辑vi /etc/profile，添加环境变量如下：

# MAVEN 的根路径 export MAVEN_HOME=/usr/local/maven export PATH=$MAVEN_HOME/bin:$PATH

执行source /etc/profile，立即生效

5、检验是否安装成功

执行mvn -v命令，查看输入版本信息，例如：

[root@server maven]# mvn -v

安装成功如下图所示：

四、使用maven编译一个java项目JPress

1、获取JPress源码

JPress是一个开源的CMS系统，JPress源码地址：https://gitee.com/JPressProjects/jpress

点击图注1的（克隆/下载）按钮有俩种获取jpress源码的方式

1、直接下载 zip 包然后再本地解压即可
2、复制链接使用 git 拉取源码（推荐）

git clone https://gitee.com/JPressProjects/jpress.git

2、源码编译jpress

在编译之前，请先配置好当前服务器的 Maven 环境，和 JDk 环境。输入编译命令mvn clean package然后回车等待编译结束。

[root@server ~]# unzip jpress-v5.x.zip [root@server ~]# cd jpress-v5.x [root@server jpress-v5.1.2]# mvn clean package

mvn clean package阶段，第一次运行，执行时间会比较长，等待即可。出现如下界面，说明编译完成：

编译完成后，在jpress当前目录找到starter/target/子目录，会发现有类似starter-5.0.jar和starter-5.0.zip包

这就是编译完成后的压缩包。

3、安装mysql数据库

这里使用二进制安装mysql，使用版本为mysql-8.4.3，安装过程如下：

[root@mysql ~]# tar xvf mysql-8.4.3-linux-glibc2.28-x86_64.tar.xz -C /usr/local [root@mysql ~]# cd /usr/local/ [root@mysql local]# mv mysql-8.4.3-linux-glibc2.28-x86_64 mysql [root@mysql local]# mkdir /usr/local/mysql/data [root@mysql local]# mkdir /usr/local/mysql/etc [root@mysql local]# mkdir /usr/local/mysql/logs [root@mysql local]# useradd mysql

然后，创建一个mysql配置文件，继续执行如下操作：

[root@mysql ~]# vim /usr/local/mysql/etc/my.cnf [mysqld] datadir=/usr/local/mysql/data socket=/tmp/mysql.sock log-error=/usr/local/mysql/logs/mysqld.log pid-file=/usr/local/mysql/logs/mysqld.pid

接着，给mysql授权，并执行初始化操作：

[root@mysql ~]# chown -R mysql:mysql /usr/local/mysql [root@mysql ~]# cd /usr/local/mysql [root@mysql mysql]# bin/mysqld --initialize --user=mysql --basedir=/usr/local/mysql --datadir=/usr/local/mysql/data [root@mysql mysql]# rm -rf /etc/my.cnf

接着，再写一个mysql服务管理脚本/etc/systemd/system/mysqld.service，内容如下：

[Unit] Description=MySQL Server After=network.target [Service] User=mysql Group=mysql ExecStart=/usr/local/mysql/bin/mysqld_safe --defaults-file=/usr/local/mysql/etc/my.cnf ExecReload=/bin/kill -HUP $MAINPID ExecStop=/bin/kill -TERM $MAINPID Restart=on-failure [Install] WantedBy=multi-user.target

然后启动服务：

[root@mysql ~]# systemctl daemon-reload [root@mysql ~]# systemctl start mysqld

Mysql启动成功后，需要重置root密码，临时密码在上面定义的mysql日志文件/usr/local/mysql/logs/mysqld.log中可以查到。

cat /usr/local/mysql/logs/mysqld.log | grep password

找到临时密码后，执行如下sql

[root@mysql ~]# /usr/local/mysql/bin/mysql -uroot -p 输入临时密码:

上面进入mysql命令行时，如果提示如下错误：

[root@mysql ~]# /usr/local/mysql/bin/mysql -uroot -p bin/mysql: error while loading shared libraries: libtinfo.so.5: cannot open shared object file: No such file or directory

这里需要做一个软链接，操作如下：

[root@mysql mysql]# ln -s /usr/lib64/libtinfo.so.6 /usr/lib64/libtinfo.so.5

最后，进入sql命令行后，执行如下命令，修改root密码：

SQL&gt; alter user 'root'@'localhost' identified by 'abc123456';

到这里为止，mysql服务部署完成。

4、部署并运行JPress项目

运行java项目，操作如下：

[root@server ~]# mkdir -p /data/jpress [root@server ~]# cp jpress-v5.x/starter/target/starter-5.0.zip /data/jpress [root@server ~]# cd /data/jpress [root@server jpress]# unzip starter-5.0.zip

默认开启 80 端口，可浏览器访问服务器 IP 进入 JPress 安装页面。

要停止服务，可执行如下命令：

[root@server jpress]# ./jpress.sh stop

要重启服务，可执行如下命令：

[root@server jpress]# ./jpress.sh restart

5、启动脚本核心配置说明

解压后目录中的jpress.sh是 JPress 的核心启动脚本，可通过修改脚本自定义 JVM 参数、运行模式和后台启动方式，核心配置如下：

# Java 命令行参数，根据需要开启下面的配置，改成自己需要的，注意等号前后不能有空格 # JAVA_OPTS="-Xms256m -Xmx1024m -Dundertow.port=80 -Dundertow.host=0.0.0.0" JAVA_OPTS="-Dundertow.port=8080 -Dundertow.host=0.0.0.0 -Dundertow.devMode=false"

第一行（注释状态）：配置 JVM 初始堆内存-Xms、最大堆内存-Xmx、服务端口-Dundertow.port、绑定地址-Dundertow.host=0.0.0.0（允许所有 IP 访问）
第二行（生效状态）：生产环境推荐配置，关闭开发模式-Dundertow.devMode=false，关闭热加载、调试功能，提升运行稳定性和安全性

启动方式配置

当前默认启动为前台运行，控制台实时输出日志，一旦执行Ctrl+C或关闭终端，服务就会停止。可通过修改脚本中的启动命令，切换为后台运行，4 种启动方式说明如下：

# 运行为后台进程，并在控制台输出信息 java -Djava.awt.headless=true -Xverify:none ${JAVA_OPTS} -cp ${CP} ${MAIN_CLASS} & # 运行为后台进程，并且不在控制台输出信息 # nohup java -Djava.awt.headless=true -Xverify:none ${JAVA_OPTS} -cp ${CP} ${MAIN_CLASS} >/dev/null 2>&1 # 运行为后台进程，并且将信息输出到 output.log 文件 #nohup java -Djava.awt.headless=true -Xverify:none ${JAVA_OPTS} -cp ${CP} ${MAIN_CLASS} > output.log & #tail -f /dev/null # 运行为非后台进程，多用于开发阶段，快捷键 ctrl + c 可停止服务 # 当以此方式在Docker下启动时，由于是后台进程，无前台进程，Docker容器启动后会马上退出

生产环境推荐配置

用vim编辑jpress.sh脚本：
```
[root@server jpress]# vim jpress.sh
```
注释掉默认的前台启动行，取消第三行（日志输出到文件）的注释，修改为完整生产配置：
```
# 运行为后台进程，并且将信息输出到 output.log 文件（生产推荐） nohup java -Djava.awt.headless=true -Xverify:none ${JAVA_OPTS} -cp ${CP} ${MAIN_CLASS} > output.log 2>&1 & tail -f /dev/null
```
补充：添加2>&1将错误日志也写入output.log，避免报错日志丢失，方便问题排查

保存退出后，重启服务使配置生效：

[root@server jpress]# ./jpress.sh stop [root@server jpress]# ./jpress.sh start

验证，关闭终端后重新连接后：

ps -ef | grep jpress #查看Java进程 tail -f /data/jpress/output.log #可实时查看服务日志

五、基于mvnw构建java应用项目

1、mvnw是什么

mvnw是 Maven Wrapper 的缩写，是 Maven 官方提供的一个“项目自带、版本锁定、无需本地安装 Maven”的启动脚本。它和 Maven 的关系可以用一句话概括：mvnw = 一个壳，负责帮你下载并调用与项目绑定版本的 mvn 命令。

每个包含mvnw的项目在根目录下会多出 4 个文件：

mvnw （Linux/Mac 脚本）

mvnw.cmd （Windows 脚本）

.mvn/wrapper/maven-wrapper.jar

.mvn/wrapper/maven-wrapper.properties （指定要用的 Maven 版本、下载地址等）

2、mvnw工作流程

你执行./mvnw clean package（或mvnw.cmd clean package）。
脚本检查~/.m2/wrapper里是否已经下载过properties中指定的 Maven 版本。
若没有，就自动从 Apache 官方镜像下载对应版本的 Maven 压缩包并解压到本地缓存。
用下载好的 Maven 执行后续生命周期。

3、基于mvnw的应用项目实践

此项目是Spring 官方提供的示例项目，展示如何使用 Spring Boot 构建一个完整的 Web 应用。

git clone https://github.com/spring-projects/spring-petclinic.git cd spring-petclinic ./mvnw package java -jar target/*.jar

访问地址：http://localhost:8080/

4、数据库创建库+用户+授权

-- 1. 创建数据库 CREATE DATABASE IF NOT EXISTS petclinic1 DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; -- 2. 创建用户（MySQL 8+） CREATE USER IF NOT EXISTS 'petclinic1'@'%' IDENTIFIED BY 'petclinic1'; -- 3. 授权 GRANT ALL PRIVILEGES ON petclinic1.* TO 'petclinic1'@'%'; -- 4. 刷新权限 FLUSH PRIVILEGES; -- 退出 MySQL exit;

测试用户是否可用

mysql -u petclinic1 -p

密码：petclinic1能登录 = 成功

把打好的 jar 包放到目标目录

# 1. 创建运行用户（安全，不用 root） useradd -r -s /bin/false petclinic # 2. 创建程序目录 mkdir -p /opt/petclinic # 3. 复制 jar 包 cp target/spring-petclinic-3.5.0-SNAPSHOT.jar /opt/petclinic/ # 4. 授权目录权限（必须） chown -R petclinic:petclinic /opt/petclinic

运行Java项目

java -jar spring-petclinic-3.5.0-SNAPSHOT.jar –spring.profiles.active=mysql –spring.datasource.url=‘jdbc:mysql://127.0.0.1:3306/petclinic1?useSSL=false&allowPublicKeyRetrieval=true&serverTimezone=UTC’ –spring.datasource.username=petclinic1 –spring.datasource.password=petclinic1

创建系统服务

vim /etc/systemd/system/petclinic.service

[Unit] Description=Spring PetClinic 3.5.0 After=network.target mysql.service Wants=mysql.service [Service] Type=simple #以哪个系统用户运行，推荐自建非 root 用户（如 petclinic） User=petclinic Group=petclinic #jar 绝对路径 WorkingDirectory=/opt/petclinic ExecStart=/usr/bin/java -jar /opt/petclinic/spring-petclinic-3.5.0-SNAPSHOT.jar \ --spring.profiles.active=mysql \ --spring.datasource.url='jdbc:mysql://127.0.0.1:3306/petclinic1?useSSL=false&allowPublicKeyRetrieval=true&serverTimezone=UTC' \ --spring.datasource.username=petclinic1 \ --spring.datasource.password=petclinic1 #重启策略：异常退出后 10s 自动重启，最多 5 次 Restart=on-failure RestartSec=10 StartLimitInterval=60 StartLimitBurst=5 #日志归集到 journald StandardOutput=journal StandardError=journal [Install] WantedBy=multi-user.target

启动服务

systemctl daemon-reload systemctl enable --now petclinic # 查看状态 systemctl status petclinic # 实时日志 journalctl -u petclinic -f

全网最细！Maven 编译构建 Java Web 项目从入门到实战一文吃透

使用Maven编译并构建java web项目

一、Maven概述

二、Maven的构建生命周期

1、Clean生命周期

2、Default（Build）生命周期

`clean`阶段：

`package`阶段：

3、Site生命周期

三、Maven的安装与配置

1、安装jdk

2、下载Maven

3、解压安装

4、设置环境变量

5、检验是否安装成功

四、使用maven编译一个java项目JPress

1、获取JPress源码

2、源码编译jpress

3、安装mysql数据库

4、部署并运行JPress项目

5、启动脚本核心配置说明

启动方式配置

生产环境推荐配置

五、基于mvnw构建java应用项目

1、mvnw是什么

2、mvnw工作流程

3、基于mvnw的应用项目实践

4、数据库创建库+用户+授权

测试用户是否可用

把打好的 jar 包放到目标目录

运行Java项目

创建系统服务

启动服务

ArcGIS模型构建器实战：一个模型搞定多个GDB批量转SHP（附避坑技巧）

ViVa——基于视频生成模型的机器人RL价值估计：比原先基于VLM的价值函数，能更好的在动态交互环境中对当前进度和未来走势下所带来的回报做估计

PyInstaller打包实战：除了.py文件，你的图片、配置和模型文件怎么塞进exe？

二叉树的遍历问题和相关算法（思路梳理和代码实现）

python commitizen

Chandra在金融风控中的实际应用效果展示

使用Maven编译并构建java web项目

一、Maven概述

二、Maven的构建生命周期

1、Clean生命周期

2、Default（Build）生命周期

clean阶段：

package阶段：

3、Site生命周期

三、Maven的安装与配置

1、安装jdk

2、下载Maven

3、解压安装

4、设置环境变量

5、检验是否安装成功

四、使用maven编译一个java项目JPress

1、获取JPress源码

2、源码编译jpress

3、安装mysql数据库

4、部署并运行JPress项目

5、启动脚本核心配置说明

启动方式配置

生产环境推荐配置

五、基于mvnw构建java应用项目

1、mvnw是什么

2、mvnw工作流程

3、基于mvnw的应用项目实践

4、数据库创建库+用户+授权

测试用户是否可用

把打好的 jar 包放到目标目录

运行Java项目

创建系统服务

启动服务

ArcGIS模型构建器实战：一个模型搞定多个GDB批量转SHP（附避坑技巧）

ViVa——基于视频生成模型的机器人RL价值估计：比原先基于VLM的价值函数，能更好的在动态交互环境中对当前进度和未来走势下所带来的回报做估计

PyInstaller打包实战：除了.py文件，你的图片、配置和模型文件怎么塞进exe？

二叉树的遍历问题和相关算法（思路梳理和代码实现）

python commitizen

Chandra在金融风控中的实际应用效果展示

`clean`阶段：

`package`阶段：