Node:21-Alpine镜像中Optional Catch Binding语法错误求助

问题分析 #

错误出现在busboy/lib/utils.js的} catch {}语句，虽然Node.js 10+就支持可选catch绑定（空catch），你已经升级到Node 21-alpine，但仍报错，大概率不是Node版本本身的问题，而是以下几种情况：

• 容器内实际运行的Node版本不符合预期：Docker构建或镜像拉取异常，导致容器内Node版本还是旧版
• 依赖缓存导致busboy版本未更新：旧的node_modules缓存被复用，其中busboy版本不支持空catch语法
• 间接依赖引入了旧版busboy：项目依赖（比如express-fileupload）拉取了不兼容的低版本busboy

解决方案 #

1. 验证容器内Node版本 #

进入运行中的容器，检查实际Node版本：

# 替换<container-id>为你的容器ID
docker exec -it <container-id> sh
node -v

如果输出不是v21.x.x，重新拉取官方镜像：

docker pull node:21-alpine

2. 清理缓存重新构建镜像 #

Docker构建缓存可能复用旧的node_modules，构建时禁用缓存：

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

同时修改Dockerfile，添加npm缓存清理步骤：

FROM node:21-alpine
WORKDIR /api
COPY package.json /api
RUN npm cache clean --force && npm install
COPY . /api
CMD ["npm", "start"]
EXPOSE 5010

3. 强制指定兼容的busboy版本 #

在package.json的dependencies中添加最新版busboy，覆盖间接依赖的旧版本：

"dependencies": {
  // 保留原有依赖...
  "busboy": "^1.6.0"
}

执行npm install后重新构建镜像。

4. 检查并更新依赖 #

排查哪个依赖引入了旧版busboy：

npm ls busboy

如果是express-fileupload这类依赖，更新它到最新版：

npm update express-fileupload

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