跳到主要内容

数据库依赖包安装指南

🎯 概述​

本指南帮助您正确安装TradingAgents的数据库依赖包，解决Python 3.10+环境下的兼容性问题。

⚠️ 重要提醒​

  • Python版本要求: Python 3.10 或更高版本
  • 已知问题: pickle5 包在Python 3.10+中会导致兼容性问题
  • 推荐方式: 使用更新后的 requirements_db.txt

🔧 快速检查​

在安装前，运行兼容性检查工具：

python check_db_requirements.py

这个工具会：

  • ✅ 检查Python版本是否符合要求
  • ✅ 检查已安装的包版本
  • ✅ 识别兼容性问题
  • ✅ 提供具体的解决方案

📦 安装步骤​

1. 检查Python版本​

python --version

确保版本 ≥ 3.10.0

2. 创建虚拟环境（推荐）​

# 创建虚拟环境
python -m venv venv

# 激活虚拟环境
# Windows:
venv\Scripts\activate
# Linux/Mac:
source venv/bin/activate

3. 升级pip​

python -m pip install --upgrade pip

4. 安装数据库依赖​

pip install -r requirements_db.txt

🐛 常见问题解决​

问题1: pickle5 兼容性错误​

错误信息:

ImportError: cannot import name 'pickle5' from 'pickle'

解决方案:

# 卸载pickle5包
pip uninstall pickle5

# Python 3.10+已内置pickle协议5支持，无需额外安装

问题2: 版本冲突​

错误信息:

ERROR: pip's dependency resolver does not currently have a backtracking

解决方案:

# 清理现有安装
pip uninstall pymongo motor redis hiredis pandas numpy

# 重新安装
pip install -r requirements_db.txt

问题3: MongoDB连接问题​

错误信息:

pymongo.errors.ServerSelectionTimeoutError

解决方案:

  1. 确保MongoDB服务正在运行
  2. 检查连接字符串配置
  3. 验证网络连接

问题4: Redis连接问题​

错误信息:

redis.exceptions.ConnectionError

解决方案:

  1. 确保Redis服务正在运行
  2. 检查Redis配置
  3. 验证端口和密码设置

📋 依赖包详情​

包名版本要求用途必需性
pymongo4.3.0 - 4.xMongoDB驱动必需
motor3.1.0 - 3.x异步MongoDB可选
redis4.5.0 - 5.xRedis驱动必需
hiredis2.0.0 - 2.xRedis性能优化可选
pandas1.5.0 - 2.x数据处理必需
numpy1.21.0 - 1.x数值计算必需

🔍 验证安装​

运行以下命令验证安装：

# 测试MongoDB连接
python -c "import pymongo; print('MongoDB驱动安装成功')"

# 测试Redis连接
python -c "import redis; print('Redis驱动安装成功')"

# 测试数据处理包
python -c "import pandas, numpy; print('数据处理包安装成功')"

# 测试pickle兼容性
python -c "import pickle; print(f'Pickle协议版本: {pickle.HIGHEST_PROTOCOL}')"

🚀 Docker方式（推荐）​

如果遇到依赖问题，推荐使用Docker：

# 构建Docker镜像
docker-compose build

# 启动服务
docker-compose up -d

Docker方式会自动处理所有依赖关系。

📞 获取帮助​

如果仍然遇到问题：

  1. 运行诊断工具: python check_db_requirements.py
  2. 查看详细日志: 启用详细模式安装 pip install -v -r requirements_db.txt
  3. 提交Issue: 在GitHub仓库提交问题，包含：
    • Python版本
    • 操作系统信息
    • 完整错误信息
    • 诊断工具输出

📝 更新日志​

v0.1.7​

  • ✅ 移除pickle5依赖，解决Python 3.10+兼容性问题
  • ✅ 更新包版本要求，提高稳定性
  • ✅ 添加兼容性检查工具
  • ✅ 完善安装指南和故障排除

历史版本​

  • v0.1.6: 初始数据库支持
  • v0.1.5: 基础依赖包配置