临交材料最常见翻车:U 盘里塞了 2GB 的 node_modules、密码写在配置里、没有 SQL、部署说明只有「用 IDEA 打开」。老师换台电脑打不开,等于没交。测试表见 8 条用例;答辩环境备份见 3 分钟脚本。本页只解决:交什么、怎么打包、怎么自测。
合格线:压缩包 < 80MB(不含依赖目录);配置无真实密码;SQL 能建库并登录两个角色;docs/部署说明.md 按步骤能启动。你自己在另一台电脑或新文件夹复现过一次。
一、压缩包里只放这些
your-project/
backend/ # Spring Boot 源码,无 target/
frontend/ # Vue 源码,无 node_modules/ dist/
sql/
schema.sql # 建表
demo-data.sql # 演示账号和主流程数据
docs/
部署说明.md
账号.txt
screenshots/ # 登录、主流程、统计、ER
README.md # 一句话题目 + 指向部署说明
小程序把 miniprogram/ 放进来,体验版二维码截图放 screenshots/。Android 交源码 + 已签名 APK,不要只交 APK。
二、必须删掉的
| 删 | 为什么 |
|---|---|
node_modules/ target/ dist/ | 体积和本机路径,换电脑必坏 |
.idea/ .vscode/ 个人配置 | 泄露本机路径 |
| 真实密码、云密钥、微信 AppSecret | 安全事故;用 your-password 占位 |
| 论文 Word、查重报告 | 另交教务系统,别混进源码包 |
| 别人的完整电商模板未用模块 | 答辩被打开会穿帮 |
配置示例只保留:
spring.datasource.url=jdbc:mysql://127.0.0.1:3306/bysj_demo
spring.datasource.username=root
spring.datasource.password=your-password
三、部署说明最少 8 行(可复制改)
- 环境:JDK 17 / Maven 3.9 / MySQL 8 / Node 18(写你真实用的)
- 建库:
CREATE DATABASE bysj_demo DEFAULT CHARSET utf8mb4; - 导入
sql/schema.sql再导入sql/demo-data.sql - 改
application.yml里的库名和密码 - 后端:
mvn spring-boot:run或 IDEA 运行主类 - 前端:
npm i后npm run dev,访问文档里的地址 - 账号:学生
student / 123456,管理员admin / 123456(演示专用) - 主流程:登录 → 提交一条 → 管理员审核 → 看统计页
主流程必须和第 3 分钟演示一致,见 演示脚本。库表名和开题清单一致,见 4 张核心表。
四、SQL 里至少有什么
- 4 张核心表结构
- 两个角色各 1 个账号,密码可登录
- 1 条已通过业务、1 条待审核,方便立刻演示冲突或审核
- 统计页不是空的
不要交空库让老师自己点。中期如果已经有演示数据,终期沿用同一套,见 中期清单。
五、干净电脑自测(交之前 30 分钟)
- 解压到新路径,不要用原来的工程目录
- 按部署说明逐步做,不凭记忆
- 卡住的第一步改文档,不要口头补
- 能登录并走完主流程再打 zip
- zip 名:
专业-姓名-题目简称-源码.zip
这和测试用例互补:用例证明功能对,交付包证明别人能跑。论文第 6 章可附「测试环境与本文档一致」一句,见 论文结构。
六、常见翻车
| 做法 | 后果 | 改法 |
|---|---|---|
| 整盘复制 C 盘工程 | 路径、密钥、2GB 垃圾 | 按上表重装一份 |
| 只有前端没有后端 | 演示假数据 | 两端都交,端口写清 |
| SQL 是 Navicat 连接信息截图 | 导不进去 | 导出 .sql 文本 |
| 说明写「自己百度」 | 直接退回 | 8 行步骤 |
| 微信密钥写进仓库 | 安全问题 | 占位符 + 说明去公众平台填 |
常见问题
学院要求交 Git 仓库怎么办?
同样清密钥。README 指向部署说明。不要把 node_modules 提交进 Git。
必须买云服务器吗?
不是。答辩本机即可。若老师要公网,再用低配云或内网穿透,配置不要写进交付包的真实密钥。
Python / Django 有什么不同?
交 requirements.txt + python manage.py migrate 步骤。虚拟环境目录不要打包。
交了还会被说跑不起来?
多半是版本没写死。JDK、Node、MySQL 三个版本抄到文档第一行。
