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

使用Maven编译并构建java web项目一、Maven概述Maven是一个专为Java平台设计的项目管理和构建工具。其核心思想在于“约定优于配置通过提供一套默认的构建和依赖管理规则降低了项目配置的复杂性使开发者能够专注于业务逻辑的实现。Maven不仅支持项目的构建、依赖管理还涵盖了项目文档生成、版本控制集成、部署发布等多个方面为Java项目的全生命周期管理提供了全面的解决方案。二、Maven的构建生命周期Maven定义了三个主要的构建生命周期Clean生命周期、DefaultBuild生命周期和Site生命周期。1、Clean生命周期用于清理项目。它包含pre-clean、clean和post-clean三个阶段。执行mvn clean命令时会删除上一次构建生成的文件确保项目从一个干净的状态开始。2、DefaultBuild生命周期这是Maven最常用的生命周期涵盖了项目构建的主要阶段。从validate到deploy共包括14个阶段。每个阶段都有特定的任务和目标如编译源代码、运行测试、打包项目等。通过执行相应的Maven命令如mvn compile、mvn test、mvn package等可以触发这些阶段的执行。其中命令作用输出产物mvn compile编译源码target/classes 下的 .class 文件mvn test运行单元测试测试报告mvn package打包项目JAR普通项目/ WARWeb 项目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编译成.classjavac只在 JDK 里提供JRE 没有。因此Maven 必须依赖 JDK不仅仅是 JRE需要提前安装好。1、安装jdk可使用两个jdk发行版Oracle JDK和OpenJDKOracle JDKhttps://www.oracle.com/java/OpenJDKhttps://openjdk.org/Oracle JDK 与 OpenJDK 在技术代码层面几乎一样最大分水岭是许可证OpenJDK基于GPLv2 完全免费Oracle JDK 生产环境必须付费功能、性能差异已缩小到 1% 以内选谁主要看“要不要为法律风险买单”。个人、开源、云原生、CI/CD、企业不想付许可费可选 OpenJDK金融、电信等强监管行业且已购买 Oracle 服务合同需要官方背书长期支持与专属补丁可选择选 Oracle JDK。这里安装Oracle JDK以jdk11为例将二进制安装包上传到服务器/data目录中然后执行如下操作[rootserver ]# mkdir /usr/java [rootserver data]# tar -xvf ./java-11-openjdk-11.0.20.0.8-1.portable.jdk.el.x86_64.tar.xz -C /usr/java [rootserver data]# cd /usr/java [rootserver 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最后进行验证[rootserver ]# source /etc/profile [rootserver ]# java -version安装成功如下所示2、下载Maven进入官网下载地址https://maven.apache.org/download.cgi maven提供了二进制和源码安装包推荐使用二进制包选择合适的版本下载即可。3、解压安装[rootserver ]# tar -zxvf apache-maven-x.x.xx-bin.tar.gz -C /usr/local [rootserver ]# cd /usr/local/ [rootserver ]# 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命令查看输入版本信息例如[rootserver maven]# mvn -v安装成功如下图所示四、使用maven编译一个java项目JPress1、获取JPress源码JPress是一个开源的CMS系统JPress源码地址https://gitee.com/JPressProjects/jpress点击图注1的克隆/下载按钮 有俩种获取jpress源码的方式1、直接下载 zip 包 然后再本地解压即可2、复制链接 使用 git 拉取源码推荐git clone https://gitee.com/JPressProjects/jpress.git2、源码编译jpress在编译之前请先配置好当前服务器的 Maven 环境和 JDk 环境。输入编译命令mvn clean package然后回车 等待编译结束。[rootserver ~]# unzip jpress-v5.x.zip [rootserver ~]# cd jpress-v5.x [rootserver jpress-v5.1.2]# mvn clean packagemvn clean package阶段第一次运行执行时间会比较长等待即可。出现如下界面说明编译完成编译完成后在jpress当前目录找到starter/target/子目录会发现有类似starter-5.0.jar和starter-5.0.zip包这就是编译完成后的压缩包。3、安装mysql数据库这里使用二进制安装mysql使用版本为mysql-8.4.3安装过程如下[rootmysql ~]# tar xvf mysql-8.4.3-linux-glibc2.28-x86_64.tar.xz -C /usr/local [rootmysql ~]# cd /usr/local/ [rootmysql local]# mv mysql-8.4.3-linux-glibc2.28-x86_64 mysql [rootmysql local]# mkdir /usr/local/mysql/data [rootmysql local]# mkdir /usr/local/mysql/etc [rootmysql local]# mkdir /usr/local/mysql/logs [rootmysql local]# useradd mysql然后创建一个mysql配置文件继续执行如下操作[rootmysql ~]# 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授权并执行初始化操作[rootmysql ~]# chown -R mysql:mysql /usr/local/mysql [rootmysql ~]# cd /usr/local/mysql [rootmysql mysql]# bin/mysqld --initialize --usermysql --basedir/usr/local/mysql --datadir/usr/local/mysql/data [rootmysql mysql]# rm -rf /etc/my.cnf接着再写一个mysql服务管理脚本/etc/systemd/system/mysqld.service内容如下[Unit] DescriptionMySQL Server Afternetwork.target [Service] Usermysql Groupmysql 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 Restarton-failure [Install] WantedBymulti-user.target然后启动服务[rootmysql ~]# systemctl daemon-reload [rootmysql ~]# systemctl start mysqldMysql启动成功后需要重置root密码临时密码在上面定义的mysql日志文件/usr/local/mysql/logs/mysqld.log中可以查到。cat /usr/local/mysql/logs/mysqld.log | grep password找到临时密码后执行如下sql[rootmysql ~]# /usr/local/mysql/bin/mysql -uroot -p 输入临时密码:上面进入mysql命令行时如果提示如下错误[rootmysql ~]# /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这里需要做一个软链接操作如下[rootmysql mysql]# ln -s /usr/lib64/libtinfo.so.6 /usr/lib64/libtinfo.so.5最后进入sql命令行后执行如下命令修改root密码SQLgt; alter user rootlocalhost identified by abc123456;到这里为止mysql服务部署完成。4、部署并运行JPress项目运行java项目操作如下[rootserver ~]# mkdir -p /data/jpress [rootserver ~]# cp jpress-v5.x/starter/target/starter-5.0.zip /data/jpress [rootserver ~]# cd /data/jpress [rootserver jpress]# unzip starter-5.0.zip默认开启 80 端口可浏览器访问服务器 IP 进入 JPress 安装页面。要停止服务可执行如下命令[rootserver jpress]# ./jpress.sh stop要重启服务可执行如下命令[rootserver jpress]# ./jpress.sh restart5、启动脚本核心配置说明解压后目录中的jpress.sh是 JPress 的核心启动脚本可通过修改脚本自定义 JVM 参数、运行模式和后台启动方式核心配置如下# Java 命令行参数根据需要开启下面的配置改成自己需要的注意等号前后不能有空格 # JAVA_OPTS-Xms256m -Xmx1024m -Dundertow.port80 -Dundertow.host0.0.0.0 JAVA_OPTS-Dundertow.port8080 -Dundertow.host0.0.0.0 -Dundertow.devModefalse第一行注释状态配置 JVM 初始堆内存-Xms、最大堆内存-Xmx、服务端口-Dundertow.port、绑定地址-Dundertow.host0.0.0.0允许所有 IP 访问第二行生效状态生产环境推荐配置关闭开发模式-Dundertow.devModefalse关闭热加载、调试功能提升运行稳定性和安全性启动方式配置当前默认启动为前台运行控制台实时输出日志一旦执行CtrlC或关闭终端服务就会停止。可通过修改脚本中的启动命令切换为后台运行4 种启动方式说明如下# 运行为后台进程并在控制台输出信息 java -Djava.awt.headlesstrue -Xverify:none ${JAVA_OPTS} -cp ${CP} ${MAIN_CLASS} # 运行为后台进程并且不在控制台输出信息 # nohup java -Djava.awt.headlesstrue -Xverify:none ${JAVA_OPTS} -cp ${CP} ${MAIN_CLASS} /dev/null 21 # 运行为后台进程并且将信息输出到 output.log 文件 #nohup java -Djava.awt.headlesstrue -Xverify:none ${JAVA_OPTS} -cp ${CP} ${MAIN_CLASS} output.log #tail -f /dev/null # 运行为非后台进程多用于开发阶段快捷键 ctrl c 可停止服务 # 当以此方式在Docker下启动时由于是后台进程无前台进程Docker容器启动后会马上退出生产环境推荐配置用vim编辑jpress.sh脚本[rootserver jpress]# vim jpress.sh注释掉默认的前台启动行取消第三行日志输出到文件的注释修改为完整生产配置# 运行为后台进程并且将信息输出到 output.log 文件生产推荐 nohup java -Djava.awt.headlesstrue -Xverify:none ${JAVA_OPTS} -cp ${CP} ${MAIN_CLASS} output.log 21 tail -f /dev/null补充添加21将错误日志也写入output.log避免报错日志丢失方便问题排查保存退出后重启服务使配置生效[rootserver jpress]# ./jpress.sh stop [rootserver 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.activemysql –spring.datasource.url‘jdbc:mysql://127.0.0.1:3306/petclinic1?useSSLfalseallowPublicKeyRetrievaltrueserverTimezoneUTC’ –spring.datasource.usernamepetclinic1 –spring.datasource.passwordpetclinic1创建系统服务vim /etc/systemd/system/petclinic.service[Unit] DescriptionSpring PetClinic 3.5.0 Afternetwork.target mysql.service Wantsmysql.service [Service] Typesimple #以哪个系统用户运行推荐自建非 root 用户如 petclinic Userpetclinic Grouppetclinic #jar 绝对路径 WorkingDirectory/opt/petclinic ExecStart/usr/bin/java -jar /opt/petclinic/spring-petclinic-3.5.0-SNAPSHOT.jar \ --spring.profiles.activemysql \ --spring.datasource.urljdbc:mysql://127.0.0.1:3306/petclinic1?useSSLfalseallowPublicKeyRetrievaltrueserverTimezoneUTC \ --spring.datasource.usernamepetclinic1 \ --spring.datasource.passwordpetclinic1 #重启策略异常退出后 10s 自动重启最多 5 次 Restarton-failure RestartSec10 StartLimitInterval60 StartLimitBurst5 #日志归集到 journald StandardOutputjournal StandardErrorjournal [Install] WantedBymulti-user.target启动服务systemctl daemon-reload systemctl enable --now petclinic # 查看状态 systemctl status petclinic # 实时日志 journalctl -u petclinic -f