Kubernetes Pod通信：部署NodeJS连接MongoDB失败排查

从日志可直接定位故障：后端服务尝试连接127.0.0.1:27017的MongoDB实例被拒绝。Kubernetes中每个Pod拥有独立网络栈，127.0.0.1/localhost仅指向当前后端Pod本身，无法访问同集群内部署的MongoDB服务，这是连接失败的核心原因。

1. 部署MongoDB工作负载与服务 #

首先需要为MongoDB创建Deployment和对应Service，为其提供集群内固定可访问的域名，参考清单如下：

# mongodb.yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: mongodb
  labels:
    app: mongodb
spec:
  replicas: 1
  selector:
    matchLabels:
      app: mongodb
  template:
    metadata:
      labels:
        app: mongodb
    spec:
      containers:
      - name: mongodb
        image: mongo:6.0
        ports:
        - containerPort: 27017
        env:
        # 测试环境可直接配置初始账号，生产环境请替换为Secret存储敏感信息
        - name: MONGO_INITDB_ROOT_USERNAME
          value: "admin"
        - name: MONGO_INITDB_ROOT_PASSWORD
          value: "your_custom_password"
        volumeMounts:
        - name: mongo-storage
          mountPath: /data/db
      volumes:
      - name: mongo-storage
        emptyDir: {} # 仅测试使用，生产环境请替换为持久化存储PVC
---
apiVersion: v1
kind: Service
metadata:
  name: mongodb-svc
spec:
  selector:
    app: mongodb
  ports:
  - port: 27017
    targetPort: 27017
    protocol: TCP
  type: ClusterIP # 仅集群内可访问，符合数据库安全要求

执行命令部署MongoDB资源：

kubectl apply -f mongodb.yaml

2. 调整后端代码的数据库连接逻辑 #

不要将MongoDB地址硬编码为127.0.0.1，改为优先读取环境变量传入的连接地址，参考NodeJS连接代码：

// config/database/mongodb.js
const mongoose = require('mongoose');
// 优先读取环境变量的连接串，本地开发时 fallback 到本地地址
const MONGO_URI = process.env.MONGO_URI || 'mongodb://localhost:27017/local_dev';
const connectDB = async () => {
  try {
    await mongoose.connect(MONGO_URI);
    console.log('MongoDB connection succeeded');
  } catch (err) {
    console.error('MongoDB connection failed!!!', err);
    process.exit(1);
  }
}
module.exports = connectDB;

重新构建后端镜像并推送到你的镜像仓库，替换原有镜像。

3. 配置后端Deployment，注入数据库连接参数 #

修改后端应用的manifest清单，通过环境变量传入正确的MongoDB连接串，参考配置如下：

# backend.yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: backend
  labels:
    app: backend
spec:
  replicas: 1
  selector:
    matchLabels:
      app: backend
  template:
    metadata:
      labels:
        app: backend
    spec:
      containers:
      - name: backend
        image: <替换为你自己的后端镜像地址:标签>
        ports:
        - containerPort: 3000
        env:
        - name: MONGO_URI
          # 同命名空间下直接用Service名称访问，带认证的连接串格式如下
          value: "mongodb://admin:your_custom_password@mongodb-svc:27017/app_db?authSource=admin"
---
apiVersion: v1
kind: Service
metadata:
  name: backend-svc
spec:
  selector:
    app: backend
  ports:
  - port: 3000
    targetPort: 3000
    protocol: TCP
  type: ClusterIP

执行命令部署后端资源：

kubectl apply -f backend.yaml

4. 连通性验证 #

• 执行kubectl get pods确认所有Pod状态为Running
• 执行kubectl logs <后端Pod名称>查看日志，不再出现ECONNREFUSED报错，显示MongoDB连接成功、服务在3000端口启动即为配置完成

• 生产环境禁止将数据库账号、密码等敏感信息明文写在Deployment清单中，请使用Kubernetes Secret资源存储，通过secretKeyRef字段注入环境变量
• 如果MongoDB和后端服务部署在不同命名空间，MongoDB连接地址需要使用全限定域名：mongodb-svc.<命名空间名称>.svc.cluster.local
• 测试环境如果不需要开启MongoDB认证，可以删除MongoDB Deployment中的账号环境变量，连接串简化为mongodb://mongodb-svc:27017/app_db

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