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

Python 连接 MongoDB 主要用 pymongo 库,这是官方推荐的驱动,支持同步操作(也兼容异步 via motor)。核心步骤是:安装库 → 创建客户端 → 连接数据库 → 操作集合。
安装 pymongo
在终端或命令行中运行:
pip install pymongo
如需连接带身份验证或 TLS 的集群(比如 mongodb Atlas),还需确保系统已安装 Openssl,并可能需要额外依赖(如 certifi)。
基础连接方式(本地默认端口)
最简连接示例:
立即学习“Python免费学习笔记(深入)”;
from pymongo import MongoClient <h1>连接本地 MongoDB(默认 host=localhost, port=27017)</h1><p>client = MongoClient()</p><h1>或显式指定</h1><h1>client = MongoClient('mongodb://localhost:27017/')</h1><p>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) <h1>或普通 URI(非 srv)</h1><h1>uri = "mongodb://admin:123456@192.168.1.100:27017/admin?authSource=admin"</h1><p>
关键参数说明:
-
authSource:指定存储用户凭证的数据库(通常是admin) -
tls=True或?tls=true:启用 SSL/TLS(Atlas 必须) -
serverSelectionTimeoutMS=5000:设置连接超时(毫秒),避免卡死
简单读写测试
连上后可以快速验证是否正常:
# 插入一条 collection.insert_one({"name": "Alice", "age": 30}) <h1>查询一条</h1><p>doc = collection.find_one({"name": "Alice"}) print(doc) # {'_id': ObjectId(...), 'name': 'Alice', 'age': 30}</p><h1>关闭连接(脚本结束前建议调用)</h1><p>client.close()
注意:_id 字段会由 MongoDB 自动添加,类型是 ObjectId;如需自定义主键,插入时可显式指定字符串或整数。
基本上就这些。不复杂但容易忽略认证参数和超时设置,尤其上线时务必加上 serverSelectionTimeoutMS 和 tls 配置。