3. 导入问题 ⚠️

问题: 新增的模型类在路由文件中未导入，导致 NameError。

解决方案: 确保所有使用的类都已导入。

python

models.py

class Trajectory(Base):
tablename = trajectories
id = Column(Integer, primary_key=True)
# ...

class Annotation(Base):
tablename = annotations
id = Column(Integer, primary_key=True)
trajectory_id = Column(Integer, ForeignKey(trajectories.id))
# ...

python

main.py (FastAPI)

@app.delete(/api/trajectories/{trajectory_id})
def deletetrajectory(trajectoryid: int, db: Session = Depends(get_db)):
# 现在可以正确访问所有模型
annotation = db.query(Annotation).filter(
Annotation.trajectoryid == trajectoryid
).first()
# ...

4. 删除操作的级联处理

问题: 删除主记录时，关联的外键记录如何处理？

方案 A: 数据库级联删除（推荐）
python
class Trajectory(Base):
tablename = trajectories
id = Column(Integer, primary_key=True)
annotations = relationship(Annotation, cascade=all, delete-orphan)

方案 B: 手动删除关联记录
python
@app.delete(/api/trajectories/{trajectory_id})
def deletetrajectory(trajectoryid: int, db: Session = Depends(get_db)):
# 先删除关联的 annotations
db.query(Annotation).filter(
Annotation.trajectoryid == trajectoryid
).delete()
# 再删除主记录
trajectory = db.query(Trajectory).filter(
Trajectory.id == trajectory_id
).first()
if trajectory:
db.delete(trajectory)
db.commit()
return {status: deleted}

完整启动脚本

bash
#!/bin/bash

启动 FastAPI 后端 (后台运行)

启动 Flask 前端

清理

Docker Compose 配置

yaml
version: 3.8
services:
api:
build: .
command: python -m uvicorn api:app --host 0.0.0.0 --port 18000
ports:
- 18000:18000

web:
build: .
command: python frontend.py
ports:
- 15000:15000
depends_on:
- api
environment:
- FASTAPI_URL=http://api:18000

最佳实践总结

1. 1. 路由定义: 始终在 if name == main: 之前定义所有路由
2. API 代理: 前端服务需要代理 API 请求到后端
3. 导入管理: 新增模型类后，确保在所有使用的地方导入
4. 级联删除: 设计好外键关系的级联策略
5. 错误处理: 代理请求时正确传递错误状态码

相关项目

• - Preference Alignment System: wphu@gpu506.aibee.cn:/data/algorithm/user/wphu/OmniMLLM/preference-align