Skip to content

[BUG]数据库迁移失败,初始化失败 #20

@RuoJi6

Description

@RuoJi6

数据库迁移失败,初始化失败

在执行 deploy/quick-start.sh 快速启动脚本进行项目初始化部署时,数据库迁移阶段(Alembic migration)失败,系统抛出 ModuleNotFoundError 异常,导致数据库初始化流程中断,项目无法完成部署启动。

错误核心信息为:

ModuleNotFoundError: No module named 'app.utils.backend_utils'

To Reproduce

Steps to reproduce the behavior:

  1. 克隆项目仓库
    git clone https://github.com/jd-opensource/JoySafeter.git
  2. 进入部署目录
    cd JoySafeter/deploy
  3. 执行快速启动脚本
    ./quick-start.sh
  4. 等待 Docker 构建和数据库启动完成
  5. 在数据库迁移阶段(alembic upgrade)出现错误并终止初始化流程

Expected behavior

期望行为:

  • 数据库 joysafeter 成功创建
  • Alembic 数据库迁移正常执行完成
  • 后端、前端、数据库容器全部正常启动
  • quick-start.sh 脚本完整执行结束,无报错

Screenshots

Image

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'

❌ 数据库迁移失败,初始化失败
❌ 数据库初始化失败

Metadata

Metadata

Assignees

Labels

bugSomething isn't working

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions