Docker生产构建中执行yarn install --production仍残留开发依赖的问题及优化需求

我来帮你搞定这个问题——你的生产镜像里还残留开发依赖的核心原因是你直接从dev阶段复制了完整的node_modules目录，而yarn install --production并不会自动删除已存在的开发依赖，只会确保生产依赖安装完整。下面是调整后的完整Dockerfile，我会逐段说明优化逻辑：

# 开发构建阶段：负责安装全量依赖、构建生产产物
FROM node:12 as dev
ARG SVC_NAME
ARG SVC_TYPE
ENV srcpath=/usr/src/app
ENV svcpath=services/${SVC_TYPE}/${SVC_NAME}

WORKDIR ${srcpath}

# 先复制依赖配置文件，利用Docker缓存加速构建
COPY package.json yarn.lock ./
COPY packages/ ./packages/
COPY ${svcpath}/package.json ${svcpath}/

# 安装所有依赖（包括开发依赖，用于构建）
RUN yarn install

# 复制完整源码进行构建
COPY . .
WORKDIR ${srcpath}/${svcpath}
RUN mkdir /tmp/configs
RUN yarn build

# 生产镜像阶段：只保留生产必需的内容
FROM node:12-alpine as prod
ARG SVC_NAME
ARG SVC_TYPE
ENV srcpath=/usr/src/app
ENV svcpath=services/${SVC_TYPE}/${SVC_NAME}

# 安装系统依赖并清理缓存，减小镜像体积
RUN apk add --update openssl openssl-libs-static openssl-dev && rm -rf /var/cache/apk/*

WORKDIR ${srcpath}

# 仅复制依赖配置文件，安装生产依赖
COPY package.json yarn.lock ./
COPY packages/ ./packages/
COPY ${svcpath}/package.json ${svcpath}/

# 使用--production安装生产依赖，--frozen-lockfile确保版本与lock文件完全一致
RUN yarn install --production --frozen-lockfile

# 从dev阶段复制构建好的产物和配置，不需要复制源码
COPY --from=dev ${srcpath}/${svcpath}/dist ${srcpath}/${svcpath}/dist
COPY --from=dev /tmp/configs /tmp/configs

# 切换到产物目录启动服务
WORKDIR ${srcpath}/${svcpath}/dist/src
EXPOSE 3000
CMD ["node", "index.js"]

关键优化点说明 #

• 彻底抛弃dev阶段的node_modules：dev阶段的node_modules包含大量开发依赖（比如构建工具、测试库），直接复制会把这些冗余内容带到生产镜像里。我们在prod阶段重新安装纯生产依赖，从根源避免开发依赖混入。
• Docker缓存优化：先复制package.json、yarn.lock等依赖配置文件，再执行安装命令。这样只有当依赖配置变化时，才会重新安装依赖，大幅提升后续构建速度。
• 严格锁定依赖版本：添加--frozen-lockfile参数，确保生产环境安装的依赖版本与yarn.lock完全一致，避免意外的版本更新导致线上问题。
• 最小化镜像内容：prod阶段只复制构建好的dist产物和必要配置，不复制源码；安装系统依赖后清理apk缓存，进一步减小镜像体积。
• 修正原配置的错误：原Dockerfile中存在重复复制yarn.lock、路径拼写错误（/${srcpath}//yarn.lock）等问题，调整后全部修复。

内容的提问来源于stack exchange，提问作者A K