OpenShift运行NodeJS镜像时node_modules缺失的技术求助

我碰到过好几个类似的案例，你的情况特别典型——本地Docker构建、运行都毫无问题，一部署到OpenShift就出现node_modules“消失”的情况，手动在容器里执行npm i又能正常启动服务。咱们一步步拆解根源和解决办法：

核心原因分析 #

问题出在OpenShift的**安全上下文约束（SCC）**机制上：

• 你在Dockerfile里创建了固定UID为1000的node-red用户，并用这个用户执行了npm install，依赖会被安装到该用户有权限的目录下。
• 但OpenShift默认会以随机UID启动容器，这个随机用户不属于任何预定义用户组，导致原本存在的node_modules目录因权限不足无法被读取，看起来就像“消失”了一样。

本地Docker运行正常是因为它默认用root或者你指定的固定UID启动，权限完全覆盖了目录访问需求。

针对性解决方案 #

方案1：调整Dockerfile的依赖目录权限 #

在npm install完成后，确保node_modules目录允许所有用户（包括OpenShift的随机UID）读取和执行：
修改Dockerfile中USER node-red之后的步骤：

USER node-red
RUN npm install && \
    # 给root组添加读写执行权限，OpenShift随机用户默认属于root组
    chmod -R g+rwX /usr/src/node-red/node_modules && \
    chown -R node-red:root /usr/src/node-red/node_modules

方案2：让容器以固定UID运行 #

如果你不想调整目录权限，可以在Deployment YAML中指定容器用你创建的node-red用户（UID 1000）运行：

apiVersion: apps/v1
kind: Deployment
metadata:
  name: node-red-ui
spec:
  selector:
    matchLabels:
      app: node-red-ui
  template:
    metadata:
      labels:
        app: node-red-ui
    spec:
      # 添加安全上下文配置
      securityContext:
        runAsUser: 1000
        runAsGroup: 0
      containers:
      - name: node-red-ui
        # ... 其余配置保持不变

⚠️ 注意：这个方法需要你的OpenShift集群允许使用固定UID，可能需要管理员给你的服务账号添加anyuid SCC权限。

方案3：用root用户完成依赖安装，切换用户前调整权限 #

这是更稳妥的通用方案——先以root身份安装依赖，调整好目录权限后再切换到普通用户：
修改Dockerfile的步骤顺序：

# 先不切换用户，用root执行npm install
RUN npm install && \
    chown -R node-red:root /usr/src/node-red && \
    chmod -R g+rwX /usr/src/node-red
# 最后切换到普通用户
USER node-red

这样安装后的所有文件（包括node_modules）都对root组开放权限，OpenShift的随机用户默认属于root组，就能正常访问了。

验证步骤 #

修改后重新构建镜像并推送到仓库，更新OpenShift的Deployment。如果仍有问题，继续用sleep infinity进入容器，执行以下命令排查：

# 查看node_modules目录权限
ls -ld /usr/src/node-red/node_modules
# 查看当前运行的用户UID和组信息
id

通过输出就能确认是不是权限问题导致的目录无法访问。

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