小桔问卷项目MongoDB连接问题分析与解决方案

问题背景

在使用小桔问卷项目(xiaoju-survey)的Docker Compose部署方案时，用户遇到了数据库连接异常的问题。具体表现为：前端页面能够正常显示用户注册界面，且能收到"该用户已存在"的反馈，但实际登录功能无法正常工作，后端日志显示MongoDB连接被拒绝的错误。

技术现象分析

从日志信息可以看到，TypeORM模块无法连接到MongoDB数据库，错误信息显示为"connect ECONNREFUSED"。这表明应用服务能够解析到MongoDB容器的IP地址(172.24.0.2)，但连接请求被拒绝。这种情况通常发生在以下几种场景：

1. MongoDB服务未正常启动
2. 认证信息配置不正确
3. 网络连接存在问题
4. 服务依赖关系未正确处理

配置检查

检查用户提供的docker-compose.yaml文件，配置基本符合要求：

• 正确设置了MongoDB的用户名(admin)和密码(admin)
• 使用了专用网络(xiaoju-survey)确保容器间通信
• 配置了正确的依赖关系(depends_on)
• 端口映射和卷挂载配置合理

根本原因

经过项目维护团队排查，发现问题并非出在MongoDB配置本身，而是1.3.0-slim版本的Docker镜像中缺少关键的.env.production环境变量文件。这个文件包含应用运行所需的重要配置参数，特别是用户注册后生成密钥所需的配置项。

由于缺少这些配置，导致以下连锁反应：

1. 前端能够提交注册请求
2. 后端能接收请求并写入部分用户数据到MongoDB
3. 但关键的密钥生成步骤失败
4. 最终导致登录功能无法正常工作

解决方案

项目团队已在main分支修复此问题，并发布了1.3.1版本的镜像。用户可以通过以下步骤解决问题：

1. 修改docker-compose.yaml文件，将镜像版本更新为1.3.1
2. 清理旧容器和卷数据
3. 重新部署服务

经验总结

这个案例提醒我们，在使用容器化部署时需要注意：

1. 环境变量的完整性和正确性
2. 不同服务版本间的兼容性
3. 容器日志分析的重要性
4. 官方镜像更新日志的关注

对于类似的全栈应用，当出现部分功能正常而部分功能异常时，应当优先检查：

1. 前后端通信是否正常
2. 关键环境变量是否配置
3. 数据库连接和权限设置
4. 应用各模块的日志输出

小桔问卷项目的维护团队响应迅速，及时定位并修复了问题，展现了良好的开源项目管理能力。用户在遇到类似问题时，可以参考这个案例的排查思路，快速定位和解决问题。