Nuxt3部署K8s后无法读取ConfigMap环境变量求助

问题根源 #

核心问题是Nuxt3运行时配置规则与环境变量命名不匹配，导致K8s注入的运行时环境变量无法被应用正确识别，只能使用构建阶段固化的默认值。

具体解决步骤 #

1. 统一环境变量命名（遵循Nuxt3标准） #

Nuxt3要求暴露给客户端的公共运行时变量必须以NUXT_PUBLIC_为前缀，你当前使用的NUXT_ENV_COMMUNITY_ID是Nuxt2的旧写法，仅会在构建阶段被读取，运行时无法动态更新。

修改ConfigMap中的变量名：

apiVersion: v1
kind: ConfigMap
metadata:
  name: <app name>-config
  namespace: default
data:
  NUXT_PUBLIC_BASE_URL: "<url>"
  NUXT_PUBLIC_COMMUNITY_ID: "2"

2. 修正nuxt.config.ts配置 #

同步调整配置文件中的变量读取逻辑，匹配Nuxt3的前缀规则：

runtimeConfig: {
  public: {
    baseUrl: process.env.NUXT_PUBLIC_BASE_URL || '<url>',
    communityId: process.env.NUXT_PUBLIC_COMMUNITY_ID || '<id>',
  }
},

3. 确保应用以SSR模式运行 #

如果Docker镜像构建时使用了npm run generate（静态站点生成），所有环境变量会被硬编码到静态文件中，运行时无法读取K8s注入的变量。必须改用SSR模式构建和启动：

• 构建命令：npm run build
• 启动命令：npm run start 或 node .output/server/index.mjs

4. 正确在应用中访问变量 #

不要在客户端代码中直接读取process.env，必须通过Nuxt提供的useRuntimeConfig()钩子访问公共变量：

<script setup>
const config = useRuntimeConfig()
console.log(config.public.baseUrl)
console.log(config.public.communityId)
</script>

5. 验证环境变量注入 #

重新部署后，进入Pod再次确认环境变量：

echo $NUXT_PUBLIC_BASE_URL
echo $NUXT_PUBLIC_COMMUNITY_ID

确认变量值正确后，重启Pod观察应用是否能读取到ConfigMap中的值。

额外排查点 #

• 如果问题依旧，检查Deployment的envFrom配置是否正确关联ConfigMap，也可尝试显式注入变量替代envFrom：

containers:
  - name: <container name>
    image: <my-image>
    ports:
      - containerPort: 3000
    env:
      - name: NUXT_PUBLIC_BASE_URL
        valueFrom:
          configMapKeyRef:
            name: <app name>-config
            key: NUXT_PUBLIC_BASE_URL
      - name: NUXT_PUBLIC_COMMUNITY_ID
        valueFrom:
          configMapKeyRef:
            name: <app name>-config
            key: NUXT_PUBLIC_COMMUNITY_ID

• 检查Dockerfile是否在构建阶段注入了环境变量，若有则会覆盖运行时变量，需移除相关配置。

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