从 0 到 1 开发 AI 全栈项目FastAPI Vue3 MySQL 架构设计与排雷实录 前言耗时半个月我从零手敲了一个基于FastAPI Vue3 LangGraph的「智能实验室预约系统」。这个项目不仅包含传统的 RBAC 权限、复杂的预约冲突检测还接入了 RAG 知识库和流式 AI Agent。为了防踩坑和复盘我将用一周时间连载这个项目的完整开发历程。这是第一篇我们先从全局架构和底层数据库设计聊起。️ 一、 全局架构设计整个系统采用标准的前后端分离架构同时接入了 AI 服务层。架构图如下前端 (Frontend)Vue3 Vite Element Plus Axios负责页面渲染和 SSE 流式数据接收。后端 API (Backend)FastAPI处理核心业务逻辑用户鉴权、CRUD、防并发预约。AI Agent 层LangChain LangGraph负责意图识别、工具调用Tool Calling。数据层MySQL存储用户、实验室、设备、预约记录 ChromaDB存储 RAG 向量知识库。️ 为什么这么选FastAPI极其轻量自带 Swagger 接口文档支持异步async/await对于后续做 SSE 流式输出简直是降维打击。Vue3 Vite开发体验极佳热更新快。LangGraph相比于普通的 ChainLangGraph 能通过状态图StateGraph精准控制 Agent 的思考循环防死循环能力一流。️ 二、 核心数据库设计系统的核心业务是“预约”因此围绕这一动作设计了 4 张核心表User 表存储账号密码Bcrypt加密、角色Admin/Student。Lab 表实验室信息名称、容量、开放时间、状态。Equipment 表设备信息通过lab_id外键与 Lab 表强关联。Reservation 表预约记录包含user_id、lab_id、equipment_id三个外键以及预约日期、起止时间和状态。 三、 开发排雷实录血泪教训由于我是从零手搓在环境搭建和底层配置上踩了几个极其经典的坑如果你也在做类似的项目一定要避开 坑 1MySQL 8.0 连不上报错缺少cryptography现象安装好依赖后启动 Uvicorn后端瞬间红字崩溃提示RuntimeError: cryptography package is required for sha256_password or caching_sha2_password auth methods。分析MySQL 8.0 默认使用了更安全的caching_sha2_password认证方式而 Python 的pymysql需要底层加密库支持。解决直接在虚拟环境中pip install cryptography并在requirements.txt中锁死版本。 坑 2_init_.py的血案少写一个下划线现象Python 疯狂报错ModuleNotFoundError: No module named app.xxx。分析排查了半天发现新建的dependencies文件夹里初始化文件被命名成了_init_.py单下划线而正确的规范是__init__.py双下划线。这导致 Python 根本没把这个文件夹当成一个模块包。解决立刻重命名并记得删除本地的__pycache__缓存文件夹再重启。( 这不仅是开发踩坑也是很好的测试排查思维体现看日志 - 定位报错源码行 - 修正环境。) 四、 总结与预告项目的骨架已经搭好数据库也能正常跑通了。下一篇博客我将带大家手撕“JWT 鉴权体系”以及如何解决前端 Axios 拦截器吞掉response.data导致无穷白屏的深坑。 关于源码与答疑本项目包含完整的前后端代码、数据库 SQL 及全套 AI Agent 接入逻辑。如果你正在做毕设/课设或者想参考学习完整源码及部署文档可在主页私信我获取。后续我也会持续更新 RAG 和 LangGraph 的落地实战欢迎关注