Docker build 缓存失效每次都重新安装依赖怎么优化 Dockerfile 指令顺序？

Question

仓乃文 · Accepted Answer

Docker 构建缓存是加速镜像构建的核心机制，但 Dockerfile 指令顺序不当会导致缓存频繁失效，每次构建都重新安装依赖。理解缓存命中规则，合理安排指令顺序，可以将构建时间从分钟级降到秒级。

缓存命中规则：
```
1. Docker 按 Dockerfile 顺序逐条执行指令
2. 每条指令生成一个镜像层
3. 构建时检查该层是否变化：
   - FROM：基础镜像变化则全部重建
   - COPY/ADD：文件内容 hash 变化则缓存失效
   - RUN：命令文本变化则缓存失效
4. 一旦某层缓存失效，后续所有层都重新构建
5. docker build --no-cache 可强制忽略所有缓存
```

反模式：
```dockerfile
# 反模式 1：COPY . . 放在 RUN 之前
FROM node:18
WORKDIR /app
COPY . .              # 任何文件变动 → 缓存失效
RUN npm install       # 每次都重新安装！
CMD ["npm", "start"]

# 反模式 2：频繁变动的文件放在前面
FROM python:3.10
WORKDIR /app
COPY . .              # 源码变动 → 缓存失效
RUN pip install -r requirements.txt  # 每次都重装！

# 反模式 3：多个 RUN 指令未合并
FROM ubuntu
RUN apt-get update     # 层 1
RUN apt-get install -y curl  # 层 2
RUN apt-get install -y vim   # 层 3
# 每层都有缓存，但层数过多影响性能
```

最佳实践：
```dockerfile
# Node.js 项目
FROM node:18-alpine
WORKDIR /app

# 1. 先复制依赖定义文件（变动频率低）
COPY package.json package-lock.json ./
# 2. 安装依赖（只有 package.json 变化才重新执行）
RUN npm ci --only=production
# 3. 再复制源码（变动频率高，但不影响上面的缓存）
COPY . .
# 4. 构建
RUN npm run build

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

# Python 项目
FROM python:3.10-slim
WORKDIR /app
COPY requirements.txt ./
RUN pip install --no-cache-dir -r requirements.txt
COPY . .
CMD ["python", "main.py"]

# Go 项目
FROM golang:1.21-alpine AS builder
WORKDIR /app
COPY go.mod go.sum ./
RUN go mod download
COPY . .
RUN CGO_ENABLED=0 go build -o app

FROM alpine:3.18
COPY --from=builder /app/app /app
CMD ["/app"]
```

合并 RUN 指令减少层数：
```dockerfile
# 不推荐：多个 RUN
RUN apt-get update
RUN apt-get install -y curl
RUN apt-get install -y git
RUN rm -rf /var/lib/apt/lists/*

# 推荐：合并为一个 RUN
RUN apt-get update && \
    apt-get install -y --no-install-recommends \
      curl \
      git && \
    rm -rf /var/lib/apt/lists/*
```

补充说明：
- 变动频率低的放前面（基础镜像、依赖安装），变动频率高的放后面（源码复制）
- .dockerignore 和拆分 COPY 配合使用效果最佳
- BuildKit（DOCKER_BUILDKIT=1）支持更高级的缓存管理
- 规则：永远先复制依赖定义文件再安装依赖，最后复制源码
- npm ci 比 npm install 更适合 CI，严格按照 lock 文件安装