SpringBoot+Vue+MySQL医院后台管理系统毕业设计实战指南-平芜编程栈

毕业设计季又到了，每年都会有同学选“医院后台管理系统”这个题目。确实，这个选题不偏不怪，又能把 SpringBoot+Vue+MySQL 这一整套主流技术串起来，最后交源码、数据库脚本、论文和部署文档，答辩也有东西可讲。我今年带学生完整做了一套，过程中踩了不少坑，也总结了不少可以直接照抄的经验。这篇文章就把整个项目从功能设计、数据库建模、前后端实现，到打包部署、写论文和应对答辩的要点完整过一遍，给正在做类似毕设的同学一个真正能落地的参考。

1. 系统定位与功能模块拆解

很多人一听到“医院后台管理系统”，第一反应就是“又要做一套 CRUD”。这个说法没错，但也不全对。毕业设计最怕的不是功能少，而是你做了很多页面，却说不清角色、流程和数据之间的关系。医院后台管理系统恰恰是一个业务链条非常完整的题目，从患者建档、挂号、医生接诊、开处方，到收费、取药，每一个环节都有明确的数据流转。把这个链条做顺了，项目深度自然就出来了。

1.1 为什么医院后台管理系统是毕业设计里的经典题

首先是边界清晰。医院内部管理后台，不涉及对外支付、在线问诊、物流等复杂场景，核心就是“人、科室、号源、病历、药品、收费”这几类数据。对于毕设而言，复杂度适中，既能体现前后端交互，又不会把自己困在某个细节里出不来。

其次是区分度好。比起学生信息管理系统、图书管理系统这些已经写到烂的题目，医院后台管理系统有“角色权限”“业务状态流转”“统计报表”这些加分点。你可以在中期检查时拿出用例图、ER 图、权限表设计，在答辩时讲清楚“一个患者从挂号到开药经历了哪些状态”，这些都比单纯展示列表页有说服力得多。

还有一点很实际：这类系统的参考资料多，但真正能直接跑通的又不多。很多同学从网上下载的源码要么版本太旧，要么数据库脚本残缺，要么跑起来全是报错。所以自己完整做一遍，把数据库、后端、前端、部署文档都补齐，本身就是一件很有价值的事。

1.2 用户角色与核心业务流程

我这套系统把用户分成四类：系统管理员、挂号收费员、医生、药房人员。实际医院里角色远不止这些，但毕业设计做到这个粒度就够了，关键在于“每个角色能干什么”要明确。

系统管理员：用户管理、角色权限管理、科室管理、药品信息维护、基础数据字典管理。
挂号收费员：患者建档、挂号、退号、收费、退费，以及挂号记录查询。
医生：查看当日挂号患者、填写门诊病历、开具处方/医嘱、查看历史病历。
药房人员：药品库存管理、处方发药/退药。

核心流程可以概括为：患者先来建档，收费员录入患者基本信息，然后挂号到某个科室的某个医生；医生登录系统后看到自己的待接诊患者，书写病历并开处方；患者拿着处方去收费，收费员完成收费后，药房人员看到已收费处方，进行发药并扣减库存。这个流程里，“挂号状态”“处方状态”“收费状态”是三个最容易被问到的状态字段，数据库设计时一定要保留。

1.3 功能模块清单

模块	核心功能	面向角色
系统管理	用户、角色、菜单、字典管理	管理员
科室管理	科室增删改查、科室负责人	管理员
患者管理	患者建档、查询、修改	挂号收费员
挂号管理	挂号、退号、当日挂号列表	挂号收费员
门诊病历	病历填写、历史病历查询	医生
处方管理	开处方、查看处方明细	医生、收费员、药房
药品管理	药品目录、库存、入库/出库	药房
收费管理	收费单生成、收费记录	挂号收费员
统计报表	挂号量、科室收入、药品消耗	管理员

