Docker Node/TS项目npm生产环境安装仍装开发依赖求助

问题场景 #

构建Docker Node/TS项目时，需要仅安装生产依赖，但即使设置了NODE_ENV=production，并使用npm --production install、npm install --omit-dev等命令，npm仍会尝试安装devDependencies中的prettier。已尝试清除Docker缓存（docker system prune、--no-cache构建、更换基础镜像）、添加--no-optional参数、查看npm install --verbose输出等方法，均未解决问题。当前Dockerfile内容如下：

FROM node:16

ENV NODE_ENV=production

# -- Setup --
RUN mkdir -p /app/
WORKDIR /app/

# -- Install --
RUN npm update
ADD package.json /app/
RUN npm install --omit-dev --verbose

# -- Copy in source --
COPY .env /app/
COPY src /app/src

## -- Start app --
CMD ["node", "./src/my_app.js"]

目前仅能通过手动删除package.json中的devDependencies部分临时解决，但希望保留npm作为依赖管理工具，找到根本解决方案。

排查与解决方向 #

1. 检查依赖树，确认prettier是否被生产依赖间接引用 #

prettier可能被某个production依赖作为peerDependency或optionalDependency引入，导致npm自动安装。在本地项目中运行以下命令查看依赖树：

npm ls prettier

如果发现有生产依赖依赖prettier，需要确认该依赖是否真的需要在生产环境中使用prettier，或者调整依赖版本。

2. 优化Dockerfile的依赖安装步骤 #

• 移除RUN npm update步骤：该命令会更新npm本身，可能干扰后续依赖安装逻辑，且基础镜像中的npm版本通常能满足需求
• 同时复制package.json和package-lock.json（如果存在）：lock文件能确保依赖安装的一致性，避免npm自动解析依赖时出现异常
  调整后的Dockerfile示例：

FROM node:16

ENV NODE_ENV=production

WORKDIR /app

# 仅复制依赖配置文件，利用Docker缓存层优化
COPY package*.json ./
RUN npm install --omit-dev

# 复制项目源码
COPY .env ./
COPY src ./src

CMD ["node", "./src/my_app.js"]

3. 升级npm版本，修复参数兼容性问题 #

Node 16默认的npm版本可能存在--omit-dev参数的bug，尝试升级到对应分支的最新稳定版：

FROM node:16

ENV NODE_ENV=production

WORKDIR /app

COPY package*.json ./
# 升级npm到8.x分支的最新稳定版（适配Node 16）
RUN npm install -g npm@8.x && npm install --omit-dev

COPY .env ./
COPY src ./src

CMD ["node", "./src/my_app.js"]

4. 检查package.json的语法正确性 #

确认package.json中devDependencies的格式无误，比如是否存在逗号遗漏、括号不匹配等语法错误。语法错误可能导致npm解析依赖时出现异常，错误地将devDependencies识别为生产依赖。

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