数据库迁移失败,初始化失败
在执行 deploy/quick-start.sh 快速启动脚本进行项目初始化部署时,数据库迁移阶段(Alembic migration)失败,系统抛出 ModuleNotFoundError 异常,导致数据库初始化流程中断,项目无法完成部署启动。
错误核心信息为:
ModuleNotFoundError: No module named 'app.utils.backend_utils'
To Reproduce
Steps to reproduce the behavior:
- 克隆项目仓库
git clone https://github.com/jd-opensource/JoySafeter.git
- 进入部署目录
- 执行快速启动脚本
- 等待 Docker 构建和数据库启动完成
- 在数据库迁移阶段(alembic upgrade)出现错误并终止初始化流程
Expected behavior
期望行为:
- 数据库
joysafeter 成功创建
- Alembic 数据库迁移正常执行完成
- 后端、前端、数据库容器全部正常启动
quick-start.sh 脚本完整执行结束,无报错
Screenshots
Environment
- OS: Linux VM-0-3-ubuntu 5.15.0-164-generic #174-Ubuntu SMP Fri Nov 14 20:25:16 UTC 2025 x86_64 GNU/Linux
- Browser: 无(服务器环境)
- Python version: 3.12-slim(容器内环境)
- Node.js version: 未涉及
- Project version: JoySafeter(当前 main 分支代码)
Logs
❌ 数据库迁移失败
Traceback (most recent call last):
File "/usr/local/bin/alembic", line 8, in <module>
sys.exit(main())
...
File "/app/app/utils/__init__.py", line 7, in <module>
from app.utils.backend_utils import (
ModuleNotFoundError: No module named 'app.utils.backend_utils'
❌ 数据库迁移失败,初始化失败
❌ 数据库初始化失败
数据库迁移失败,初始化失败
在执行
deploy/quick-start.sh快速启动脚本进行项目初始化部署时,数据库迁移阶段(Alembic migration)失败,系统抛出ModuleNotFoundError异常,导致数据库初始化流程中断,项目无法完成部署启动。错误核心信息为:
To Reproduce
Steps to reproduce the behavior:
cd JoySafeter/deployExpected behavior
期望行为:
joysafeter成功创建quick-start.sh脚本完整执行结束,无报错Screenshots
Environment
Logs