基于Maven+Docker的WebApp打包与部署全过程

 更新时间:2026年02月02日 08:56:46   作者:那年一路北  
这篇文章主要介绍了基于Maven+Docker的WebApp打包与部署的相关资料,文中通过代码讲解了如何找到正确的JAR包、覆盖Docker使用的JAR、构建Docker镜像、解决Docker构建失败的问题以及在服务器上部署,需要的朋友可以参考下

一、背景说明:为什么要这么折腾一套 Maven + Docker 流程?

在实际项目开发中,代码写完 ≠ 可以上线。尤其是 Java Web 项目,往往涉及:

  • 多模块 Maven 工程

  • WebApp 主模块

  • Docker 镜像封装

  • 离线/内网服务器部署

很多同学在这个阶段会遇到几个典型问题:

  1. IDEA 里代码改好了,但 Docker 里跑的还是旧代码

  2. Maven 打包出来的 JAR 不知道该用哪个

  3. Docker build 一直卡在 openjdk 镜像拉取

  4. 服务器上更新一次代码,要手动搞半天

本文将严格按照你当前 powergrid 项目的真实流程,从 IDEA 打包开始,一步一步,完整讲清楚:

如何把最新 Java Web 代码,稳定、可控地打包成 Docker 镜像,并部署到服务器运行

二、项目整体结构说明(先搞清楚你在操作什么)

在开始之前,我们先明确几个关键目录(非常重要,比如我的项目):

com.powergrid
├── powergrid-admin        # Web 主程序(真正运行的模块)
├── powergrid-common       # 公共模块
├── powergrid-framework    # 框架模块
├── ...
 
powergrid-docker
├── webapp
│   ├── Dockerfile
│   ├── powergrid-admin.jar   # Docker 实际使用的 JAR
│   └── ...
├── exported_images
│   └── powergrid-docker-webapp.tar

一句话记忆法

👉 Maven 在 powergrid-admin/target 里产出 JAR
👉 Docker 只认 powergrid-docker/webapp 里的 JAR

中间这一步「搬运 + 覆盖」,就是 90% 人出问题的地方。

三、第一阶段:使用 IDEA + Maven 正确打包项目

3.1 为什么一定要用 Maven Lifecycle?

你的项目是一个 多模块 Maven 工程,如果你只单独对某个模块打包:

  • 很可能依赖没编全

  • 很可能版本不一致

正确做法:从根模块统一打包

3.2 IDEA 中的具体操作步骤(图形化)

第一步:打开 Maven 面板

在 IDEA 右侧,点击 Maven 面板,你会看到类似:

powergrid
├── Lifecycle
│   ├── clean
│   ├── package
│   ├── install

⚠️ 注意:

  • 请选择最顶层的 powergrid(不是 admin)

第二步:执行 clean

  • 双击 Lifecycle → clean

  • 作用:清空历史编译产物

这是一个好习惯,避免旧代码污染新包。

第三步:执行 package

  • clean 完成后

  • 双击 Lifecycle → package

如果你担心测试失败:

👉 点击 Maven 面板上的 ⚡ Skip Tests

第四步:确认打包成功

控制台看到以下内容,说明成功:

[INFO] BUILD SUCCESS
[INFO] Finished at: xxxx

并且所有模块都是 SUCCESS。

四、第二阶段:找到真正要用的 JAR 包

4.1 JAR 在哪里?(重点)

Maven 打包完成后:

  • 真正要运行的 JAR 一定在:

powergrid-admin/target/

你会看到类似:

powergrid-admin.jar

4.2 为什么是 admin 模块?

因为:

  • admin 是 Spring Boot 启动模块

  • 其他模块只是被依赖

Docker 运行的就是它。

五、第三阶段:覆盖 Docker 使用的 JAR(最关键)

5.1 Docker 只认一个名字

查看 webapp/Dockerfile,你会看到类似:

COPY powergrid-admin.jar /app/app.jar

⚠️ 这意味着:

Docker 只会找 powergrid-admin.jar

5.2 正确覆盖步骤(一步都不能错)

1️⃣ 复制新生成的 JAR

powergrid-admin/target/powergrid-admin-3.8.9.jar

2️⃣ 粘贴到 Docker 目录

powergrid-docker/webapp/

3️⃣ 删除旧文件

4️⃣ 重命名为:

powergrid-admin.jar

5.3 常见错误(踩坑警告)

❌ 没改名
❌ 放错目录
❌ 覆盖失败

结果:Docker 跑的还是旧代码。

