使用Docker+Node.js+Babel时转译过程被缓存，如何避免该问题？

我来帮你梳理几种实用的解决办法，分别针对Docker构建层缓存和Babel自身缓存两种场景：

一、打破Docker构建层的缓存 #

Docker会对每一条指令生成的镜像层做缓存，只要指令和上下文内容没变化，就会复用之前的层。如果npm run build总是被跳过，试试这些操作：

• 强制无缓存构建：
  每次构建镜像时直接添加--no-cache参数，强制重新执行所有步骤：

  docker build --no-cache -t your-image-name .
  

  这个方法简单直接，但缺点是整个构建过程会变慢，因为所有依赖都要重新安装。

• 调整指令顺序，精准触发重建：
  你的现有Dockerfile顺序其实已经比较合理，但可以再优化下确保源码变更时必触发构建：
  保持COPY . .在RUN npm install之后（你已经这么做了），这样只要源码文件有变化，COPY . .层就会失效，后续的RUN npm run build就会重新执行。另外检查你的.dockerignore文件，别把需要转译的源码文件排除在外，否则Docker会误判源码没变化而复用缓存。

二、禁用或清理Babel自身的转译缓存 #

Babel默认会缓存转译结果来提升速度，但在Docker构建场景下，这个缓存可能导致旧的转译结果被复用。可以这样处理：

• 在构建命令中禁用Babel缓存：
  修改package.json里的build脚本，添加--no-cache参数（如果你的构建工具支持的话）。比如用babel-cli的话：

  {
    "scripts": {
      "build": "babel src --out-dir build --no-cache"
    }
  }
  

  如果是用webpack+babel-loader，就在babel-loader的配置中关闭缓存：

  module.exports = {
    module: {
      rules: [
        {
          test: /\.js$/,
          use: {
            loader: 'babel-loader',
            options: {
              cacheDirectory: false // 禁用缓存
            }
          }
        }
      ]
    }
  }
  

• 构建前清理Babel缓存目录：
  在RUN npm run build之前，添加清理缓存的指令。Babel缓存通常存在node_modules/.cache/babel-loader或者.babel-cache目录，所以可以：

  RUN rm -rf node_modules/.cache/babel-loader .babel-cache
  RUN npm run build
  

  这样每次构建都会先清理旧缓存，确保转译是基于最新源码的。

三、多阶段构建优化（可选） #

如果项目比较复杂，推荐用Docker多阶段构建，把构建环境和运行环境分开，既避免缓存问题，还能减小镜像体积：

# 构建阶段
FROM node:carbon as builder
WORKDIR /usr/api
COPY package*.json ./
RUN npm install
COPY . .
RUN rm -rf build node_modules/.cache/babel-loader # 清理缓存
RUN npm run build

# 运行阶段
FROM node:carbon
WORKDIR /usr/api
COPY package*.json ./
RUN npm install --only=production
RUN npm install -g pm2
COPY ecosystem.config.js ./
COPY --from=builder /usr/api/build ./build
EXPOSE 8000
CMD [ "pm2", "start", "ecosystem.config.js", "--no-daemon" ]

这种方式下，构建阶段的缓存只会影响构建层，运行层只保留生产依赖和构建结果，而且只要源码变化，构建阶段的COPY . .就会触发重新构建。

内容的提问来源于stack exchange，提问作者Ashok Dey