表格里这些模块，每一个最终落到代码里都是“一张表 + 一组接口 + 一个页面”。不要一开始就想着全部实现，先把挂号和病历这条主链路跑通，再往四周扩展，项目进度会稳很多。

2. 技术选型与版本控制：不是越新越好

毕设答辩时，老师经常会问一句：“你为什么要用这个版本？”如果回答“我用的是最新版”，这个答案其实并不可靠。最新版往往意味着资料少、坑多，出了问题很难搜到解决方案。我更建议选一套“资料多、社区活跃、环境兼容”的版本组合。

2.1 Spring Boot 2.7.x 而不是 3.x

很多同学下载源码的时候，发现网上大量教程都是基于 Spring Boot 2.x 写的，而自己新建项目时 IDEA 默认给你拉到 3.x，结果导入依赖后启动直接报错。为什么？因为 Spring Boot 3.0 做了一件大事：把javax.servlet包迁移到了jakarta.servlet，很多老项目里用到的HttpServletRequest、ServletResponse、@RestController相关 import 直接就不一样了。

如果你的毕业设计不需要特别前沿的特性，我建议直接用 Spring Boot 2.7.18。这个版本是 2.x 的最终维护版本，资料最多，兼容性最好，配合 JDK 1.8 或者 JDK 11 都非常稳定。用 Spring Boot 2.7 还有一个好处：很多视频教程、博客案例都是这个版本，遇到问题搜索时几乎都能找到答案。我这里推荐的完整版本组合是：

JDK 1.8
Spring Boot 2.7.18
MyBatis-Plus 3.5.x
MySQL 8.0
Hutool 5.8.x（方便处理日期、加密等工具）

这个组合不能说是最先进的，但一定是毕业设计里“最不容易翻车”的组合。

2.2 前端用 Vue3 还是 Vue2

如果是从零学起，直接上 Vue3 + Vite。现在 Vue2 已经进入维护末期，新项目再去学 Vue2 有点浪费时间。Vue3 配合 Element Plus 组件库，后台管理系统常用的表格、表单、弹窗、分页全部现成，开发效率非常高。

我常用的前端工程配置是：

Vue 3.x
Vite 4.x
Element Plus 2.x
Vue Router 4.x
Pinia 2.x（替代 Vuex 的状态管理）
Axios 1.x

Node 版本建议用 16 或 18。如果你用的 Node 版本过高，比如 20 以上，Vite 4 可能也会有一些兼容提示，但一般不影响运行。如果遇到依赖安装报错，先检查 Node 版本，再考虑删除node_modules和package-lock.json重新安装。

2.3 MySQL 版本与连接参数

MySQL 我推荐 8.0。理由很简单：5.7 虽然也很经典，但 8.0 已经是现在的主流入门版本，网上绝大多数 SQL 示例都是基于 8.0 编写的，而且utf8mb4、窗口函数等特性在 8.0 里支持得更好。

Spring Boot 连接 MySQL 8.0 时，有两点容易踩坑：驱动类要写com.mysql.cj.jdbc.Driver，连接地址里要带时区参数。我一般这样配置：

spring: datasource: url: jdbc:mysql://localhost:3306/hospital_db?useUnicode=true&characterEncoding=utf8mb4&serverTimezone=Asia/Shanghai&useSSL=false&allowPublicKeyRetrieval=true username: root password: 123456 driver-class-name: com.mysql.cj.jdbc.Driver

不配置serverTimezone的话，8.0 默认时区是 UTC，你插入时间后会发现比本地时间少了 8 个小时。characterEncoding=utf8mb4是保证中文不会乱码的关键。allowPublicKeyRetrieval=true是为了避免 MySQL 8.0 在某些连接工具里报“Public Key Retrieval is not allowed”，加上这个参数能省去很多麻烦。

3. 数据库设计：表不复杂，但关系要讲清楚

数据库设计是毕业设计最容易扣分的地方，也是最值得花时间的地方。很多同学建表很随意，字段全是varchar，没有主外键概念，没有状态字段，后期写代码时处处受制。我的建议是：先画出核心业务表的关系，再动手写 SQL。

