Mongoose在Mac上无连接响应，同代码PC端正常，求助排查

问题描述 #

我的Mongoose连接代码在Windows PC上运行正常，能打印连接成功日志并启动3001端口服务，但在Mac上执行时仅显示“starting node index.js”，既无连接日志也无法完成数据库连接。代码如下：

mongoose.connect(process.env.NEXT_PUBLIC_MONGO_URI)
    .then(() => {
        console.log("Connected to MongoDB");
        app.listen(3001, () => {
            console.log("Server is Running on port 3001");
        });
    })
    .catch((err) => {
        console.error("Error connecting to MongoDB", err);
    });

排查步骤 #

1. 检查环境变量加载情况 #

Mac环境变量加载逻辑和Windows有差异，先确认连接字符串是否正确读取：

• 在代码顶部添加console.log(process.env.NEXT_PUBLIC_MONGO_URI)，运行后查看输出是否为有效MongoDB连接地址。
• 若使用.env文件，确认dotenv包已正确安装，.env文件在项目根目录且无拼写错误。

2. 验证网络可达性 #

• 终端执行ping <MongoDB主机地址>（比如MongoDB Atlas集群地址），确认网络连通性。
• 用curl -v mongodb://<你的连接字符串>测试，查看是否有连接超时、拒绝的提示。

3. 排查Mac防火墙拦截 #

• 打开「系统设置」→「网络」→「防火墙」，确认Node.js进程被允许出站连接。
• 临时关闭防火墙测试，排除防火墙拦截的可能。

4. 统一Node.js与Mongoose版本 #

• 执行node -v和npm list mongoose，对比Windows上的版本，版本差异可能引发兼容性问题。
• 若版本不一致，安装和Windows相同版本的Mongoose：npm install mongoose@<对应版本号>。

5. 增加详细日志定位卡点 #

修改代码添加调试日志，明确连接过程的问题：

// 开启Mongoose调试模式
mongoose.set('debug', true);

mongoose.connect(process.env.NEXT_PUBLIC_MONGO_URI, {
  useNewUrlParser: true,
  useUnifiedTopology: true
})
.then(() => {
    console.log("Connected to MongoDB");
    app.listen(3001, () => {
        console.log("Server is Running on port 3001");
    });
})
.catch((err) => {
    console.error("Error connecting to MongoDB", err);
    // 打印完整错误栈
    console.error(err.stack);
});

运行后查看是否有更具体的错误信息或调试输出。

6. 检查端口占用 #

Mac上3001端口可能被其他进程占用，执行lsof -i :3001查看占用进程，若存在则用kill -9 <PID>杀死后重新测试。

7. 确认MongoDB服务端IP白名单 #

若使用云MongoDB服务（如MongoDB Atlas），确认Mac的公网IP已加入服务端白名单。Mac公网IP可通过curl ifconfig.me获取。

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