Kubernetes环境下Python应用连接MongoDB StatefulSet认证失败问题

1. 优先修复环境变量未注入问题 #

Pod内执行echo $MONGODB_URI无返回值，说明Secret未被正确注入到Pod运行环境，按以下步骤排查：

• 确认Secret存在于应用部署的同命名空间下：执行kubectl get secret <你的secret名称> -n <目标命名空间>，不存在则优先排查Secret创建逻辑
• 检查应用Deployment/StatefulSet的环境变量配置段，是否正确引用了Secret对应键值，正确配置示例如下：

env:
  - name: MONGODB_URI
    valueFrom:
      secretKeyRef:
        name: <存储Mongo连接串的Secret名称>
        key: <Secret中存储MONGODB_URI的键名>

• 验证Helm模板渲染结果：执行helm template <你的release名称> <本地Chart路径>，检查输出的Deployment配置中环境变量段是否渲染正确，无变量占位符残留
• 调整代码环境变量读取逻辑，避免dotenv读取失败导致空值：

# 优先读取K8s注入的系统环境变量，本地开发场景下再降级读取.env文件
MONGODB_URI = os.getenv('MONGODB_URI')
if not MONGODB_URI:
    load_dotenv(find_dotenv())
    MONGODB_URI = os.getenv('MONGODB_URI')

2. 环境变量注入正常后仍认证失败的排查方案 #

如果确认MONGODB_URI已经正确注入但还是报认证错误，按以下步骤检查：

• 确认连接串格式符合规范：标准格式为mongodb://<账号>:<密码>@<MongoDB服务名>:27017/<业务库名>?authSource=admin，如果启用了副本集需要追加&replicaSet=<副本集名称>参数
• 如果你使用的是Bitnami官方MongoDB Helm Chart作为依赖，默认认证库为admin，root账号密码存储在自动生成的Secret的mongodb-root-password键中，需确认你Secret里存储的连接串账号密码和MongoDB部署时配置的一致
• 注意：如果修改过MongoDB依赖的密码配置，需要先删除MongoDB对应的PVC再重新部署，避免旧密码持久化在存储中导致认证失败

3. 验证步骤 #

• 修复配置后执行helm upgrade <你的release名称> <Chart路径> -n <命名空间>更新部署
• 进入新启动的应用Pod执行echo $MONGODB_URI确认环境变量已正确注入
• 可在Pod内安装mongo shell，执行mongosh "$MONGODB_URI"直接测试连接，确认连接串有效性

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