3.1 核心表清单与字段约定

我这套系统一共设计了 12 张表，核心的几张如下：

表名	作用	关键字段
sys_user	系统用户	id, username, password, real_name, role_id, status
sys_role	角色	id, role_code, role_name
department	科室	id, dept_name, dept_leader, status
doctor	医生信息	id, user_id, dept_id, title, phone
patient	患者	id, patient_no, name, gender, id_card, phone, birthday
registration	挂号记录	id, patient_id, doctor_id, dept_id, reg_date, period, status, fee
medical_record	门诊病历	id, registration_id, patient_id, doctor_id, diagnosis, chief_complaint, create_time
prescription	处方主表	id, registration_id, doctor_id, patient_id, total_amount, status
prescription_item	处方明细	id, prescription_id, drug_id, quantity, price
drug	药品	id, drug_code, drug_name, spec, stock, price
charge_record	收费记录	id, registration_id, patient_id, amount, charge_type, create_time

建表时我建议所有主键统一用bigint，同时把所有表都加上create_time、update_time两个公共字段，后期排查数据会非常方便。不要在每张表里用物理外键，而是通过业务代码保证数据一致性。这个设计思路在答辩时可以这样解释：物理外键会带来插入、删除时的强约束，分布式和后期分表时不灵活，所以保留逻辑关联字段即可。这个回答在大多数老师眼里都是加分的。

3.2 三张核心表的建表 SQL 示例

下面给出用户表、科室表、挂号表的简化版建表语句，大家可以参考字段类型和注释。实际项目里我还会加del_flag、create_by之类的字段，这里为了篇幅省略。

