前言

在微服务架构中，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
`

第四部分：常见问题与解决方案

1. 容器启动后立即退出

• 检查：docker logs <container_name> 查看启动日志。

• 常见原因：应用启动失败、健康检查不通过、ENTRYPOINT命令错误。

1. 服务无法连接数据库或其他服务

• 确保所有服务在同一Docker网络中。

• 使用服务名（而非localhost）作为主机地址进行连接。

• 检查防火墙和端口映射。

1. 镜像构建缓慢

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

• 利用Docker构建缓存，将不常变动的层（如依赖安装）放在前面。

1. 调试时看不到最新代码效果

• 确保在修改代码后重新构建镜像：docker build -t user-service:1.1 .

• 删除旧容器：docker rm -f user-service-container

• 重新运行新镜像。

##

通过本教程，你已掌握了使用Docker部署微服务项目的基本流程和核心调试方法。关键点在于：

1. 标准化：通过Dockerfile确保环境一致。
2. 编排：使用Docker Compose管理多服务依赖。
3. 观察：熟练使用日志、容器内检查和资源监控。
4. 交互：通过进入容器和远程调试深入问题。

实践是掌握这些技能的最佳途径。从一个简单的服务开始，逐步构建你的微服务集群，遇到问题时利用本文介绍的调试工具层层深入，你将成为Docker微服务部署与调试的专家。