Skip to content

环境变量 Missing

错误信息

                错误: 必需环境变量 DATABASE_URL 是不 设置
              

快速摘要

必需环境变量是 missing, causing application 到 crash or malfunction on startup.

为什么发生

  • 环境变量是 不设置 in 容器 spec or ConfigMap

  • 变量 name 是 misspelled (情况-sensitive)

  • 错误 ConfigMap or Secret 是 referenced in Pod spec

  • 变量是 设置 in one 环境但 不 in another (dev 对比 prod)

最小示例

✗ 错误代码
spec:
  containers:
    - name: app
      image: myapp
      # Missing DATABASE_URL env var
✓ 修复代码
spec:
  containers:
    - name: app
      image: myapp
      env:
        - name: DATABASE_URL
          valueFrom:
            secretKeyRef:
              name: db-secret
              key: url

broken code 是 missing DATABASE_URL 变量. fix 添加它, pulling 值从 Secret.

如何诊断

  • 检查错误消息 for 特定变量 name

  • Inspect Pod's 环境: kubectl exec <pod> -- 环境 | grep <VAR>

  • 验证 Pod spec, ConfigMap, and Secret 引用

  • 检查如果变量是 定义 in 部署 YAML

如何修复

  • 添加 missing 环境变量到 容器 spec

  • 创建 ConfigMap or Secret 使用必需值 and 引用它

  • 正确变量 name spelling (环境变量是 情况-sensitive)

  • Ensure 变量是 设置 in 所有环境 (dev, staging, prod)

如何预防

  • Document 所有必需环境变量

  • Use ConfigMaps and Secrets 到 manage 环境-特定值

  • 验证那个所有必需变量是 设置 in CI 之前 deploying

相关资源

相关术语

← 返回语言