如何在Flask-Mongoengine中配置ssl_ca_cert与SSL参数连接MongoDB

Flask-Mongoengine 本质是对MongoEngine及底层PyMongo连接能力的轻量封装，不存在参数不兼容的问题——所有PyMongo原生支持的连接参数，都可以通过框架提供的配置入口直接透传，不需要额外写适配代码。

旧版本（Flask-Mongoengine 0.15.x 及更早）配置方法 #

旧版本的统一连接配置入口为MONGODB_SETTINGS字典，你只需要把PyMongo要求的SSL相关参数直接写入这个字典即可，框架会把所有键值对原样传递给底层PyMongo的客户端构造函数：

from flask import Flask
from flask_mongoengine import MongoEngine

app = Flask(__name__)
app.config["MONGODB_SETTINGS"] = {
    "db": "你的业务数据库名",
    "host": "你的MongoDB服务地址",
    "port": 27017,
    "username": "数据库账号",
    "password": "数据库密码",
    "authentication_source": "admin",
    # SSL相关参数完全复用PyMongo原生定义
    "ssl": True,
    "ssl_ca_cert": "/opt/cert/mongo-ca.pem",  # 替换为你的CA证书绝对路径
}
db = MongoEngine(app)

注意：只要是PyMongo官方文档中列出的连接参数，都可以直接写到这个字典里，不需要单独找Flask-Mongoengine对应的配置说明。

新版本（Flask-Mongoengine 1.0+）配置方法 #

1.0版本之后，框架调整了配置规则：会自动扫描所有以MONGODB_为前缀的app.config配置项，去掉前缀后透传给PyMongo客户端。对应SSL参数的配置方式为：

from flask import Flask
from flask_mongoengine import MongoEngine

app = Flask(__name__)
# 基础连接配置
app.config["MONGODB_DB"] = "你的业务数据库名"
app.config["MONGODB_HOST"] = "你的MongoDB服务地址"
app.config["MONGODB_PORT"] = 27017
app.config["MONGODB_USERNAME"] = "数据库账号"
app.config["MONGODB_PASSWORD"] = "数据库密码"
app.config["MONGODB_AUTHENTICATION_SOURCE"] = "admin"
# 按前缀规则配置SSL参数
app.config["MONGODB_SSL"] = True
app.config["MONGODB_SSL_CA_CERT"] = "/opt/cert/mongo-ca.pem"
db = MongoEngine(app)

常见踩坑提醒 #

• 配置优先级规则：如果你同时写了零散的MONGODB_前缀配置项和MONGODB_SETTINGS字典，后者会完全覆盖前者，很容易出现参数不生效的问题，建议同一种版本下只选一种配置写法。
• 证书路径要求：必须填写Flask应用运行用户拥有读取权限的绝对路径，不要使用相对路径，否则会触发文件找不到的报错。
• URI方式兼容：如果你习惯用MongoDB连接字符串（URI）配置连接，也可以直接把SSL参数拼到URI的查询参数里，比如mongodb://账号:密码@主机:端口/?ssl=true&ssl_ca_cert=/opt/cert/mongo-ca.pem，两种写法的连接效果完全一致。

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