Node.js中process.env读取K8s容器环境变量与实际值不符问题咨询

排查与解决步骤 #

1. 先确认容器运行时的实际环境变量值

执行以下命令进入容器直接读取变量：

kubectl exec -it <替换为实际Pod名称> -- sh -c 'echo $ENVIRONMENT'

• 如果输出为dev：说明你的Helm配置没有正确传递到Pod的运行时配置
  • 检查Helm Chart的Deployment模板，确认是否正确读取了.Values.env字段注入到容器环境变量，正确模板示例如下：

    spec:
      containers:
        - name: 你的容器名称
          image: 你的镜像地址
          env:
            {{- range $key, $value := .Values.env }}
            - name: {{ $key }}
              value: {{ $value | quote }}
            {{- end }}
    

  • 检查Dockerfile中是否有ENV ENVIRONMENT dev的硬编码配置，或者启动命令、init容器中是否覆盖了该变量
• 如果输出为stage：说明问题出在代码侧
  1. 排查代码是否有兜底逻辑：检查是否写了类似const env = process.env.ENVIRONMENT || 'dev'的默认值配置
  2. 排查构建阶段静态替换问题：如果是用Webpack、Vite等工具打包的前端项目，这类工具默认会在镜像构建阶段把process.env相关变量直接替换为当时的静态值，后续运行时注入的环境变量不会生效。如果是这种场景，需要改为运行时注入变量的方案，比如将环境变量写入window对象，或者在服务端渲染阶段读取运行时变量。如果是纯后端Node服务，确认没有使用打包工具将process.env做静态替换即可。

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