macOS 11.3.1 M1设备MongoDB CLI可连接但Compass、NodeJS连接失败

1. 先排查端口映射&监听配置问题 #

• 你输入的Compass连接字符串端口是21017，而NodeJS报错指向的是默认端口27017，首先确认本地MongoDB实例实际监听的端口：CLI执行mongosh --eval "db.getMongo()"，输出里会显示当前连接的实际地址和端口，确保所有客户端连接字符串的端口和该值一致。
• 检查MongoDB配置文件（M1芯片用Homebrew安装的默认路径为/opt/homebrew/etc/mongod.conf，和Intel架构的/usr/local路径不同，很容易误找旧配置）里的net.bindIp配置：如果只绑定了127.0.0.1（IPv4地址），没有包含::1（IPv6本地回环地址），NodeJS v17+默认优先走IPv6解析本地地址时就会报ECONNREFUSED ::1:27017。可以把bindIp改成127.0.0.1,::1，或者连接时明确写mongodb://127.0.0.1:你的实际端口强制走IPv4。

2. 排查Compass TLS报错问题 #

报错Client network socket disconnected before secure TLS connection was established基本都是客户端尝试用TLS连接但服务端未开启TLS导致的

• 打开Compass连接配置的「高级连接选项」，找到「TLS/SSL」标签，确认没有勾选「使用TLS/SSL连接」，本地默认部署的MongoDB没有开启TLS，误开TLS就会抛出该报错。
• 也可以直接在连接字符串里加参数关闭TLS：mongodb://127.0.0.1:你的实际端口/?tls=false

3. 芯片适配排查 #

• 确认安装的MongoDB版本是6.0+，M1芯片原生支持的最低MongoDB版本是5.0，但早期5.0的arm64版本存在监听地址偶发异常的bug，直接升级到最新稳定版即可，不需要用Rosetta转译运行。
• 如果是用Homebrew安装的，执行brew update && brew upgrade mongodb-community就能升级到适配M1的最新版本，重启服务生效。

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