环境变量 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: urlbroken 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