python如何连接mongodb

Python连接MongoDB主要用pymongo库,步骤为安装→创建客户端→连接数据库→操作集合;支持本地默认连接、带认证的远程URI及TLS加密,需注意authSource、tls和超时参数配置。

Python 连接 MongoDB 主要用 pymongo 库,这是官方推荐的驱动,支持同步操作(也兼容异步 via motor)。核心步骤是:安装库 → 创建客户端 → 连接数据库 → 操作集合。

安装 pymongo

在终端或命令行中运行:

  • pip install pymongo

如需连接带身份验证或 TLS 的集群(比如 MongoDB Atlas),还需确保系统已安装 OpenSSL,并可能需要额外依赖(如 certifi)。

基础连接方式(本地默认端口)

最简连接示例:

from pymongo import MongoClient

连接本地 MongoDB(默认 host=localhost, port=27017)

client = MongoClient()

或显式指定

client = MongoClient('mongodb://localhost:27017/')

db = client['mydatabase'] # 选择数据库(不存在会自动创建) collection = db['users'] # 选择集合(类似表)

注意:MongoDB 不会在连接时校验数据库是否存在,只有执行写入或查询时才真正触发。

带认证和远程地址的连接

连接云服务(如 Atlas)或启用了用户名密码的本地实例:

# 格式:mongodb://[username:password@]host1[:port1][,...hostN[:portN]][/[defaultauthdb][?options]]
uri = "mongodb+srv://user:pass@cluster.mongodb.net/?retryWrites=true&w=majority"
client = MongoClient(uri)

或普通 URI(非 srv)

uri = "mongodb://admin:123456@192.168.1.100:27017/admin?authSource=admin"

关键参数说明:

  • authSource:指定存储用户凭证的数据库(通常是 admin
  • tls=True?tls=true:启用 SSL/TLS(Atlas 必须)
  • serverSelectionTimeoutMS=5000:设置连接超时(毫秒),避免卡死

简单读写测试

连上后可以快速验证是否正常:

# 插入一条
collection.insert_one({"name": "Alice", "age": 30})

查询一条

doc = collection.find_one({"name": "Alice"}) print(doc) # {'_id': ObjectId(...), 'name': 'Alice', 'age': 30}

关闭连接(脚本结束前建议调用)

client.close()

注意:_id 字段会由 MongoDB 自动添加,类型是 ObjectId;如需自定义主键,插入时可显式指定字符串或整数。

基本上就这些。不复杂但容易忽略认证参数和超时设置,尤其上线时务必加上 serverSelectionTimeoutMStls 配置。