记一次完整的MongoDB环境配置实录

写在前面最近项目中需要用到MongoDB本以为是个简单的安装配置没想到一路踩坑不断从下载MongoDB到最终在MCPModel Context Protocol中正常使用整整折腾了一天。为了不让后来者重蹈覆辙特将此过程完整记录下来希望能帮到同样遇到这些问题的朋友。第一章一切的开端——安装MongoDB1.1 下载与安装去MongoDB官网下载社区版这一步倒是很顺利直接下一步下一步安装完成。默认安装路径为textC:\Program Files\MongoDB\Server\8.0\1.2 第一次打击Navicat版本过低安装完MongoDB兴冲冲打开Navicat准备连接结果报错textUnable to load MongoDB plugin查看Navicat版本发现是好几年前的旧版本不支持新版MongoDB。解决方案卸载旧Navicat下载最新版Navicat 16。至于激活嘛...你懂的。第二章Navicat破解之旅懂的都懂这一步就不详细展开了流程大致是下载Navicat 16安装包下载激活工具注意来源安全性断网安装激活成功一定要按照步骤来做第三章连接MongoDB发现新问题3.1 无需认证就能连接Navicat成功连接MongoDB后发现一个问题居然没有设置用户名和密码直接就能连上这在开发环境还行但项目要求要有安全认证于是开始研究如何给MongoDB设置账号密码。3.2 按照教程执行mongo命令...打开命令行输入mongo结果提示textmongo 不是内部或外部命令也不是可运行的程序或批处理文件。一脸懵逼...第四章MongoDB Shell的发现第一个大坑4.1 为什么没有mongo命令经过一番搜索终于明白MongoDB 6.0及以上版本Shell是独立安装的不再集成在安装包中这个变化坑了不少人。4.2 下载MongoDB Shell下载地址https://www.mongodb.com/try/download/shell选择Windows版本下载安装时我改到了D盘textD:\Program Files\mongosh4.3 配置环境变量新建系统变量MONGOSH_HOME D:\Program Files\mongosh\bin在Path中添加%MONGOSH_HOME%配置完成后打开新命令行输入mongosh终于成功进入MongoDB ShelltextCurrent Mongosh Log ID: xxxxx Connecting to: mongodb://127.0.0.1:27017 ... test第五章设置MongoDB账号密码5.1 创建超级管理员在mongosh中执行以下命令javascriptuse admin db.createUser({ user: root, pwd: 你的密码, roles: [{ role: root, db: admin }] })5.2 验证用户创建成功执行show users查看javascript[ { _id: admin.root, user: root, db: admin, roles: [ { role: root, db: admin } ] } ]5.3 创建项目数据库用户为具体项目创建专用用户javascriptuse myproject db.createUser({ user: projectUser, pwd: projectPassword, roles: [{ role: readWrite, db: myproject }] })第六章配置MongoDB安全认证第二个大坑6.1 发现问题还是可以免密登录用户创建好了但测试发现还是可以不用密码直接连接MongoDB。这是因为MongoDB默认不开启认证需要修改配置文件。6.2 找不到mongod.cfg第三个大坑在安装目录找了半天没找到mongod.cfg。网上说的路径是textC:\Program Files\MongoDB\Server\8.0\bin\mongod.cfg但我的就是没有解决方案通过Windows服务查找按Win R输入services.msc找到MongoDB Server服务右键→属性查看可执行文件的路径看到--config C:\Program Files\MongoDB\Server\8.0\bin\mongod.cfg原来文件是存在的只是被隐藏了或者我没仔细看。按这个路径终于找到了6.3 修改配置文件用管理员身份打开记事本编辑mongod.cfg找到yaml#security:修改为yamlsecurity: authorization: enabled注意缩进security:前面不能有空格authorization:前面要有两个空格。6.4 重启MongoDB服务bashnet stop MongoDB net start MongoDB6.5 测试认证登录bashmongosh admin -u root -p输入密码后成功登录说明认证生效了第七章启动MongoDB服务的两种方法第四个大坑在配置过程中我发现很多人包括我自己对如何正确启动MongoDB服务存在误解。这里详细说明两种方式方法一命令行临时启动仅用于测试bashmongod --dbpath D:\data\db特点与坑点优点简单直接适合快速测试致命缺点关闭命令窗口服务就停止了。我之前就犯过这个错配置好账号、修改完mongod.cfg后发现用Navicat还是连不上。折腾半天才意识到我一直在用命令行窗口临时运行根本没把MongoDB注册成Windows服务修改的配置文件也没生效。方法二注册为Windows服务推荐这才是正确且方便的姿势。以管理员身份运行CMD执行安装服务bashmongod.exe --logpath D:\data\log\mongod.log --logappend --dbpath D:\data\data --directoryperdb --serviceName MongoDB --install操作服务bashnet start MongoDB # 启动服务 net stop MongoDB # 停止服务常见问题解决权限不足执行net start MongoDB时报错“发生系统错误 5。拒绝访问”。解决务必以“管理员身份”打开命令提示符。服务无法启动报错“MongoDB 服务无法启动”。原因可能是上次非正常关闭导致数据文件锁死。解决找到数据目录--dbpath指定的文件夹删除mongod.lock文件然后重启服务。配置文件不生效只有通过Windows服务运行的方式才会读取mongod.cfg配置文件。如果你是用命令行临时启动的修改配置文件是没用的。第八章MCP集成第五个大坑8.1 配置MCP连接最后一步在MCPModel Context Protocol中使用MongoDB。运行MCP工具提示textPlease enter a MongoDB connection string (Default: mongodb://localhost/):8.2 连接字符串拼写错误第六个大坑我输入了textmongodb://root:密码loaclhost:27017/admin结果报错textgetaddrinfo ENOTFOUND loaclhost Failed to connect to MongoDB: MongoServerSelectionError: getaddrinfo ENOTFOUND loaclhost仔细一看把localhost拼成了loaclhosta和c顺序错了。这个错误真的太隐蔽了不仔细看根本发现不了8.3 正确的连接字符串textmongodb://root:密码localhost:27017/admin?authSourceadmin参数说明localhost主机名注意拼写27017MongoDB默认端口admin认证数据库?authSourceadmin指定认证源8.4 成功连接修正拼写后MCP成功连接到MongoDB终于大功告成第九章常用命令速查表命令说明show users查看当前数据库的用户db.changeUserPassword(用户名, 新密码)修改密码db.updateUser(用户名, {pwd: 新密码, roles: [...]})更新用户信息db.dropUser(用户名)删除用户db.auth(用户名, 密码)手动认证net start MongoDB启动MongoDB服务net stop MongoDB停止MongoDB服务mongosh admin -u 用户名 -p用账号登录MongoDB第十章用户角色说明角色说明root超级管理员所有权限readWrite读写指定数据库read只读指定数据库dbAdmin数据库管理创建索引等userAdmin用户管理clusterAdmin集群管理需在admin库第十一章配置文件位置汇总MongoDB服务配置文件C:\Program Files\MongoDB\Server\版本号\bin\mongod.cfgMongoDB Shell安装路径独立安装通常为D:\Program Files\mongosh\bin数据文件默认路径C:\Program Files\MongoDB\Server\版本号\data\日志文件默认路径C:\Program Files\MongoDB\Server\版本号\log\总结踩坑汇总遇到的坑Navicat版本太低→ 下载最新版并破解找不到mongo命令→ MongoDB 6.0需要独立安装mongosh找不到配置文件→ 通过Windows服务查找确切路径认证不生效→ 修改mongod.cfg启用authorization启动方式混淆→ 区分临时启动和服务化运行服务启动权限不足→ 以管理员身份运行CMD连接字符串拼写错误→ localhost别写成loaclhost完整流程text安装MongoDB → 安装Navicat(新版) → 安装mongosh → 创建用户 → 修改配置文件启用认证 → 注册为Windows服务 → 重启服务 → 测试认证登录 → MCP配置连接字符串 → 成功最终心得MongoDB的配置看似简单但细节真的很多。从版本兼容性到认证配置从命令行操作到服务化管理每一步都可能遇到坑。特别是版本变化6.0以后mongosh独立安装这个变化坑了很多人拼写错误localhost写成loaclhost这种错误真的太隐蔽了服务化运行一定要用Windows服务方式运行否则配置文件不生效希望这篇踩坑日记能帮到正在配置MongoDB的你如果对你有帮助欢迎点赞收藏有问题可以在评论区交流