六、第四阶段:Docker 构建镜像

进入 webapp 目录:

cd D:\com.powergrid\java\powergrid-docker\webapp\ 

执行构建:

docker build -t powergrid-docker-webapp . 

七、Docker 构建失败:openjdk:8-jdk 拉不下来怎么办?

这是你这个环境非常典型的问题

7.1 问题本质

  • 本地没有 openjdk:8-jdk

  • 镜像源 403

  • Dockerfile 又强依赖

7.2 解决思路:移花接木(非常实用)

第一步:加载旧镜像

docker load -i ..\exported_images\powergrid-docker-webapp.tar 

第二步:查看镜像

docker images 

第三步:改名伪装

docker tag powergrid-docker-webapp:latest openjdk:8-jdk 

第四步:重新 build

docker build -t powergrid-docker-webapp . 

Dockerfile 会“以为”自己找到了基础镜像。

八、第五阶段:服务器部署(三板斧)

8.1 传输镜像

把新的 powergrid-docker-webapp.tar 传到服务器。

8.2 加载镜像

docker load -i exported_images/powergrid-docker-webapp.tar 

8.3 重启服务

docker compose up -d 

8.4 查看日志

docker logs -f --tail=100 powergrid-docker-webapp 

九、完整流程总结(必背)

IDEA
 ↓
Maven clean
 ↓
Maven package
 ↓
powergrid-admin/target/*.jar
 ↓(复制 + 重命名)
powergrid-docker/webapp/powergrid-admin.jar
 ↓
docker build
 ↓
docker load
 ↓
docker compose up -d

十、结语

这套流程的核心不是 Docker,也不是 Maven,而是:

你是否清楚每一步“产物在哪里、被谁用、什么时候更新”

只要你理解了这一点:

  • 换服务器

  • 换项目

  • 换镜像源

你都能举一反三。

到此这篇关于基于Maven+Docker的WebApp打包与部署的文章就介绍到这了,更多相关Maven Docker的WebApp打包部署内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • Docker(黑马spring cloud笔记)详解

    Docker(黑马spring cloud笔记)详解

    这篇文章主要介绍了Docker(黑马spring cloud笔记)详解,本文章内容详细,具有很好的参考价值,希望对大家有所帮助,需要的朋友可以参考下<BR>
    2023-01-01
  • Docker数据存储总结

    Docker数据存储总结

    今天小编就为大家分享一篇关于Docker数据存储总结,小编觉得内容挺不错的,现在分享给大家,具有很好的参考价值,需要的朋友一起跟随小编来看看吧
    2019-02-02
  • docker关闭mysql端口映射的使用方式

    docker关闭mysql端口映射的使用方式

    这篇文章主要介绍了docker关闭mysql端口映射的使用方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2025-06-06
  • 如何清理docker产生的垃圾文件

    如何清理docker产生的垃圾文件

    这篇文章主要介绍了如何清理docker产生的垃圾文件,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2018-07-07
  • 国内可用的Docker镜像源测试指南

    国内可用的Docker镜像源测试指南

    在使用 Docker 时,由于网络原因,直接从 Docker Hub 拉取镜像可能会遇到速度缓慢甚至无法访问的情况,因此,使用国内的 Docker 镜像源可以显著提升镜像拉取速度,本文将介绍如何选择和测试国内可用的 Docker 镜像源,需要的朋友可以参考下
    2025-02-02
  • Docker load之后镜像名字为none问题解决方法

    Docker load之后镜像名字为none问题解决方法

    这篇文章主要介绍了Docker load之后镜像名字为none问题解决方法,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2020-12-12
  • 解决docker拉取mysql镜像太慢的情况

    解决docker拉取mysql镜像太慢的情况

    这篇文章主要介绍了解决docker拉取mysql镜像太慢的情况,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2021-03-03
  • windows下Docker部署Flask的详细教程

    windows下Docker部署Flask的详细教程

    这篇文章主要介绍了windows下Docker部署Flask的教程,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2023-01-01
  • 如何使用Docker部署Go Web应用的实现

    如何使用Docker部署Go Web应用的实现

    这篇文章主要介绍了如何使用Docker部署Go Web应用的实现,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2020-11-11
  • 使用Docker方式启动tomcat,访问首页出现404的解决方案

    使用Docker方式启动tomcat,访问首页出现404的解决方案

    这篇文章主要介绍了使用Docker方式启动tomcat,访问首页出现404的解决方案,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2025-03-03

最新评论