MongoDB认证失败排查：K8s环境下Node.js连接问题求助

核心问题明确：日志显示MONGO_USER为undefined，说明应用容器未正确获取该环境变量，这是认证失败的直接诱因，按以下环节逐一排查：

1. Kubernetes Secret 配置校验 #

• 执行命令验证Secret内容：

  kubectl get secret <你的Secret名称> -o yaml
  

• 检查data字段下的mongo-user和mongo-password是否为Base64编码后的有效值（明文admin编码后为YWRtaW4=）
• 若为手动创建Secret，确认创建命令格式正确，示例：

  kubectl create secret generic mongo-secret --from-literal=mongo-user=admin --from-literal=mongo-password=123456
  

2. Deployment 环境变量注入检查 #

• 确认Deployment的containers[].env配置是否正确通过valueFrom.secretKeyRef引用Secret，正确配置示例：

  env:
    - name: MONGO_USER
      valueFrom:
        secretKeyRef:
          name: mongo-secret # 需与你的Secret名称完全一致
          key: mongo-user    # 需与Secret中存储用户名的key完全一致
    - name: MONGO_PASSWORD
      valueFrom:
        secretKeyRef:
          name: mongo-secret
          key: mongo-password
  

• 规避常见错误：
  • Secret名称或key拼写错误（Kubernetes资源名大小写敏感）
  • 误用value字段直接写死值，而非valueFrom引用Secret
  • Secret与Deployment不在同一Namespace下

3. index.js 环境变量读取校验 #

• 确认Node.js代码中是否正确读取环境变量，变量名需与Deployment中定义的name完全匹配，示例正确代码：

  const mongoUser = process.env.MONGO_USER;
  const mongoPassword = process.env.MONGO_PASSWORD;
  const mongoUri = `mongodb://${mongoUser}:${mongoPassword}@mongo-service:27017/your-db?authSource=admin`;
  

• 常见错误：变量名拼写偏差（如写成MONGO_USERNAME而非MONGO_USER）

4. 容器内环境变量验证 #

• 进入运行中的Pod，直接检查环境变量是否存在：

  kubectl exec -it <你的Pod名称> -- env | grep MONGO_
  

• 若输出为空，说明Deployment的环境变量配置有误；若有值但代码读取失败，检查代码中变量名的一致性

5. MongoDB 认证后端校验 #

• 即使环境变量正常，仍需确认MongoDB实例已开启认证且存在对应用户：
  1. 进入MongoDB容器执行：

     mongo -u admin -p 123456 --authenticationDatabase admin
     

  2. 检查用户是否存在：

     db.getUser("admin")
     

  3. 确保连接字符串指定了正确的authSource（通常为admin）

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