SmartRead本地部署避坑指南
新手在部署SmartRead时常遇到环境配置问题,以下是系统化解决方案:
预防性检查清单
- 版本一致性验证:
- Node.js必须≥v18
- Python限定3.12版本
- Docker需20.10+
- 密钥配置四要素:
- Mistral_API_KEY有效性
- Groq端点可达性
- MongoDB连接字符串格式
- Cloudinary三要素完整度
故障排除流程
- 按顺序启动服务:
- 先验证MongoDB服务
- 启动Docker后端容器
- 最后运行前端
- 使用
docker logs [containerID]
查看实时错误 - 通过Postman测试
http://localhost:8000/docs
API文档
经验表明,90%的部署问题源于环境变量配置错误。建议首次部署时逐行核对.env文件,并使用printenv
命令验证。
本答案来源于文章《SmartRead:自动标注技术PDF文档并提供相关引用源》