Docker化Node.js应用部署树莓派3时MongoDB连接报错排查

1. 修复代码中的语法错误 #

你代码里的MongoDB连接URL存在模板字符串语法错误：{process.env.DB_USER}用了普通大括号，而非模板字符串要求的${}，这会导致变量无法正确替换，生成无效的连接地址。同时原代码未处理连接的异常情况，容易导致进程卡住。修正后代码如下：

console.log("Hello from the docker3")

//Database
const mongoose = require("mongoose");

mongoose.connect(
  `mongodb+srv://${process.env.DB_USER}:${process.env.DB_PASSWORD}@${process.env.DB_ADDRESS}/`
)
.then(() => {
  console.log("MongoDB连接成功");
  console.log("Hello from the docker4")
})
.catch(err => {
  console.error("MongoDB连接失败:", err);
  process.exit(1); // 连接失败时主动退出进程，避免无响应
});

2. 验证Portainer中的环境变量配置 #

在Portainer部署容器时，必须确保以下环境变量已正确配置：

• DB_USER: MongoDB Atlas的用户名
• DB_PASSWORD: MongoDB Atlas的密码
• DB_ADDRESS: MongoDB Atlas的集群地址（例如cluster0.example.mongodb.net）
  检查变量名拼写是否正确，值是否与PC端Docker Desktop中使用的完全一致。

3. 检查MongoDB Atlas的IP白名单 #

树莓派的公网IP需要加入MongoDB Atlas的IP白名单：

1. 登录MongoDB Atlas控制台，进入目标集群
2. 切换到"Network Access"选项卡
3. 添加树莓派当前的公网IP（可在树莓派终端执行curl ifconfig.me获取）
   PC端能正常连接是因为你的PC IP已在白名单中，而树莓派的IP未被授权，会直接导致连接被拒绝。

4. 确认Docker镜像的ARM架构兼容性 #

树莓派3为ARMv7架构，需确保使用的Node.js基础镜像支持该架构：

• 推荐使用官方Node.js镜像的ARM兼容版本，比如node:18-bullseye-slim或node:20-bullseye-slim，这类镜像会自动适配ARM架构
• 避免使用仅支持x86架构的镜像，否则即使能部署，运行时也会出现依赖兼容问题

5. 查看容器日志定位具体错误 #

在Portainer中查看容器日志，可获取连接失败的详细原因：

1. 进入Portainer的容器列表
2. 找到目标Node.js容器，点击"Logs"按钮
3. 根据日志中的错误信息（如认证失败、连接超时、IP被拦截等）进一步定位问题

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