前言

在微服務架構中，Docker 已成為部署和調試服務的標準工具。它將應用及其依賴打包成輕量級容器，確保環境一致性，極大簡化了從開發到生產的流程。本教程將從零開始，手把手教你如何使用 Docker 部署一個典型的微服務項目，并介紹關鍵的調試技巧。

第一部分：項目準備與Docker化

1.1 示例項目結構

假設我們有一個簡單的用戶服務（User-Service），其目錄結構如下：
`
user-service/
├── src/ # 源代碼
├── pom.xml # Maven配置文件（Java示例）
├── application.yml # 配置文件
└── Dockerfile # Docker構建文件
`

1.2 編寫Dockerfile

Dockerfile 是構建鏡像的藍圖。以下是一個針對Spring Boot Java項目的通用示例：
`Dockerfile
# 使用官方Java運行時作為父鏡像

FROM openjdk:11-jre-slim

設置工作目錄

WORKDIR /app

將構建好的jar包復制到容器中

請將 target/user-service-0.0.1-SNAPSHOT.jar 替換為你的實際jar包路徑

COPY target/user-service-*.jar app.jar

暴露服務端口（假設你的服務運行在8080端口）

EXPOSE 8080

啟動應用

ENTRYPOINT ["java", "-jar", "app.jar"]
`

1.3 構建Docker鏡像

在項目根目錄（Dockerfile所在目錄）執行：
`bash
# 構建鏡像，-t 參數指定鏡像名稱和標簽

docker build -t user-service:1.0 .

查看鏡像是否構建成功

docker images | grep user-service
`

第二部分：部署與運行

2.1 運行單個服務容器

`bash # 運行容器，映射主機端口8080到容器端口8080，并設置容器名稱

docker run -d -p 8080:8080 --name user-service-container user-service:1.0

查看容器運行狀態

docker ps

查看容器日志（調試必備）

docker logs -f user-service-container
`

2.2 使用Docker Compose編排多個服務

對于多服務項目，推薦使用 docker-compose.yml 進行編排。示例：
`yaml
version: '3.8'
services:
user-service:
build: ./user-service # Dockerfile所在路徑
ports:

- "8080:8080"
networks:

- microservice-net
# 環境變量配置示例

environment:

SPRINGPROFILESACTIVE=docker

DB_HOST=mysql-db

mysql-db:
image: mysql:8.0
environment:
MYSQLROOTPASSWORD: rootpass
MYSQL_DATABASE: userdb
networks:

- microservice-net
ports:

"3306:3306"

定義網絡，使服務間可通過服務名通信

networks:
microservice-net:
driver: bridge
`
運行編排服務：
`bash
# 在docker-compose.yml所在目錄執行

docker-compose up -d

查看所有服務狀態

docker-compose ps

停止并移除所有服務

docker-compose down
`

第三部分：調試技巧大全

3.1 日志查看與分析

`bash # 實時跟蹤日志輸出（最常用）

docker logs -f nameor_id>

查看最近100行日志

docker logs --tail 100

查看特定時間后的日志

docker logs --since 2024-01-01T10:00:00

結合grep過濾關鍵信息（如錯誤）

docker logs | grep -i error
`

3.2 進入容器內部進行調試

`bash # 進入運行中的容器（啟動一個交互式shell）

docker exec -it /bin/bash # 或 /bin/sh

進入容器后，你可以：

1. 查看進程：ps aux

2. 檢查網絡：netstat -tulpn 或 ss -tulpn

3. 查看環境變量：env

4. 手動運行命令進行測試

3.3 服務健康檢查與監控

`bash # 檢查容器資源使用情況（類似top命令）

docker stats

檢查容器內進程

docker top

查看容器詳細信息（包括IP、網絡配置等）

docker inspect
`

3.4 遠程調試Java微服務

在Dockerfile中啟用遠程調試端口：
`Dockerfile
FROM openjdk:11-jre-slim
WORKDIR /app
COPY target/user-service-*.jar app.jar
EXPOSE 8080 5005 # 暴露應用端口和遠程調試端口

添加Java遠程調試參數

ENTRYPOINT ["java", "-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*:5005", "-jar", "app.jar"]
`
運行容器時映射調試端口：
`bash
docker run -d -p 8080:8080 -p 5005:5005 --name user-service-debug user-service:1.0
`
然后在IDE（如IntelliJ IDEA）中配置遠程調試，連接到 localhost:5005 即可進行斷點調試。

3.5 網絡調試

`bash # 測試服務間網絡連通性（需進入容器）

docker exec name> ping service_name>

或從主機測試容器端口

telnet localhost 8080

查看容器網絡配置

docker network inspect
`

第四部分：常見問題與解決方案

容器啟動后立即退出

檢查：docker logs <container_name> 查看啟動日志。

常見原因：應用啟動失敗、健康檢查不通過、ENTRYPOINT命令錯誤。

服務無法連接數據庫或其他服務

確保所有服務在同一Docker網絡中。

使用服務名（而非localhost）作為主機地址進行連接。

檢查防火墻和端口映射。

鏡像構建緩慢

合理使用 .dockerignore 文件，排除不必要的文件。

利用Docker構建緩存，將不常變動的層（如依賴安裝）放在前面。

調試時看不到最新代碼效果

確保在修改代碼后重新構建鏡像：docker build -t user-service:1.1 .

刪除舊容器：docker rm -f user-service-container

重新運行新鏡像。

通過本教程，你已掌握了使用Docker部署微服務項目的基本流程和核心調試方法。關鍵點在于：

標準化：通過Dockerfile確保環境一致。
編排：使用Docker Compose管理多服務依賴。
觀察：熟練使用日志、容器內檢查和資源監控。
交互：通過進入容器和遠程調試深入問題。

實踐是掌握這些技能的最佳途徑。從一個簡單的服務開始，逐步構建你的微服務集群，遇到問題時利用本文介紹的調試工具層層深入，你將成為Docker微服務部署與調試的專家。

保姆級教程 使用Docker部署并調試微服務項目

前言