ChatGPT Web Share 项目 MongoDB 连接问题分析与解决

问题背景

在使用 ChatGPT Web Share 项目时，许多开发者遇到了 MongoDB 连接失败的问题，具体表现为前端 Request Error，后端日志显示 pymongo.errors.ServerSelectionTimeoutError 错误。这类问题通常与 MongoDB 容器配置和网络连接有关。

错误现象分析

从日志中可以观察到几个关键错误信息：

1. pymongo.errors.ServerSelectionTimeoutError: mongo:27017: [Errno 111] Connection refused - 表明 MongoDB 服务无法连接
2. server_type: Unknown - 表示 MongoDB 服务状态未知
3. configured timeouts: socketTimeoutMS: 20000.0ms, connectTimeoutMS: 20000.0ms - 显示连接超时设置

常见原因排查

1. MongoDB 容器状态异常

检查发现 MongoDB 容器处于持续重启状态（Restarting），这表明容器启动过程中遇到了致命错误。可能原因包括：

• 数据卷权限问题
• 配置文件错误
• 端口冲突
• 镜像版本不兼容

2. 网络连接问题

• 安全策略未开放 27017 端口
• 云服务商访问控制未配置
• 容器间网络通信障碍
• 错误的连接字符串格式

3. 认证配置错误

• MongoDB 用户权限不足
• 密码包含特殊字符未转义
• 认证数据库指定错误

解决方案

方法一：更换 MongoDB 镜像版本

1. 停止并删除现有容器
2. 清理旧数据卷（避免冲突）
3. 修改 docker-compose.yml 文件，将 mongo:6.0 替换为 mongo:6.0-focal
4. 重新启动容器

services:
  mongo:
    image: mongo:6.0-focal
    # 其他配置保持不变

方法二：检查网络配置

1. 确保安全策略开放 27017 端口：

   sudo firewall-cmd --zone=public --add-port=27017/tcp --permanent
   sudo firewall-cmd --reload
   

2. 云服务器需配置访问控制规则，允许 27017 端口入站

3. 验证 MongoDB 服务是否可访问：

   telnet your-server-ip 27017
   

方法三：验证连接字符串

确保连接字符串格式正确：

mongodb://用户名:密码@主机:端口/数据库名?authSource=admin

最佳实践建议

1. 使用专用网络：为 Docker 容器创建专用网络，确保容器间通信
2. 数据持久化：正确配置数据卷，避免容器重启导致数据丢失
3. 日志监控：定期检查容器日志，及时发现潜在问题
4. 版本控制：固定 MongoDB 镜像版本，避免不兼容更新

总结

MongoDB 连接问题在容器化部署中较为常见，通过系统化的排查和正确的配置，大多数问题都可以得到解决。关键是要理解容器间通信机制和 MongoDB 的认证流程。本文提供的解决方案已在多个实际部署场景中得到验证，开发者可根据自身环境选择最适合的解决方法。