Windows系统下MongoSQLd无法启动 配置绑定IP后服务报错如何解决

第一步：定位启动失败原因 #

服务返回错误码1属于通用启动失败提示，优先查看服务日志定位具体问题：
Windows版本MongoDB Connector for BI默认日志路径为 C:\Program Files\MongoDB\Connector for BI\2.14\log\mongosql.log，查看日志中最后几行的报错信息，90%以上的启动失败和配置文件解析错误、端口占用、权限不足相关。

第二步：修正配置&服务注册逻辑 #

你当前的配置存在2个常见问题：

1. YAML格式对缩进要求严格，net 下的配置项必须缩进2个空格，否则会解析失败
2. bindIp 不支持掩码格式的写法（192.168.**是无效值），必须填写完整的IP地址，多个地址用逗号分隔，需要绑定所有网卡时可以写0.0.0.0

正确的配置文件示例如下：

net:
  bindIp: "127.0.0.1,192.168.1.100" # 替换为你服务器实际的网卡IP
  port: 27018 # 替换为你需要使用的端口

另外需要确认服务注册时是否绑定了你的自定义配置文件，若未绑定服务会读取默认配置，不会生效你修改的内容：

1. 先卸载已注册的异常服务：mongosqld remove
2. 重新注册服务并指定配置文件全路径：mongosqld install --config "C:\你的配置文件存储路径\mongosqld.conf"（路径不要包含中文和特殊字符）

第三步：验证服务启动 #

重新执行启动命令：net start mongosql，启动成功后可以本地执行命令验证连通性：mongo --host 127.0.0.1 --port 你配置的端口，能正常进入交互界面即为启动成功。

注意事项：

1. 服务器防火墙需开放你配置的mongosqld端口的入站规则，否则外部设备无法访问
2. 如果MongoDB本身开启了权限认证，需要在mongosqld配置中补充mongodb.auth相关的认证配置，否则会连接MongoDB失败
3. YAML配置文件禁止用Tab缩进，必须使用空格缩进，否则会直接解析失败导致启动报错

根据你使用的应用位数选择对应的ODBC数据源管理器：32位应用打开C:\Windows\SysWOW64\odbcad32.exe，64位应用打开C:\Windows\System32\odbcad32.exe，后续步骤如下：

• 选择「用户DSN」或「系统DSN」页签，点击「添加」按钮
• 在驱动列表中选中MongoDB ODBC Driver，点击「完成」
• 填写连接参数：
  • 服务器地址：填写你配置的mongosqld服务所在的服务器IP
  • 端口：填写你配置的mongosqld端口
  • 默认数据库：填写需要连接的MongoDB数据库名称（非必填）
  • 认证信息：如果MongoDB开启了认证，对应填写用户名、密码、认证数据库等参数
• 点击「测试连接」，提示连接成功后点击「确定」保存即可完成DSN创建。

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