CREATE TABLE `sys_user` ( `id` bigint NOT NULL AUTO_INCREMENT, `username` varchar(50) NOT NULL COMMENT '登录账号', `password` varchar(100) NOT NULL COMMENT 'BCrypt加密后的密码', `real_name` varchar(50) DEFAULT NULL COMMENT '真实姓名', `role_id` bigint DEFAULT NULL COMMENT '角色ID', `status` tinyint DEFAULT '1' COMMENT '1启用 0禁用', `create_time` datetime DEFAULT NULL, `update_time` datetime DEFAULT NULL, PRIMARY KEY (`id`), UNIQUE KEY `uk_username` (`username`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='系统用户表';

科室表相对简单，重点是科室状态和负责人：

CREATE TABLE `department` ( `id` bigint NOT NULL AUTO_INCREMENT, `dept_name` varchar(100) NOT NULL COMMENT '科室名称', `dept_leader` varchar(50) DEFAULT NULL COMMENT '负责人', `status` tinyint DEFAULT '1' COMMENT '1正常 0停用', `create_time` datetime DEFAULT NULL, `update_time` datetime DEFAULT NULL, PRIMARY KEY (`id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='科室表';

挂号表是整个门诊流程的核心，状态字段尤其重要：

CREATE TABLE `registration` ( `id` bigint NOT NULL AUTO_INCREMENT, `patient_id` bigint NOT NULL COMMENT '患者ID', `doctor_id` bigint NOT NULL COMMENT '医生ID', `dept_id` bigint NOT NULL COMMENT '科室ID', `reg_date` date NOT NULL COMMENT '挂号日期', `period` tinyint DEFAULT '1' COMMENT '1上午 2下午', `status` tinyint DEFAULT '0' COMMENT '0待就诊 1已就诊 2已退号', `fee` decimal(10,2) DEFAULT '0.00' COMMENT '挂号费', `create_time` datetime DEFAULT NULL, `update_time` datetime DEFAULT NULL, PRIMARY KEY (`id`), KEY `idx_reg_date` (`reg_date`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='挂号记录表';

挂号表建索引很关键，因为系统里最常用的查询就是“按日期查询某个医生的号源”“统计某天挂号量”。没有索引，数据量大了之后查询会非常慢，答辩时老师如果问“你怎么优化查询性能”，你至少能说出这一层。

3.3 初始化数据与管理员账号

建完表之后不要直接写代码，先把初始化数据准备好。最少要有：

三条角色记录：管理员、医生、收费员
一个管理员账号：admin / admin123（密码存 BCrypt）
几个科室：内科、外科、儿科
对应的医生账号

这样整个系统从一开始就能看到真实数据，开发过程中不用每次手工往数据库里插数据验证效果。密码加密我建议用BCryptPasswordEncoder，不要用 MD5。答辩时可以顺带说一句“MD5 已经不安全，彩虹表攻击很容易破解，所以我使用 BCrypt 加盐存储”，这个细节很加分。

4. 后端实现：从登录到业务接口的完整链路

很多同学一上来就写 Controller，结果写到一半发现接口返回格式不统一、没有权限校验、事务控制缺失，返工率极高。后端开发更推荐先把基础架子搭好，再往里面填业务代码。

4.1 项目分层结构

我习惯按下面这种方式分包：

com.hospital ├── config // 配置类：CORS、拦截器、MyBatis-Plus分页插件 ├── controller // 接口层 ├── service // 业务层 ├── mapper // 数据访问层 ├── entity // 实体类 ├── common // 统一返回结果、异常处理、常量 └── util // JWT工具、日期工具等

这个分层结构本身也是论文里“系统架构”那一章的素材。controller只负责接收参数和返回结果，业务逻辑放在service，数据库操作在mapper。这样写出代码后，论文里的架构图和你代码目录结构完全一致，答辩时讲起来也不会逻辑混乱。

统一返回结果类大概是这样的：

public class Result<T> { private Integer code; private String message; private T data; public static <T> Result<T> success(T data) { Result<T> result = new Result<>(); result.code = 200; result.message = "操作成功"; result.data = data; return result; } public static <T> Result<T> error(String message) { Result<T> result = new Result<>(); result.code = 500; result.message = message; return result; } }

这样前端 Axios 拦截器里只需要判断code === 200就能统一处理成功和失败，不会出现“这个接口返回{status: 1}，那个接口返回{success: true}”的混乱局面。项目里所有接口都遵循这一套规范，代码可维护性会高很多。

4.2 登录与 JWT 权限控制

登录用 JWT 而不是 Session，这是毕业设计里很主流的做法，也很好讲。实现思路是：用户提交用户名和密码，后端校验通过后用用户信息生成一个 token，返回给前端。前端每次请求时在请求头里带Authorization: Bearer token，后端拦截器解析 token 并获取当前登录用户。

我用的是jjwt库，核心生成 token 的代码：

public String generateToken(Long userId, String username, String roleCode) { Map<String, Object> claims = new HashMap<>(); claims.put("userId", userId); claims.put("username", username); claims.put("roleCode", roleCode); return Jwts.builder() .setClaims(claims) .setSubject(username) .setIssuedAt(new Date()) .setExpiration(new Date(System.currentTimeMillis() + 1000 * 60 * 60 * 24)) .signWith(SignatureAlgorithm.HS256, secretKey) .compact(); }

拦截器里每次请求先放行登录接口、静态资源，再检查 token。如果解析失败或者过期，直接返回 401，前端收到 401 后跳转到登录页。这个方案不需要引入 Spring Security 那一大套东西，又能把“认证”和“授权”讲清楚，非常适合毕业设计。

如果非要用 Spring Security，也可以，但学习成本一下子高了很多：Filter 链、UserDetailsService、SecurityContextHolder 这些概念都要自己理清。我在实际操作中更推荐 JWT + 自定义拦截器，因为你自己写出来的每一行代码都能在答辩时解释清楚，而 Spring Security 的底层配置，很多同学被问两句就露馅了。

4.3 以“挂号管理”为例，讲清增删改查背后的细节

先说查询。挂号列表页面最常见的是按条件分页查询，包括“日期范围、科室、医生、状态”等条件。使用 MyBatis-Plus 的 LambdaQueryWrapper 可以这样写：

public IPage<RegistrationVO> getRegistrationPage(RegistrationQuery query) { Page<Registration> page = new Page<>(query.getPageNum(), query.getPageSize()); LambdaQueryWrapper<Registration> wrapper = new LambdaQueryWrapper<>(); wrapper.ge(query.getStartDate() != null, Registration::getRegDate, query.getStartDate()) .le(query.getEndDate() != null, Registration::getRegDate, query.getEndDate()) .eq(query.getDeptId() != null, Registration::getDeptId, query.getDeptId()) .eq(query.getDoctorId() != null, Registration::getDoctorId, query.getDoctorId()) .eq(query.getStatus() != null, Registration::getStatus, query.getStatus()) .orderByDesc(Registration::getRegDate); return registrationMapper.selectPage(page, wrapper); }

注意我每一条条件前面都加了“参数是否为 null”判断。这样前端不传某个条件时，SQL 自动跳过该条件，不需要写一堆 if 判断。这个写法在答辩时可以说是“利用 MyBatis-Plus 的条件构造器，避免手动拼接 SQL 带来的注入风险”。

再说“退号”这个操作。它不是一个简单的 delete，因为退号同时要改挂号状态、处理费用、释放号源。如果其中一步失败，数据就会不一致。所以我用@Transactional注解：

@Transactional(rollbackFor = Exception.class) public void refundRegistration(Long registrationId, Long operatorId) { Registration reg = registrationMapper.selectById(registrationId); if (reg == null || reg.getStatus() != 0) { throw new RuntimeException("当前挂号记录不存在或不可退号"); } reg.setStatus(2); registrationMapper.updateById(reg); // 如果有收费记录，同时生成一条退费记录，这里根据业务决定 }

为什么要用rollbackFor = Exception.class？默认情况下 Spring 事务只在遇到RuntimeException时回滚，如果某个方法抛出IOException或自定义的业务异常，事务并不会回滚，数据就出问题了。这个细节很多教材不会讲，但真正跑项目时会让你少掉很多头发。

5. 前端落地：Vue3 项目怎么看懂、怎么改

后端接口写好之后，前端工作其实就是把接口一个一个接进页面。但很多同学拿到一个 Vue 项目不知道从哪看起，这里我拆成三条线：路由、请求、页面。

5.1 路由、登录状态与菜单

前端项目里，src/router/index.js是入口。我在工程里把路由分成三部分：公共路由（登录页）、布局路由（带顶部导航和侧边栏的框架）、业务路由（医生管理、挂号管理、病历管理等）。

登录页提交后，把 token 存到 localStorage，然后在路由守卫里判断有没有 token：

router.beforeEach((to, from, next) => { const token = localStorage.getItem('token') if (to.path === '/login') { next() } else if (!token) { next('/login') } else { next() } })

菜单生成我做得比较“笨”：直接在侧边栏组件里根据当前用户角色判断显示哪些菜单项。后端接口当然也会做权限校验，所以前端隐藏菜单只是优化体验，真正安全的底线在后端。答辩时老师问“按钮权限怎么控制”时，你要能说清楚“前端控制显示，后端控制访问”，这个理解很重要。

5.2 Axios 封装与 Token 注入

每写一个页面就去发一次axios.get会非常累。我一般在src/utils/request.js里封装一个 axios 实例：

import axios from 'axios' import { ElMessage } from 'element-plus' const request = axios.create({ baseURL: '/api', timeout: 10000 }) request.interceptors.request.use(config => { const token = localStorage.getItem('token') if (token) { config.headers.Authorization = `Bearer ${token}` } return config }) request.interceptors.response.use( response => { const res = response.data if (res.code !== 200) { ElMessage.error(res.message || '请求失败') return Promise.reject(new Error(res.message)) } return res.data }, error => { if (error.response && error.response.status === 401) { localStorage.removeItem('token') window.location.href = '/login' } ElMessage.error(error.message || '网络异常') return Promise.reject(error) } ) export default request

开发环境里前后端端口不一样，Vite 代理可以解决跨域问题。在vite.config.js中配置：

export default defineConfig({ server: { port: 3000, proxy: { '/api': { target: 'http://localhost:8080', changeOrigin: true, rewrite: path => path.replace(/^\/api/, '') } } } })

这里有一个细节：后端接口地址是http://localhost:8080/registration/page，而前端请求写的是/api/registration/page。代理会自动把/api前缀去掉再转发给后端。这样打包部署时，只要 Nginx 里也配置了同样的/api转发规则，前端代码几乎不用改。

5.3 一个标准表格页面的写法

后台管理系统里 80% 的页面都是“搜索表单 + 表格 + 分页 + 新增/编辑弹窗”。以挂号列表页为例，模板骨架是：

<el-table :data="tableData" border> <el-table-column prop="patientName" label="患者姓名" /> <el-table-column prop="doctorName" label="接诊医生" /> <el-table-column prop="regDate" label="挂号日期" /> <el-table-column prop="status" label="状态"> <template #default="{ row }"> <el-tag :type="statusTag(row.status)">{{ statusText(row.status) }}</el-tag> </template> </el-table-column> <el-table-column label="操作"> <template #default="{ row }"> <el-button v-if="row.status === 0" type="danger" size="small" @click="refund(row)">退号</el-button> </template> </el-table-column> </el-table> <el-pagination v-model:current-page="query.pageNum" v-model:page-size="query.pageSize" :total="total" layout="total, prev, pager, next" @current-change="loadData" />

对应的loadData方法：

const loadData = async () => { const data = await request.get('/registration/page', { params: query }) tableData.value = data.records total.value = data.total }

这里比较建议大家把“状态”都做成枚举常量，比如：

const REG_STATUS = { WAITING: { text: '待就诊', tag: 'warning' }, FINISHED: { text: '已就诊', tag: 'success' }, REFUNDED: { text: '已退号', tag: 'info' } }

前端不要写死数字对应的含义，否则后期改状态名字时全页面都要搜索替换。用枚举集中管理，页面维护起来会轻松很多。

6. 部署交付：源码、数据库、文档，一个都不能少

很多毕设项目功能做得很好，但部署环节一塌糊涂。打开 README 不知道从哪开始跑，数据库脚本导入报错，前端和后端不知道哪个端口启动。交上去的部署文档如果只有“运行项目”四个字，老师印象分直接就下来了。一份合格的交付物至少得有清晰的运行顺序和打包步骤。

6.1 本地完整跑起来的顺序

我建议在部署文档里写这样一个清单：

安装 MySQL 8.0，执行项目里的hospital_db.sql脚本，创建数据库并导入数据。
安装 JDK 1.8，修改后端application.yml里的数据库账号密码，改成你本机的配置。
用 IDEA 打开后端项目，等待 Maven 依赖下载完成后，启动HospitalApplication.java。
安装 Node.js 16/18，在前端目录下执行npm install。
执行npm run dev，访问http://localhost:3000，用admin/admin123登录。

这五步看起来简单，但每一个都有坑。比如npm install很慢，可以设置淘宝镜像；再比如后端启动报错“端口被占用”，需要用netstat -ano | findstr 8080找到进程并结束。把这些问题写进部署文档的“常见问题”部分，这个文档才是有价值的。

6.2 后端打包与前端打包

后端打包，我最常用的命令：

mvn clean package -DskipTests

打包完成后在target目录下会生成一个hospital-admin-0.0.1-SNAPSHOT.jar。部署到服务器时，直接上传这个 jar 包，然后用java -jar启动。注意服务器环境变量里要有 Java 8 及以上。

前端打包：

npm run build

完成后生成dist目录，里面是纯静态文件。可以用 Nginx 托管，配置大概长这样：

server { listen 80; server_name your-domain.com; root /usr/share/nginx/html; index index.html; location / { try_files $uri $uri/ /index.html; } location /api/ { proxy_pass http://127.0.0.1:8080/; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; } }

try_files $uri $uri/ /index.html;这行是为了解决 Vue Router 的 history 模式刷新后 404 的问题。很多同学部署完后发现页面刷新就白屏，就是因为少了这一行。如果没有这台服务器，也可以用宝塔面板把前端放到/www/wwwroot下，后端用进程守护工具pm2或者宝塔自带的 Java 项目管理器来跑 jar 包，这样管理起来更省事。

6.3 部署文档应该包含哪些内容

不要只写运行步骤，我建议部署文档包含这几节：

环境要求：JDK、Node、MySQL、Nginx 版本清单
数据库初始化：脚本导入方式、初始账号密码
后端配置说明：数据源、Redis（如果有）、JWT 密钥
启动方式：IDEA 启动和服务器 jar 包启动两种
前端配置说明：环境变量、接口地址配置
打包步骤：mvn package和npm run build命令
服务器部署：Nginx 配置示例、进程管理方式
常见问题：端口冲突、数据库连接失败、前端白屏、跨域报错等

你把这些内容写好之后，直接复制到论文的“系统部署”一节修改一下就是现成内容。记住，部署文档不只是给老师看的，也是给一个月后的自己看的。毕设做完两个月后，你肯定记不清当时怎么配的环境。

7. 我从辅导过程中总结的高频踩坑点

每年带学生做项目，都会遇到几个复现率极高的报错。这些报错单个看都能搜到，但合在一起会浪费很多时间。这里我统一整理一下，方便大家排查。

7.1 Spring Boot 版本太高导致的 javax/jakarta 问题

现象：你从网上找的代码，import javax.servlet.http.HttpServletRequest;这一句直接报红，或者启动后提示找不到ServletException。

原因：新项目默认创建的是 Spring Boot 3.x，而别人的老代码用的是 2.x。Spring Boot 3 把javax.servlet换成了jakarta.servlet，连包名都变了。

处理办法：要么把 pom 中的spring-boot-starter-parent版本改成 2.7.18，要么把所有javax.*的 import 改成jakarta.*。对于毕设来说，直接用 2.7 更省事，因为大部分资料都是基于 2.x 写的。如果你的项目里已经有大量代码，改包名也不难，但要注意文档、配置、插件有没有跟随升级，不然踩完这个坑还有下一个。

7.2 Vue 项目“跑不起来”的常见原因

前端跑不起来通常集中在这几类：

npm install很慢或报错：换成国内镜像npm config set registry https://registry.npmmirror.com。
启动提示 “Node Sass” 报错：老项目用的node-sass和 Node 版本不兼容，建议把node-sass换成sass（dart-sass）或者升级项目。
启动后浏览器一片空白，控制台报 “Cannot read properties of undefined”：很可能是Element Plus没有正确注册，或者在main.js里引用了不存在的组件。可以在main.js中检查app.use(ElementPlus)是否配置。
Vite 项目提示Failed to load tsconfig：如果是 JS 项目，可以检查vite.config.js里的@vue/tsconfig引用，如果没装 TypeScript 可以忽略相关配置或删除tsconfig引用。

这些问题在项目部署文档中最好单独列出一节“前端常见问题排查”，哪怕只是简单写“删除node_modules和package-lock.json后重新npm install”，也能帮别人省下不少时间。

7.3 MySQL 连接失败、中文乱码与排序问题

MySQL 相关的问题，很多都出在连接参数上。连接失败先分清是哪一种：账号密码错误、服务没启动、端口被占用、还是驱动版本问题。常见排查命令：

# Windows 下查看 3306 端口有没有被监听 netstat -ano | findstr 3306

中文乱码问题，核心是保证数据库、表、连接参数三个地方都是utf8mb4。建库时不要用默认latin1：

CREATE DATABASE hospital_db DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;

连接地址里加上characterEncoding=utf8，这样基本不会乱码。至于 MySQL 的排序问题，默认utf8mb4_0900_ai_ci已经能处理中文排序，但如果你在查询结果中遇到排序不对的情况，可以用ORDER BY CONVERT(name USING gbk)来强制按拼音排序，这也是一个很实用的技巧。不过毕设里其实很少会用到这个，知道原理即可。

8. 论文与答辩：不要只会贴代码

很多同学代码写完，反而卡在论文上。这里我想说一个观念：论文不是代码的堆砌，而是把“你为什么要这样做”说清楚的文档。你项目里已经做的每一个设计决定，都是论文素材。

8.1 论文章节安排建议

我建议按这样安排：

摘要：一句话概括项目背景、技术栈、研究成果。
绪论：研究背景、意义、国内外现状、主要工作。
相关技术介绍：SpringBoot、Vue、MySQL、MyBatis-Plus、JWT。
系统分析：可行性分析、需求分析、用例图、业务流程。
系统设计：系统架构、功能模块设计、数据库设计（ER 图、表结构）。
系统实现：核心功能模块的截图和关键代码说明。
系统测试：功能测试用例、测试结果。
总结与展望：完成的工作、不足之处、改进方向。

写“系统实现”时不要整页整页贴代码。一个功能只要贴核心代码十到二十行，再加上一句“这里通过条件构造器实现动态查询，避免 SQL 拼接”就足够了。老师更关心你的分析和思考过程，而不是代码量。

画图工具推荐 draw.io 或者 ProcessOn，用例图、ER 图、流程图都画清楚。论文里的图和项目里的真实结构要一致，答辩时老师让你讲某个模块，你说“在文档第几页能看到”，比全程背稿要有说服力。

8.2 答辩高频问题与应答思路

根据我陪学生模拟答辩的经验，下列问题出现概率很高：

为什么选题医院后台管理系统？回答方向：业务覆盖角色权限、信息管理、流程状态，能全面锻炼前后端开发能力，相比纯 CRUD 题目更有业务深度。
SpringBoot 和 Vue 怎么进行数据交互？回答方向：前端通过 Axios 发送 HTTP 请求到后端 Controller，后端处理后返回统一 JSON 结构，前端通过拦截器处理响应。
为什么用 JWT 不用 Session？回答方向：JWT 是无状态认证，适合前后端分离，服务端不需要保存会话信息，扩展方便；Session 需要依赖服务端内存或 Redis，跨域处理也更麻烦。
如何防止 SQL 注入？回答方向：使用 MyBatis 的#{}预编译，不拼接 SQL 字符串；分页使用分页插件；所有条件参数都通过参数对象传递。
数据库表之间是怎么关联的？回答方向：先说核心表，再说业务关系。比如挂号表通过patient_id关联患者表，通过doctor_id关联医生/用户表，医生通过dept_id关联科室表。
项目有哪些不足？回答方向：不要說“没有不足”。可以说目前没有接入消息队列，高并发下挂号和缴费性能还可以优化；没有做分布式缓存，后续可以引入 Redis。这样既诚实又体现了你对未来的思考。

准备答辩最好的方法，就是把项目里每一个按钮点一遍，看它调用了哪个接口，接口做了什么数据库操作，数据库哪张表发生了变化。这套链路你能讲顺，答辩基本就稳了。

最后再说一点个人体会：做毕业设计最怕的不是不会，而是“看着视频敲一遍代码”之后依然什么都不懂。真正有效的做法是，哪怕你模仿着写，也要亲手把数据库脚本建一遍、把接口调试一遍、把页面连一遍，过程中所有报错都记录下来。这套系统做完以后，你会发现“部署文档”里的常见问题那一段，其实就是你自己的踩坑日记。把这些真实记录留在项目里，才是这个毕设最值钱的部分。

SpringBoot+Vue+MySQL医院后台管理系统毕业设计实战指南