使用Maven將Java項目打包為Docker鏡像的實戰(zhàn)方法
更新時間：2026年02月09日 09:50:33 作者：Jinkxs
本文介紹了兩種使用Maven將Java項目打包為Docker鏡像的實戰(zhàn)方法： Google Jib插件方案：無需Dockerfile,直接通過Maven插件構建鏡像,優(yōu)勢包括分層構建、安全高效、鏡像體積小,特別適合SpringBoot項目,文章詳細展示了使用Maven構建Java項目并生成Docker鏡像的完整流程
引言
在云原生時代，容器化（Containerization） 已成為現代應用部署的標準范式。Docker 憑借其輕量、可移植、一致性的優(yōu)勢，徹底改變了軟件交付流程。而作為 Java 生態(tài)中最主流的構建工具，Maven 如何與 Docker 無縫集成，高效地將 Spring Boot 或普通 Java 應用打包為 Docker 鏡像，是每一位 Java 開發(fā)者必須掌握的核心技能。
本文將帶你從零開始，深入實戰(zhàn) 使用 Maven 構建 Java 項目并生成 Docker 鏡像的完整流程。我們將覆蓋：
- 傳統(tǒng)手動構建鏡像的痛點
- 使用 Jib 插件 實現“零 Dockerfile”構建
- 使用 Dockerfile + Maven Resources 插件 精細控制鏡像內容
- 多階段構建（Multi-stage Build）優(yōu)化鏡像大小
- 鏡像標簽策略、推送私有倉庫、CI/CD 集成
- 安全最佳實踐與性能調優(yōu)
全文包含大量可運行代碼示例、Mermaid 架構圖、真實外鏈資源（均經驗證可訪問），助你打造生產級 Java 容器化流水線。
為什么需要將 Java 項目容器化？
盡管 Java 應用“一次編寫，到處運行”，但在實際部署中仍面臨諸多挑戰(zhàn)：
- 環(huán)境差異：開發(fā)機（macOS）、測試服務器（Ubuntu）、生產集群（CentOS）的 JDK 版本、系統(tǒng)庫不一致。
- 依賴沖突：應用依賴的本地庫（如 native lib）在不同機器缺失。
- 部署復雜：需手動配置 JVM 參數、日志路徑、啟動腳本。
- 資源隔離差：多個應用共享同一臺服務器，互相影響。
Docker 的價值：
- 環(huán)境一致性：鏡像包含 OS + JDK + App，徹底消除“在我機器上能跑”問題。
- 快速部署：docker run 一鍵啟動，無需安裝 JDK。
- 資源隔離：CPU、內存、網絡獨立分配。
- 彈性伸縮：配合 Kubernetes 輕松實現水平擴展。
傳統(tǒng)方式：手寫 Dockerfile + 手動構建
最直觀的方式是先用 Maven 打包 JAR，再編寫 Dockerfile 構建鏡像。
步驟 1：Maven 打包
mvn clean package -DskipTests
生成 target/myapp-1.0.0.jar
步驟 2：編寫 Dockerfile
# 使用官方 OpenJDK 17 鏡像 FROM openjdk:17-jdk-slim # 設置工作目錄 WORKDIR /app # 復制 JAR 文件到容器 COPY target/myapp-1.0.0.jar app.jar # 暴露端口（假設應用監(jiān)聽 8080） EXPOSE 8080 # 啟動命令 ENTRYPOINT ["java", "-jar", "app.jar"]
步驟 3：構建并運行鏡像
# 構建鏡像 docker build -t myapp:1.0.0 . # 運行容器 docker run -d -p 8080:8080 --name myapp-container myapp:1.0.0
? 優(yōu)點：簡單直觀，適合學習
? 缺點：
- 需維護 Dockerfile
- 構建過程分兩步（Maven + Docker），效率低
- 鏡像體積大（含完整 JDK）
- 無法利用 Maven 生命周期自動化
方案一：使用 Google Jib 插件 —— “零 Dockerfile” 構建
Jib 是 Google 開源的 Maven/Gradle 插件，專為 Java 應用容器化設計。它無需 Dockerfile、無需本地 Docker daemon，直接從 Maven 構建鏡像并推送到倉庫。
核心優(yōu)勢
- 分層構建：將應用拆分為
dependencies、snapshot dependencies、resources、classes多層，僅變更代碼時只需上傳少量層。 - 安全：不依賴本地 Docker，避免權限問題。
- 快速：直接與 Registry 通信，跳過本地鏡像存儲。
- 小體積：默認使用 distroless 基礎鏡像（僅含必要運行時）。
官方 GitHub（持續(xù)活躍）：https://github.com/GoogleContainerTools/jib
實戰(zhàn)：Spring Boot 項目集成 Jib
1. 在pom.xml中添加插件
<build>
<plugins>
<plugin>
<groupId>com.google.cloud.tools</groupId>
<artifactId>jib-maven-plugin</artifactId>
<version>3.4.0</version>
<configuration>
<!-- 目標鏡像名 -->
<to>
<image>myregistry.com/myapp:${project.version}</image>
</to>
<!-- 基礎鏡像（可選） -->
<from>
<image>eclipse-temurin:17-jre-alpine</image>
</from>
<!-- 容器配置 -->
<container>
<ports>
<port>8080</port>
</ports>
<environment>
<SPRING_PROFILES_ACTIVE>prod</SPRING_PROFILES_ACTIVE>
</environment>
<creationTime>USE_CURRENT_TIMESTAMP</creationTime>
</container>
</configuration>
</plugin>
</plugins>
</build>
2. 構建并推送到本地 Docker 守護進程
# 構建鏡像并加載到本地 Docker mvn jib:dockerBuild # 查看鏡像 docker images | grep myapp
3. 推送到遠程倉庫（如 Docker Hub）
# 先登錄 docker login # 推送（需在 <to> 中配置鏡像名，如 yourname/myapp） mvn jib:build
提示：若使用私有倉庫（如 Harbor、Nexus），需配置認證信息（見后文）。
Jib 分層機制 Mermaid 圖示
優(yōu)勢體現：當僅修改業(yè)務代碼時，只有 Classes Layer 變更，推送速度極快！
方案二：Dockerfile + Maven Resources 插件 —— 精細控制
當需要完全掌控鏡像內容（如添加 shell 腳本、配置文件、非 Java 資源），可結合 Maven Resources 插件 與 Dockerfile。
項目結構設計
myapp/
├── src/
├── pom.xml
├── docker/
│ ├── Dockerfile
│ └── entrypoint.sh
└── target/
└── myapp-1.0.0.jar
1. 配置 Maven 將資源復制到 target/docker
在 pom.xml 中添加：
<build>
<plugins>
<!-- 復制 Docker 相關文件到 target/docker -->
<plugin>
<artifactId>maven-resources-plugin</artifactId>
<version>3.3.1</version>
<executions>
<execution>
<id>copy-docker-resources</id>
<phase>prepare-package</phase>
<goals>
<goal>copy-resources</goal>
</goals>
<configuration>
<outputDirectory>${project.build.directory}/docker</outputDirectory>
<resources>
<resource>
<directory>docker</directory>
<filtering>false</filtering>
</resource>
</resources>
</configuration>
</execution>
</executions>
</plugin>
<!-- 打包 JAR -->
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
</plugin>
</plugins>
</build>
2. 編寫增強版 Dockerfile
docker/Dockerfile:
# 構建階段：使用 JDK 編譯（若需在容器內編譯）
# FROM maven:3.8.6-openjdk-17 AS builder
# COPY . /app
# WORKDIR /app
# RUN mvn clean package -DskipTests
# 運行階段：僅使用 JRE
FROM eclipse-temurin:17-jre-alpine
# 安裝必要工具（如 curl、bash）
RUN apk add --no-cache bash curl
# 創(chuàng)建應用用戶（安全最佳實踐）
RUN addgroup -g 1001 -S appuser && \
adduser -u 1001 -S appuser -G appuser
# 設置工作目錄
WORKDIR /app
# 復制 JAR 和啟動腳本
COPY myapp-*.jar app.jar
COPY entrypoint.sh /app/entrypoint.sh
# 賦予執(zhí)行權限
RUN chmod +x /app/entrypoint.sh
# 切換到非 root 用戶
USER appuser
# 暴露端口
EXPOSE 8080
# 啟動腳本（可處理信號、設置 JVM 參數等）
ENTRYPOINT ["/app/entrypoint.sh"]
docker/entrypoint.sh:
#!/bin/bash
set -e
# 設置默認 JVM 參數
JVM_OPTS="${JVM_OPTS:-"-Xms256m -Xmx512m"}"
# 處理優(yōu)雅關閉（接收 SIGTERM）
function shutdown() {
echo "Shutting down gracefully..."
kill -TERM "$PID"
wait "$PID"
exit 0
}
# 啟動 Java 應用
java $JVM_OPTS -jar app.jar &
PID=$!
# 注冊信號處理器
trap shutdown SIGTERM SIGINT
# 等待應用結束
wait $PID
3. 構建鏡像
# 先執(zhí)行 Maven 構建（復制資源 + 打包 JAR） mvn clean package -DskipTests # 再構建 Docker 鏡像 docker build -t myapp:1.0.0 target/docker
適用場景：
- 需要自定義啟動邏輯
- 集成非 Java 組件（如 Python 腳本）
- 嚴格的安全合規(guī)要求（非 root 用戶、最小化 OS）
多階段構建（Multi-stage Build）：極致優(yōu)化鏡像大小
Java 應用鏡像常因包含完整 JDK 而臃腫（>500MB）。多階段構建 可將構建環(huán)境與運行環(huán)境分離，顯著減小體積。
示例：Spring Boot + Multi-stage
# 第一階段：構建 FROM maven:3.8.6-eclipse-temurin-17 AS builder # 復制 pom.xml 和源碼 COPY pom.xml . COPY src ./src # 執(zhí)行 Maven 構建（緩存依賴） RUN mvn clean package -DskipTests # 第二階段：運行 FROM eclipse-temurin:17-jre-alpine # 從 builder 階段復制 JAR COPY --from=builder /target/*.jar app.jar EXPOSE 8080 ENTRYPOINT ["java", "-jar", "app.jar"]
構建效果對比
| 方式 | 鏡像大小 | 是否含 Maven/JDK |
|---|---|---|
| 單階段（openjdk:17） | ~450 MB | 是 |
| 多階段（jre-alpine） | ~180 MB | 否 |
| Jib（distroless） | ~120 MB | 否 |
建議：生產環(huán)境優(yōu)先使用 Jib + distroless 或 多階段 + alpine。
鏡像標簽策略：語義化版本與 Git Commit ID
合理的鏡像標簽（Tag）便于追蹤和回滾。
推薦策略
| 場景 | 標簽示例 | 說明 |
|---|---|---|
| 發(fā)布版本 | v1.2.0 | 與 Git tag 對應 |
| 開發(fā)快照 | dev-abc1234 | dev- + Git commit short SHA |
| 最新穩(wěn)定版 | latest | 謹慎使用，避免意外升級 |
在 Maven 中動態(tài)生成標簽
利用 git-commit-id-plugin 獲取 Git 信息：
<plugin>
<groupId>pl.project13.maven</groupId>
<artifactId>git-commit-id-plugin</artifactId>
<version>8.0.2</version>
<executions>
<execution>
<goals>
<goal>revision</goal>
</goals>
</execution>
</executions>
<configuration>
<verbose>false</verbose>
<dateFormat>yyyy.MM.dd HH:mm:ss</dateFormat>
<generateGitPropertiesFile>true</generateGitPropertiesFile>
<includeOnlyProperties>
<includeOnlyProperty>^git.commit.id.abbrev$</includeOnlyProperty>
</includeOnlyProperties>
</configuration>
</plugin>
然后在 Jib 配置中使用：
<configuration>
<to>
<image>myapp:dev-${git.commit.id.abbrev}</image>
</to>
</configuration>
插件官網：https://github.com/git-commit-id/git-commit-id-maven-plugin
推送鏡像到私有倉庫：Harbor/Nexus 示例
企業(yè)通常使用私有鏡像倉庫保障安全。
1. 配置 Jib 推送至 Harbor
<configuration>
<to>
<image>harbor.example.com/project/myapp:${project.version}</image>
<auth>
<username>admin</username>
<password>Harbor12345</password>
</auth>
</to>
</configuration>
安全提示：密碼不應硬編碼！應使用 Maven Settings 或 CI/CD Secrets。
2. 使用 Maven Settings 管理憑證
~/.m2/settings.xml:
<settings>
<servers>
<server>
<id>harbor-registry</id>
<username>admin</username>
<password>Harbor12345</password>
</server>
</servers>
</settings>
pom.xml 中引用：
<configuration>
<to>
<image>harbor.example.com/project/myapp</image>
<auth>
<username>${settings.servers.harbor-registry.username}</username>
<password>${settings.servers.harbor-registry.password}</password>
</auth>
</to>
</configuration>
3. CI/CD 中使用 Secrets（GitHub Actions 示例）
- name: Build and Push with Jib
run: mvn jib:build
env:
JIB_REGISTRY_USERNAME: ${{ secrets.HARBOR_USER }}
JIB_REGISTRY_PASSWORD: ${{ secrets.HARBOR_TOKEN }}
GitHub Secrets 文檔：https://docs.github.com/en/actions/security-guides/encrypted-secrets
安全最佳實踐：掃描漏洞與最小化攻擊面
容器鏡像可能包含已知漏洞（CVE），需主動防御。
1. 使用 Trivy 掃描鏡像
Trivy 是開源漏洞掃描器。
# 安裝 Trivy（macOS） brew install aquasecurity/trivy/trivy # 掃描本地鏡像 trivy image myapp:1.0.0
輸出示例：
myapp:1.0.0 (alpine 3.17.2) ============================ Total: 2 (UNKNOWN: 0, LOW: 1, MEDIUM: 1, HIGH: 0, CRITICAL: 0)
2. 在 CI 中集成掃描
- name: Scan Docker image
run: |
docker build -t myapp:latest .
trivy image --exit-code 1 --severity HIGH,CRITICAL myapp:latest
Trivy 官網（活躍維護）：https://aquasecurity.github.io/trivy/
3. 其他安全建議
- 使用非 root 用戶運行（見前文 Dockerfile）
- 禁用 Shell：distroless 鏡像默認無 shell，防止入侵后執(zhí)行命令
- 定期更新基礎鏡像：訂閱安全公告，及時 rebuild
性能調優(yōu)：JVM 與容器資源匹配
容器環(huán)境中的 JVM 需正確識別 CPU/內存限制。
問題：JVM 忽略 Docker 內存限制
舊版 JVM（<8u131, <9）無法感知 -m 512m 等 Docker 內存限制，導致 OOM。
解決方案
1. 使用新版 JDK（推薦）
JDK 10+ 默認啟用 Container Awareness，JDK 8u191+ 需手動開啟：
ENTRYPOINT ["java", "-XX:+UseContainerSupport", "-jar", "app.jar"]
2. 顯式設置堆內存
# 通過環(huán)境變量控制 ENV JAVA_OPTS="-Xmx300m -Xms300m" ENTRYPOINT ["sh", "-c", "java $JAVA_OPTS -jar app.jar"]
3. 使用 Jib 自動配置
Jib 默認添加 -XX:+UseContainerSupport，無需額外配置。
Oracle 官方文檔：JDK 8 Updates for Docker
CI/CD 集成：GitHub Actions 完整流水線
下面是一個完整的 GitHub Actions Workflow，實現 代碼提交 → 構建 → 掃描 → 推送。
name: Build and Push Docker Image
on:
push:
branches: [ main ]
tags: [ 'v*' ]
jobs:
build:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Set up JDK 17
uses: actions/setup-java@v4
with:
java-version: '17'
distribution: 'temurin'
- name: Cache Maven packages
uses: actions/cache@v3
with:
path: ~/.m2/repository
key: ${{ runner.os }}-maven-${{ hashFiles('**/pom.xml') }}
- name: Build with Maven
run: mvn -B clean verify
- name: Set up Docker Buildx
uses: docker/setup-buildx-action@v3
- name: Login to Docker Hub
uses: docker/login-action@v3
with:
username: ${{ secrets.DOCKERHUB_USERNAME }}
password: ${{ secrets.DOCKERHUB_TOKEN }}
- name: Extract metadata (tags, labels)
id: meta
uses: docker/metadata-action@v5
with:
images: myname/myapp
tags: |
type=ref,event=branch
type=semver,pattern={{version}}
type=sha
- name: Build and push with Jib
run: mvn jib:build -Djib.to.image=${{ steps.meta.outputs.tags }}
- name: Scan image with Trivy
run: |
docker pull ${{ steps.meta.outputs.tags }}
trivy image --exit-code 1 --severity HIGH,CRITICAL ${{ steps.meta.outputs.tags }}
流程說明：
- 拉取代碼
- 設置 JDK + 緩存 Maven 依賴
- 執(zhí)行單元測試
- 登錄 Docker Hub
- 自動生成語義化標簽
- 使用 Jib 構建并推送
- 安全掃描，高危漏洞阻斷發(fā)布
常見問題排查指南
問題 1：Jib 構建失敗，提示“Cannot connect to the Docker daemon”
原因：使用了 jib:build（需推送遠程倉庫），但未配置 registry 認證。
解決：
- 改用
jib:dockerBuild（僅構建到本地） - 或正確配置
<to><auth>或 Maven Settings
問題 2：容器啟動后立即退出
原因：ENTRYPOINT 命令執(zhí)行完畢，容器生命周期結束。
解決：
- 確保 Java 進程在前臺運行（不要加
&） - 檢查應用是否拋出異常（
docker logs container_name）
問題 3：鏡像太大，超過 500MB
解決：
- 改用
eclipse-temurin:17-jre-alpine或 Jib 的 distroless - 使用多階段構建
- 排查是否誤將
src/或target/全量復制
問題 4：時區(qū)不正確
解決：在 Dockerfile 中設置時區(qū)
ENV TZ=Asia/Shanghai RUN ln -snf /usr/share/zoneinfo/$TZ /etc/localtime && echo $TZ > /etc/timezone
方案對比：Jib vs Dockerfile + Maven ??
| 特性 | Jib | Dockerfile + Maven |
|---|---|---|
| 是否需要 Dockerfile | ? 否 | ? 是 |
| 是否需要本地 Docker | ? 否（jib:build）? 是（ jib:dockerBuild） | ? 是 |
| 鏡像分層優(yōu)化 | ? 自動分層 | ?? 需手動設計 |
| 構建速度 | ? 極快（僅傳變更層） | ?? 較慢（全量構建） |
| 控制粒度 | 中（插件配置） | ? 極高（任意命令） |
| 學習成本 | 低 | 中 |
| 適用場景 | 標準 Java 應用 | 復雜定制需求 |
結論：
- 90% 場景用 Jib：快速、安全、高效
- 10% 場景用 Dockerfile：需深度定制（如集成 sidecar、特殊 init 流程）
結語：擁抱云原生，從容器化開始
將 Java 應用容器化不再是“可選項”，而是現代軟件工程的“必修課”。Maven 與 Docker 的結合，為我們提供了從構建到部署的端到端解決方案。無論是使用 Jib 的便捷性，還是 Dockerfile 的靈活性，核心目標都是：交付一致、安全、高效的容器鏡像。
記住：好的容器化不是終點，而是云原生旅程的起點。下一步，你可以探索：
- 使用 Helm 管理 Kubernetes 部署
- 集成 Prometheus + Grafana 監(jiān)控
- 實現藍綠發(fā)布/金絲雀發(fā)布
以上就是使用Maven將Java項目打包為Docker鏡像的實戰(zhàn)方法的詳細內容，更多關于Maven將Java打包為Docker鏡像的資料請關注腳本之家其它相關文章！
相關文章
這篇文章主要為大家介紹了Async的線程池使用選擇解析，有需要的朋友可以借鑒參考下，希望能夠有所幫助，祝大家多多進步，早日升職加薪2023-06-06
SpringBoot中實時監(jiān)控Redis命令流的實現
在Redis的日常使用和調試中,監(jiān)控命令流有助于我們更好地理解 Redis的工作狀態(tài),Redis提供了MONITOR命令,可以實時輸出Redis中所有客戶端的命令請求,本文將介紹如何使用Jedis實現這一功能,并對比telnet實現MONITOR機制的工作方式,需要的朋友可以參考下2024-11-11
JAVA的三個修飾：static,final,abstract,在JAVA語言里無處不在,但是它們都能修飾什么組件,修飾組件的含義又有什么限制,總是混淆.所以來總結一下,需要的朋友可以參考下2021-06-06
JavaWeb開發(fā)使用Cookie創(chuàng)建-獲取-持久化、自動登錄、購物記錄、作用路徑
這篇文章主要介紹了JavaWeb開發(fā)使用Cookie創(chuàng)建-獲取-持久化、自動登錄、購物記錄、作用路徑的相關知識，非常不錯，對cookie持久化知識感興趣的朋友一起學習吧2016-08-08
Springboot @Value注入boolean設置默認值方式
這篇文章主要介紹了Springboot @Value注入boolean設置默認值方式，具有很好的參考價值，希望對大家有所幫助。如有錯誤或未考慮完全的地方，望不吝賜教2022-03-03
這篇文章主要為大家介紹了Gradle創(chuàng)建Web項目基本的框架結構搭建，有需要的朋友可以借鑒參考下，希望能夠有所幫助，祝大家多多進步，早日升職加薪2022-03-03
這篇文章主要介紹了servlet3文件上傳操作的相關資料,需要的朋友可以參考下2017-11-11
針對CVE-2020-1938漏洞,建議升級Tomcat至安全版本以避免受影響,影響版本包括：Apache Tomcat 9.x小于9.0.31、Apache Tomcat 8.x小于8.5.51、Apache Tomcat 7.x小于7.0.100及Apache Tomcat 6.x,2024-10-10
這篇文章主要介紹了springboot2.x整合shiro權限框架的使用，文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值，需要的朋友們下面隨著小編來一起學習學習吧2020-09-09
這篇文章主要介紹了Java CPU性能分析工具代碼實例,文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值,需要的朋友可以參考下2020-01-01