Docker COPY . . 导致镜像臃肿和缓存频繁失效怎么优化？

Question

仓乃文 · Accepted Answer

COPY . . 是 Dockerfile 中最常见的反模式。它把整个项目目录（包括 .git、node_modules、__pycache__ 等）全部复制到镜像中，导致两个严重问题：镜像体积暴增，以及任何文件变动都使后续所有层的缓存失效。

问题复现：
```dockerfile
# 反模式 Dockerfile
FROM node:18
WORKDIR /app
COPY . .              # 问题 1：把 .git、node_modules 全部复制进去
RUN npm install       # 问题 2：任何文件变动都导致 npm install 重新执行
RUN npm run build
CMD ["npm", "start"]
```

优化 1——添加 .dockerignore：
```
# .dockerignore
.git
.github
node_modules
npm-debug.log
Dockerfile
docker-compose*.yml
.env
.env.*
*.md
dist
build
coverage
.vscode
.idea
```

优化 2——拆分 COPY 利用缓存：
```dockerfile
# 优化后的 Dockerfile
FROM node:18-alpine
WORKDIR /app

# 先只复制依赖定义文件
COPY package.json package-lock.json ./
RUN npm ci --only=production

# 再复制源码（源码变动不影响上面的缓存层）
COPY . .
RUN npm run build

CMD ["node", "server.js"]
```

缓存命中原理：
```
Docker 构建缓存规则：
1. 每条指令生成一层，检查该层是否变化
2. COPY 指令根据文件内容 hash 判断是否变化
3. 一旦某层缓存失效，后续所有层都重新构建

COPY . . 的问题：
- 任何文件变动（哪怕改个注释）→ hash 变化 → 缓存失效
- 后续的 npm install / pip install 全部重新执行

拆分 COPY 的效果：
- 只改源码 → package.json 不变 → npm install 使用缓存
- 只改依赖 → 源码层重新构建，但 install 层已更新
```

不同语言的最佳实践：
```dockerfile
# Python
COPY requirements.txt ./
RUN pip install --no-cache-dir -r requirements.txt
COPY . .

# Java (Maven)
COPY pom.xml ./
RUN mvn dependency:go-offline
COPY src ./src
RUN mvn package -DskipTests

# Go
COPY go.mod go.sum ./
RUN go mod download
COPY . .
RUN go build -o app
```

补充说明：
- .dockerignore 是第一步，拆分 COPY 是第二步，两者缺一不可
- npm ci 比 npm install 更适合 CI 环境，严格按照 lock 文件安装
- RUN 指令中清理缓存：pip 加 --no-cache-dir，apt 加 rm -rf /var/lib/apt/lists/*
- 规则：变动频率低的放前面（依赖安装），变动频率高的放后面（源码复制）