Node.js应用连接Docker中MongoDB时，必须使用docker-compose.yml中定义的服务名（如“mongodb”）作为host，而非localhost或127.0.0.1，因Docker内部网络依赖服务名DNS解析；同时需确保连接字符串格式正确、避免冗余参数（如单节点勿加replicaSet）、并实现启动重试逻辑以应对MongoDB初始化延迟。
Node.js 应用连接 Docker 中的 MongoDB 服务名必须匹配
Node.js 连接失败最常见的原因是 mongoose.connect() 里写的 host 名和 docker-compose.yml 中定义的服务名不一致。Docker 内部网络靠服务名做 DNS 解析，不是 localhost 或 127.0.0.1。
比如你的 docker-compose.yml 里写的是：
services:
mongodb:
image: mongo:7.0
ports: ["27017:27017"]
那 Node.js 代码里必须用 "mongodb://mongodb:27017/yourdb"，而不是 "mongodb://localhost:27017/yourdb" —— 后者在容器内根本连不通。
- 检查
docker-compose.yml中 MongoDB 服务的service name（冒号前那个词），它就是容器间通信的 hostname -
depends_on只控制启动顺序，不保证 MongoDB 已 ready；应用层需加重试逻辑或使用wait-for-it.sh - 如果用了认证，记得加
?authSource=admin，否则MONGO_INITDB_ROOT_USERNAME不生效
Python 应用连接 MongoDB 需显式指定 host 和 port，不能依赖 localhost
Python 的 pymongo.MongoClient() 默认 host 是 localhost，但在容器里它指向自己，不是 MongoDB 容器。必须显式传参，且 host 值要和 compose 里的服务名一致。
立即学习“Python免费学习笔记（深入）”；
错误写法：MongoClient() 或 MongoClient("localhost:27017")
正确写法：MongoClient("mongodb://mongodb:27017/")（假设服务名为 mongodb）
- Flask/FastAPI 等框架中，不要把连接写死在模块顶层；建议封装为 lazy-init 函数，避免启动时就报错
- 若用
docker-compose up启动后 Python 报Connection refused，大概率是 MongoDB 还没完全初始化完，应用已尝试连接 - 推荐加简单重试：捕获
ServerSelectionTimeoutError，sleep 后重试最多 3 次
多个应用共用一个 MongoDB 实例时，数据库名必须隔离
Node.js 和 Python 应用可以共用同一个 MongoDB 容器，但必须用不同 database name，否则数据混杂、权限难控、清库风险高。
例如：
- Node.js 连接字符串：
"mongodb://mongodb:27017/nodeapp" - Python 连接字符串：
"mongodb://mongodb:27017/pythonapp"
这样它们各自操作自己的库，互不影响。MongoDB 本身不强制权限隔离，靠 database name + 用户权限组合实现逻辑隔离。
注意：admin 数据库是系统库，普通应用不应直接往里面写数据；初始化用户时，用 db.createUser({user:"nodeuser", pwd:"xxx", roles:[{role:"readWrite", db:"nodeapp"}]}) 显式限定作用域。
连接字符串中的 replicaSet 参数只在副本集场景下有效
如果你只是单节点 MongoDB（最常见开发场景），?replicaSet=rs 这类参数不仅多余，还会导致连接失败 —— 因为单节点没启用副本集模式。
只有当你明确配置了多节点副本集（primary + secondary），且启动命令含 --replSet rs，才需要加这个参数。
- 单节点：用
"mongodb://mongodb:27017/mydb"即可 - 副本集：用
"mongodb://mongodb1:27017,mongodb2:27017,mongodb3:27017/mydb?replicaSet=rs" - 副本集连接时，所有节点地址必须可互相访问，且
bind_ip不能只设127.0.0.1，得用0.0.0.0或具体网卡 IP
实际部署时，最容易被忽略的是：Node.js 和 Python 应用启动快，MongoDB 初始化慢，而连接字符串里又没配超时或重试 —— 表现就是“偶尔成功、多数失败”，本质是竞态问题，不是配置错。
