LoveChengke
c7f215a09c
- 增加课件上传、班级可见范围、设备补收与传输进度 - 整合自定义灵动岛编辑器和相关客户端交互 - 同步三端契约、数据库迁移、部署配置与隔离回归 - 按源码统一文档与官网说明，移除过时任务书和审查记录 - 保持产品版本为 1.4.0
2.5 KiB
title, description
| title | description |
|---|---|
| MySQL 切换指南 | 通过快照和受支持的换库流程切换 SQLite/MySQL，保留迁移历史。 |
MySQL 切换指南
默认数据库为 SQLite，服务端也支持 MySQL/MariaDB。唯一 schema 为 packages/server/prisma/schema.prisma； Prisma 通过 libSQL 或 MariaDB driver adapter 访问，两种适配器已随运行时依赖内置。 角色、优先级等以 String 加 API 校验存储，不用 Prisma enum 或 @db.*。
已有数据的切换
管理员在“数据库管理 → 一键切换数据库”填写空目标库连接串，并完成界面确认。 还须 database:manage；页面和具体接口各自检查权限。
- 备份并导出当前数据库为 JSON 快照。
- 测试目标连接，确认目标为空。
- 改写 schema provider，子进程生成对应 Prisma Client。
- 打包形态编译生成的 TypeScript 客户端。
- 子进程基于当前 schema 建表，并用 apply-snapshot 写入快照。
- 成功后写入 .env 的 DATABASE_PROVIDER/DATABASE_URL；重启服务端连接新库。
失败时回滚 schema，环境配置仅在成功后写入。快照覆盖的表以 lib/snapshot.ts 为准。 目标已有表时拒绝；回到 SQLite 也应指定新空文件，不能删除正在使用的数据库。 旧源库请保留到验证完成。课件实体不在 JSON 内，换主机时需另复制文件目录，见课件。
源码开发与配置
scripts/use-database.mjs 只切换 schema provider，不迁移数据、不改 .env、不替代完整换库流程。 如果只准备一个全新的开发环境，可用 pnpm db:switch:mysql，再配置独立空库并生成客户端； 建模和导入仍按受支持流程完成。配置示例：
DATABASE_PROVIDER=mysql
DATABASE_URL="mysql://classhelper:your-password@127.0.0.1:3306/classhelper"
SQLite 迁移目录属于仓库升级历史，不要为了切库删除它，也不要对已有数据运行 db:seed/db:reset。 SQLite SQL 不直接应用到 MySQL；换库流程基于当前 schema 建表，保留原迁移用于 SQLite 升级。 Prisma Client 与实际 provider 必须一致；切换后未重启时旧进程仍连接旧库。
部署核验
确认新库连接、表行数、班级登录、课表和成绩读取；保留切换前快照。 生产凭据放 .env 或部署密钥中，不提交 Git。完整备份和各形态命令见数据库管理。 Linux 正式包应在 Linux 构建，否则 Prisma engine 可能是宿主平台版本，见Linux 部署。