尧图网页设计 
简介一份基于Java的学校管理系统毕业设计项目包适合计算机相关专业毕业生用于课程设计或毕设参考覆盖学校日常教务、师生信息、公告新闻等常见业务模块可直接运行演示并支持二次开发。压缩包内共601个文件资源类型较为完整Java源码与class文件体现后端业务逻辑jsp页面与css、js构成前端交互界面png、gif等图片用于页面展示xml、properties承担配置管理另有sql数据库脚本便于导入初始化数据。整体大小约31.86MB目录结构按功能模块划分便于对照学习。目前已有451人学习下载。通过该项目可掌握经典Java Web开发流程理解控制器、Service、DAO分层设计还能获得一套可复用的数据库表结构与后台管理界面适合毕设选题、答辩展示或项目实训时快速搭建学校管理场景。1. 为什么学校管理系统要用分层Controller 关系型数据库毕业设计拿到一个压缩包直接双击运行是最常见的翻车方式。这个学校管理系统项目里编译后的class文件暴露了它的结构UserController、NewsController、AdminController等能看出后端是标准的Controller-Service-Mapper分层。这套结构在答辩和后续代码审查里最容易讲清楚也最容易在上面做二次开发。如果你是Java后端初学者想快速撑起一个可演示、可扩展的学校管理系统这个源码加数据库的组合比从零写要划算得多但前提是你得先读懂它而不是把它当成一个黑盒。2. 数据库建模从用户表到新闻表的字段设计与级联约束2.1 学校管理系统需要哪几张核心表打开源码里db目录下的SQL脚本你会发现它不是一张大表撑全场而是拆成多张表。常见的学校管理系统至少要覆盖两类角色前台用户学生/教师和后台管理员。因此表结构围绕这两个身份展开。下面这张表是这个项目里最合理的一套设计你可以对照自己的school.sql核对表名作用关键字段sys_user前台用户信息id, username, password, real_name, role_id, statussys_role角色表id, role_code, role_namenews新闻公告id, title, content, publish_time, publisher_idadmin_user后台管理员id, username, password, is_enabled注意这里没有把密码明文字段叫做password别名而是直接用password存储BCrypt或MD5摘要。毕业设计里使用MySQL自带的MD5()也能应付但如果你在简历里写“做了权限控制”最好还是用BCrypt。这个设计对后续的AdminController和UserController都是同一个套路先建表再写Mapper再写Controller。2.2 数据库脚本与字符集陷阱很多同学把SQL文件拖进Navicat执行完才发现中文全是问号。根源不是SQL没写好而是CREATE DATABASE没有指定字符集。项目里SQL脚本的第一段通常长这样CREATE DATABASE IF NOT EXISTS school_system DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; USE school_system; -- 用户表 CREATE TABLE sys_user ( id INT AUTO_INCREMENT PRIMARY KEY COMMENT 用户ID, username VARCHAR(50) NOT NULL UNIQUE COMMENT 登录名, password VARCHAR(100) NOT NULL COMMENT 密码摘要, real_name VARCHAR(50) DEFAULT NULL COMMENT 姓名, role_id INT DEFAULT 2 COMMENT 角色ID1管理员2普通用户, status TINYINT DEFAULT 1 COMMENT 状态1启用0禁用, create_time DATETIME DEFAULT CURRENT_TIMESTAMP ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT前台用户表;这里有两处值得注意。第一utf8mb4是MySQL 5.5.3之后才引入的编码它能存储emoji和生僻字而utf8在MySQL里最长只有3字节遇到“旻”这类字会写入失败。第二COLLATE utf8mb4_general_ci是大小写不敏感的比较规则所以登录时where username Admin也能匹配到admin这对初版系统更友好。status字段虽然只有0和1但不要用布尔类型因为保留一个扩展位将来你要加“待审核”状态时TINYINT不用改表。管理员的初始化脚本也同样要注意字符集和默认值CREATE TABLE admin_user ( id INT AUTO_INCREMENT PRIMARY KEY, username VARCHAR(50) NOT NULL UNIQUE, password VARCHAR(100) NOT NULL, is_enabled TINYINT DEFAULT 1 ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT后台管理员; INSERT INTO admin_user (username, password) VALUES (admin, MD5(123456));这段脚本可以直接在Navicat里执行。MD5(123456)虽然强度不高但足够应付演示环境生产系统不要这么写。注意admin_user表结构与sys_user高度相似但为了区分后台登录和前台登录大多数毕业设计都会拆成两张表。合并成一张表加user_type字段也可以但会增加Controller层判断分支反而不利于你答辩时讲清楚权限边界。2.3 按外键还是按逻辑关联学校管理系统里的表通常不建物理外键。原因很直白源码里的NewsController要删除新闻如果news表被某个日志表外键引用删除时会被RESTRICT卡住你需要先去清理子表数据。用逻辑关联的意思是只在sys_user.role_id和news.publisher_id上建普通索引通过Mapper里的JOIN查询去把关联表的数据取出来。代价是多写一点SQL换来的是删除和迁移数据时少踩很多坑。这里还要注意MySQL在Linux和Windows上的表名大小写敏感差异。Windows上School_System和school_system都能查到但Linux上只会按你建表时的大小写来找。为了不在上线时出问题建表语句里的库名和表名最好统一小写并且连接串里的school_system要和SQL脚本里保持一致。如果你在画ER图时为了答辩效果一定要显示关系可以在设计文档里用虚线表示逻辑外键并注释“为提升扩展性不强制数据库依赖”。这个说法比“数据库不支持外键”专业得多也能挡住评委可能追问的“为什么不建立外键”。3. 核心接口实现登录鉴权、CRUD控制器与参数绑定3.1 Controller 层的路由设计源码里的UserController.class和NewsController.class说明项目使用Spring MVC风格的RestController。这类控制器通常按资源划分路由/user管用户/news管新闻/admin管后台。下面这张表是学校管理系统最常见的一组接口你可以拿它对照自己的源码。路由方法作用/user/loginPOST用户登录/user/listGET用户列表分页/user/savePOST新增/编辑用户/user/deletePOST删除用户/news/listGET新闻分页列表/news/detailGET新闻详情/admin/dashboardGET统计数据路由命名最好用复数资源名不要用/userAction.do这种Action后缀。原因很简单前端页面用ajax调用时/user/list比/user.do?methodlist更容易让别人第一眼看出是REST风格接口而且Spring Boot默认支持这种路径匹配不需要额外配置。3.2 一个可抄的UserController下面是一段精简但完整的用户管理Controller代码它包含了登录、分页查询、删除三个操作RestController RequestMapping(/user) public class UserController { Autowired private UserService userService; PostMapping(/login) public Result login(RequestBody UserVO userVO, HttpServletRequest request) { UserVO dbUser userService.login(userVO.getUsername(), userVO.getPassword()); if (dbUser null) { return Result.error(用户名或密码错误); } HttpSession session request.getSession(); session.setAttribute(userId, dbUser.getId()); return Result.success(dbUser); } GetMapping(/list) public Result list(RequestParam(defaultValue 1) Integer page, RequestParam(defaultValue 10) Integer limit, String keyword) { PageResultUserVO pageResult userService.page(page, limit, keyword); return Result.success(pageResult); } PostMapping(/delete) public Result delete(RequestParam Integer id) { userService.deleteById(id); return Result.success(null); } }代码里的RequestBody把前端传来的JSON自动绑定到UserVO对象这一步省去了手写JSONObject.parseObject的麻烦RequestParam(defaultValue 1)给分页参数设置了默认值如果前端漏传page不会直接报错。Result是全局统一返回体一般包含code、message、data三个字段。你在答辩时一定要能说清这个返回体因为评委经常问“前端怎么知道后端成功没有”。登录接口里没有写密码加密逻辑实际项目中UserService.login里应该先对输入密码做MD5或BCrypt再和数据库里的摘要比对。如果直接用明文查询一旦数据库泄露所有用户密码都会暴露。3.3 参数校验与JSON返回用户提交数据时密码不能为空用户名长度应在4到20位之间。如果你用Spring Boot 2.3之后的版本可以直接用Validated配合校验注解比在Controller里手动if (username null)干净得多public class UserVO { NotBlank(message 用户名不能为空) Size(min 4, max 20, message 用户名长度必须在4-20位之间) private String username; NotBlank(message 密码不能为空) private String password; // getter / setter 省略 }NotBlank会自动拦截空字符串Size的message会在校验失败时作为字段错误信息返回。但要注意只有配合Validated或Valid注解才会生效而且无论哪种方式都需要全局异常处理器来接收MethodArgumentNotValidException否则弹窗提示只是一段晦涩的英文。毕业设计里最省事的做法是写一个GlobalExceptionHandler用RestControllerAdvice统一把校验异常转成Result.error(message)这样前端只需要读code和message两个字段。在前后端交互中状态码建议用三位数字而不是英文200成功、400参数错误、401未登录、403无权限、500服务异常。你的前端ajax回调里通常这样判断if (res.code 200) { refreshTable(); } else { layui.layer.msg(res.message, { icon: 2 }); }状态码统一之后Controller里不需要反复捕获业务异常只需要throw new BusinessException(账号被禁用)全局异常处理器把它转成Result.error(400, 账号被禁用)即可。这样的设计会让代码量减少三分之一也是答辩时可以说“实现了统一异常处理”的支撑点。4. 从zip到本地运行Maven工程导入与MySQL配置排错4.1 解压结构与Maven导入步骤下载的源码数据库.zip解压后典型目录结构是这样的school-system/ ├── pom.xml ├── src/main/java ├── src/main/resources │ ├── application.yml │ └── mapper/ └── db/ └── school_system.sql先不要急着打开IDEA先用命令行确认Maven和JDK版本是否符合项目要求。常见的毕业设计项目用的是JDK 8 Maven 3.6或者JDK 11 Maven 3.8。检查命令如下java -version mvn -version如果本机没有Maven直接下载Binary归档版并配置环境变量。然后在IDEA中选择File - Open选中解压后的pom.xmlIDEA会提示Import as Maven Project确认后等待依赖下载。这里最大的坑是Maven中央仓库访问较慢国内网络环境建议在settings.xml里配置阿里云镜像mirror idaliyunmaven/id mirrorOfcentral/mirrorOf name阿里云公共仓库/name urlhttps://maven.aliyun.com/repository/public/url /mirror配置完镜像后重新reload all maven projects。依赖下载完成后看External Libraries里是否有Spring Boot相关jar如果多了很多红色波浪线多半是JRE版本不对记得在Project Structure里把Project SDK切到8或11。4.2 application.yml 核心配置数据库连接是很多人启动失败的重灾区。resources/application.yml里的默认配置通常是下面这样你需要改成自己的账号密码server: port: 8080 spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/school_system?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghaiuseSSLfalse username: root password: 123456 mybatis: mapper-locations: classpath:mapper/*.xml configuration: map-underscore-to-camel-case: true这里的driver-class-name在MySQL 8.x时必须是com.mysql.cj.jdbc.Driver如果写成com.mysql.jdbc.Driver会提示java.sql.SQLException。serverTimezoneAsia/Shanghai是必须的不写的话MySQL 8会拿系统当前时区去比较报The server time zone value Öйú±ê׼ʱ¼ä is unrecognized。map-underscore-to-camel-case打开后user_name字段能自动映射到userName成员变量Mapper XML里就不用挨个写resultMap的column映射了。配置完成后可以直接在IDEA终端运行mvn spring-boot:run看到Started SchoolSystemApplication就说明启动成功。此时访问http://localhost:8080/user/list如果返回JSON中有用户数据数据库连接就通了。4.3 四大启动失败场景我在帮学弟调试这套源码时收集到最高频的四个报错做成了对照表报错关键字原因处理方式Access denied for user数据库密码错误在MySQL里执行ALTER USER rootlocalhost IDENTIFIED BY 新密码;Unknown database还没导入SQL用Navicat先执行CREATE DATABASE school_system再运行SQL脚本Port 8080 was already in use端口被占用换server.port或netstat -anoInvalid bound statementMapper XML没扫到检查mapper-locations路径以及XML里的namespace是否与接口全限定名一致其中Invalid bound statement最常见也最难查。它在启动时往往不报错直到第一次调用/user/list才返回500。排错思路是看target/classes/mapper目录下有没有生成对应的XML没有的话就是IDEA没把resources里的xml文件编译进去需要在pom.xml的buildresources里显式声明包含src/main/java目录下的xml文件——很多毕业设计把Mapper XML混放在Java包内这一步必不可少。5. 毕业设计升级技巧清理冗余Controller并加入权限拦截5.1 识别DoctorController/HospitalController这类残留文件解压后你在target/classes目录下可能看到DoctorController.class和HospitalController.class。这不是学校管理系统的功能而是源码模板在早期被复用于一个医疗信息系统的副本原作者打包时没有删干净。如果直接把这些class文件连同对应的DoctorController.java留在项目里不仅会占用空间还有可能因为组件扫描被注册成Spring Bean启动时找不到它依赖的Service而报错。处理方式是在IDEA里打开src/main/java找到controller目录逐个确认每个Controller的RequestMapping和类名含义与学校校务无关的控制器整目录删除然后执行mvn clean清理target残留。删除时注意IDE的引用搜索如果某个Service只在垃圾Controller里被引用也要一并删干净。5.2 使用HandlerInterceptor做简单的登录拦截原系统很多接口没有权限保护写论文时容易被评委吐槽。常见做法是增加一个拦截器检查session中是否存在userId。下面这个拦截器可以直接抄进项目public class LoginInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { HttpSession session request.getSession(); Object userId session.getAttribute(userId); if (userId null) { response.setContentType(application/json;charsetUTF-8); response.getWriter().write({\code\:401,\message\:\未登录\}); return false; } return true; } }然后在配置类里注册Configuration public class WebConfig implements WebMvcConfigurer { Override public void addInterceptors(InterceptorRegistry registry) { registry.addInterceptor(new LoginInterceptor()) .addPathPatterns(/**) .excludePathPatterns(/user/login, /news/list, /news/detail); } }addPathPatterns(/**)拦截所有请求excludePathPatterns放行登录和新闻浏览。这里要注意顺序放行路径必须写全否则用户在登录页就会收到401。HandlerInterceptor比Filter好在它可以直接访问HandlerMethod将来如果你需要做“只有管理员可以访问/admin/**”在preHandle里通过request.getRequestURI()判断前缀即可。5.3 答辩前要做的三件事第一给项目写一个README.md把JDK版本、MySQL版本、导入步骤、默认账号密码三行写清楚这是演示时不慌的基础。第二把源码里预留的DoctorController相关代码删除后重新跑一遍全部功能防止答辩现场因为编译错误打不开。第三如果时间允许把数据库设计中的sys_role表真正利用起来在登录时把角色ID存进session然后通过一个自定义注解控制接口权限GetMapping(/admin/userList) RequireRole(1) public Result adminUserList() { return Result.success(userService.list()); }这个自定义注解可以仿照RequireRole配合HandlerInterceptor实现原理与登录拦截类似但多看了HandlerMethod上的注解信息。完成这三点之后这个学校管理系统就不再是只能跑通的源码而是一个你能讲清楚每个决策的完整答辩项目。本文还有配套的精品资源点击获取 学校管理系统实战：Controller分层与数据库设计要点解析
简介一份基于Java的学校管理系统毕业设计项目包适合计算机相关专业毕业生用于课程设计或毕设参考覆盖学校日常教务、师生信息、公告新闻等常见业务模块可直接运行演示并支持二次开发。压缩包内共601个文件资源类型较为完整Java源码与class文件体现后端业务逻辑jsp页面与css、js构成前端交互界面png、gif等图片用于页面展示xml、properties承担配置管理另有sql数据库脚本便于导入初始化数据。整体大小约31.86MB目录结构按功能模块划分便于对照学习。目前已有451人学习下载。通过该项目可掌握经典Java Web开发流程理解控制器、Service、DAO分层设计还能获得一套可复用的数据库表结构与后台管理界面适合毕设选题、答辩展示或项目实训时快速搭建学校管理场景。1. 为什么学校管理系统要用分层Controller 关系型数据库毕业设计拿到一个压缩包直接双击运行是最常见的翻车方式。这个学校管理系统项目里编译后的class文件暴露了它的结构UserController、NewsController、AdminController等能看出后端是标准的Controller-Service-Mapper分层。这套结构在答辩和后续代码审查里最容易讲清楚也最容易在上面做二次开发。如果你是Java后端初学者想快速撑起一个可演示、可扩展的学校管理系统这个源码加数据库的组合比从零写要划算得多但前提是你得先读懂它而不是把它当成一个黑盒。2. 数据库建模从用户表到新闻表的字段设计与级联约束2.1 学校管理系统需要哪几张核心表打开源码里db目录下的SQL脚本你会发现它不是一张大表撑全场而是拆成多张表。常见的学校管理系统至少要覆盖两类角色前台用户学生/教师和后台管理员。因此表结构围绕这两个身份展开。下面这张表是这个项目里最合理的一套设计你可以对照自己的school.sql核对表名作用关键字段sys_user前台用户信息id, username, password, real_name, role_id, statussys_role角色表id, role_code, role_namenews新闻公告id, title, content, publish_time, publisher_idadmin_user后台管理员id, username, password, is_enabled注意这里没有把密码明文字段叫做password别名而是直接用password存储BCrypt或MD5摘要。毕业设计里使用MySQL自带的MD5()也能应付但如果你在简历里写“做了权限控制”最好还是用BCrypt。这个设计对后续的AdminController和UserController都是同一个套路先建表再写Mapper再写Controller。2.2 数据库脚本与字符集陷阱很多同学把SQL文件拖进Navicat执行完才发现中文全是问号。根源不是SQL没写好而是CREATE DATABASE没有指定字符集。项目里SQL脚本的第一段通常长这样CREATE DATABASE IF NOT EXISTS school_system DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; USE school_system; -- 用户表 CREATE TABLE sys_user ( id INT AUTO_INCREMENT PRIMARY KEY COMMENT 用户ID, username VARCHAR(50) NOT NULL UNIQUE COMMENT 登录名, password VARCHAR(100) NOT NULL COMMENT 密码摘要, real_name VARCHAR(50) DEFAULT NULL COMMENT 姓名, role_id INT DEFAULT 2 COMMENT 角色ID1管理员2普通用户, status TINYINT DEFAULT 1 COMMENT 状态1启用0禁用, create_time DATETIME DEFAULT CURRENT_TIMESTAMP ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT前台用户表;这里有两处值得注意。第一utf8mb4是MySQL 5.5.3之后才引入的编码它能存储emoji和生僻字而utf8在MySQL里最长只有3字节遇到“旻”这类字会写入失败。第二COLLATE utf8mb4_general_ci是大小写不敏感的比较规则所以登录时where username Admin也能匹配到admin这对初版系统更友好。status字段虽然只有0和1但不要用布尔类型因为保留一个扩展位将来你要加“待审核”状态时TINYINT不用改表。管理员的初始化脚本也同样要注意字符集和默认值CREATE TABLE admin_user ( id INT AUTO_INCREMENT PRIMARY KEY, username VARCHAR(50) NOT NULL UNIQUE, password VARCHAR(100) NOT NULL, is_enabled TINYINT DEFAULT 1 ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT后台管理员; INSERT INTO admin_user (username, password) VALUES (admin, MD5(123456));这段脚本可以直接在Navicat里执行。MD5(123456)虽然强度不高但足够应付演示环境生产系统不要这么写。注意admin_user表结构与sys_user高度相似但为了区分后台登录和前台登录大多数毕业设计都会拆成两张表。合并成一张表加user_type字段也可以但会增加Controller层判断分支反而不利于你答辩时讲清楚权限边界。2.3 按外键还是按逻辑关联学校管理系统里的表通常不建物理外键。原因很直白源码里的NewsController要删除新闻如果news表被某个日志表外键引用删除时会被RESTRICT卡住你需要先去清理子表数据。用逻辑关联的意思是只在sys_user.role_id和news.publisher_id上建普通索引通过Mapper里的JOIN查询去把关联表的数据取出来。代价是多写一点SQL换来的是删除和迁移数据时少踩很多坑。这里还要注意MySQL在Linux和Windows上的表名大小写敏感差异。Windows上School_System和school_system都能查到但Linux上只会按你建表时的大小写来找。为了不在上线时出问题建表语句里的库名和表名最好统一小写并且连接串里的school_system要和SQL脚本里保持一致。如果你在画ER图时为了答辩效果一定要显示关系可以在设计文档里用虚线表示逻辑外键并注释“为提升扩展性不强制数据库依赖”。这个说法比“数据库不支持外键”专业得多也能挡住评委可能追问的“为什么不建立外键”。3. 核心接口实现登录鉴权、CRUD控制器与参数绑定3.1 Controller 层的路由设计源码里的UserController.class和NewsController.class说明项目使用Spring MVC风格的RestController。这类控制器通常按资源划分路由/user管用户/news管新闻/admin管后台。下面这张表是学校管理系统最常见的一组接口你可以拿它对照自己的源码。路由方法作用/user/loginPOST用户登录/user/listGET用户列表分页/user/savePOST新增/编辑用户/user/deletePOST删除用户/news/listGET新闻分页列表/news/detailGET新闻详情/admin/dashboardGET统计数据路由命名最好用复数资源名不要用/userAction.do这种Action后缀。原因很简单前端页面用ajax调用时/user/list比/user.do?methodlist更容易让别人第一眼看出是REST风格接口而且Spring Boot默认支持这种路径匹配不需要额外配置。3.2 一个可抄的UserController下面是一段精简但完整的用户管理Controller代码它包含了登录、分页查询、删除三个操作RestController RequestMapping(/user) public class UserController { Autowired private UserService userService; PostMapping(/login) public Result login(RequestBody UserVO userVO, HttpServletRequest request) { UserVO dbUser userService.login(userVO.getUsername(), userVO.getPassword()); if (dbUser null) { return Result.error(用户名或密码错误); } HttpSession session request.getSession(); session.setAttribute(userId, dbUser.getId()); return Result.success(dbUser); } GetMapping(/list) public Result list(RequestParam(defaultValue 1) Integer page, RequestParam(defaultValue 10) Integer limit, String keyword) { PageResultUserVO pageResult userService.page(page, limit, keyword); return Result.success(pageResult); } PostMapping(/delete) public Result delete(RequestParam Integer id) { userService.deleteById(id); return Result.success(null); } }代码里的RequestBody把前端传来的JSON自动绑定到UserVO对象这一步省去了手写JSONObject.parseObject的麻烦RequestParam(defaultValue 1)给分页参数设置了默认值如果前端漏传page不会直接报错。Result是全局统一返回体一般包含code、message、data三个字段。你在答辩时一定要能说清这个返回体因为评委经常问“前端怎么知道后端成功没有”。登录接口里没有写密码加密逻辑实际项目中UserService.login里应该先对输入密码做MD5或BCrypt再和数据库里的摘要比对。如果直接用明文查询一旦数据库泄露所有用户密码都会暴露。3.3 参数校验与JSON返回用户提交数据时密码不能为空用户名长度应在4到20位之间。如果你用Spring Boot 2.3之后的版本可以直接用Validated配合校验注解比在Controller里手动if (username null)干净得多public class UserVO { NotBlank(message 用户名不能为空) Size(min 4, max 20, message 用户名长度必须在4-20位之间) private String username; NotBlank(message 密码不能为空) private String password; // getter / setter 省略 }NotBlank会自动拦截空字符串Size的message会在校验失败时作为字段错误信息返回。但要注意只有配合Validated或Valid注解才会生效而且无论哪种方式都需要全局异常处理器来接收MethodArgumentNotValidException否则弹窗提示只是一段晦涩的英文。毕业设计里最省事的做法是写一个GlobalExceptionHandler用RestControllerAdvice统一把校验异常转成Result.error(message)这样前端只需要读code和message两个字段。在前后端交互中状态码建议用三位数字而不是英文200成功、400参数错误、401未登录、403无权限、500服务异常。你的前端ajax回调里通常这样判断if (res.code 200) { refreshTable(); } else { layui.layer.msg(res.message, { icon: 2 }); }状态码统一之后Controller里不需要反复捕获业务异常只需要throw new BusinessException(账号被禁用)全局异常处理器把它转成Result.error(400, 账号被禁用)即可。这样的设计会让代码量减少三分之一也是答辩时可以说“实现了统一异常处理”的支撑点。4. 从zip到本地运行Maven工程导入与MySQL配置排错4.1 解压结构与Maven导入步骤下载的源码数据库.zip解压后典型目录结构是这样的school-system/ ├── pom.xml ├── src/main/java ├── src/main/resources │ ├── application.yml │ └── mapper/ └── db/ └── school_system.sql先不要急着打开IDEA先用命令行确认Maven和JDK版本是否符合项目要求。常见的毕业设计项目用的是JDK 8 Maven 3.6或者JDK 11 Maven 3.8。检查命令如下java -version mvn -version如果本机没有Maven直接下载Binary归档版并配置环境变量。然后在IDEA中选择File - Open选中解压后的pom.xmlIDEA会提示Import as Maven Project确认后等待依赖下载。这里最大的坑是Maven中央仓库访问较慢国内网络环境建议在settings.xml里配置阿里云镜像mirror idaliyunmaven/id mirrorOfcentral/mirrorOf name阿里云公共仓库/name urlhttps://maven.aliyun.com/repository/public/url /mirror配置完镜像后重新reload all maven projects。依赖下载完成后看External Libraries里是否有Spring Boot相关jar如果多了很多红色波浪线多半是JRE版本不对记得在Project Structure里把Project SDK切到8或11。4.2 application.yml 核心配置数据库连接是很多人启动失败的重灾区。resources/application.yml里的默认配置通常是下面这样你需要改成自己的账号密码server: port: 8080 spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/school_system?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghaiuseSSLfalse username: root password: 123456 mybatis: mapper-locations: classpath:mapper/*.xml configuration: map-underscore-to-camel-case: true这里的driver-class-name在MySQL 8.x时必须是com.mysql.cj.jdbc.Driver如果写成com.mysql.jdbc.Driver会提示java.sql.SQLException。serverTimezoneAsia/Shanghai是必须的不写的话MySQL 8会拿系统当前时区去比较报The server time zone value Öйú±ê׼ʱ¼ä is unrecognized。map-underscore-to-camel-case打开后user_name字段能自动映射到userName成员变量Mapper XML里就不用挨个写resultMap的column映射了。配置完成后可以直接在IDEA终端运行mvn spring-boot:run看到Started SchoolSystemApplication就说明启动成功。此时访问http://localhost:8080/user/list如果返回JSON中有用户数据数据库连接就通了。4.3 四大启动失败场景我在帮学弟调试这套源码时收集到最高频的四个报错做成了对照表报错关键字原因处理方式Access denied for user数据库密码错误在MySQL里执行ALTER USER rootlocalhost IDENTIFIED BY 新密码;Unknown database还没导入SQL用Navicat先执行CREATE DATABASE school_system再运行SQL脚本Port 8080 was already in use端口被占用换server.port或netstat -anoInvalid bound statementMapper XML没扫到检查mapper-locations路径以及XML里的namespace是否与接口全限定名一致其中Invalid bound statement最常见也最难查。它在启动时往往不报错直到第一次调用/user/list才返回500。排错思路是看target/classes/mapper目录下有没有生成对应的XML没有的话就是IDEA没把resources里的xml文件编译进去需要在pom.xml的buildresources里显式声明包含src/main/java目录下的xml文件——很多毕业设计把Mapper XML混放在Java包内这一步必不可少。5. 毕业设计升级技巧清理冗余Controller并加入权限拦截5.1 识别DoctorController/HospitalController这类残留文件解压后你在target/classes目录下可能看到DoctorController.class和HospitalController.class。这不是学校管理系统的功能而是源码模板在早期被复用于一个医疗信息系统的副本原作者打包时没有删干净。如果直接把这些class文件连同对应的DoctorController.java留在项目里不仅会占用空间还有可能因为组件扫描被注册成Spring Bean启动时找不到它依赖的Service而报错。处理方式是在IDEA里打开src/main/java找到controller目录逐个确认每个Controller的RequestMapping和类名含义与学校校务无关的控制器整目录删除然后执行mvn clean清理target残留。删除时注意IDE的引用搜索如果某个Service只在垃圾Controller里被引用也要一并删干净。5.2 使用HandlerInterceptor做简单的登录拦截原系统很多接口没有权限保护写论文时容易被评委吐槽。常见做法是增加一个拦截器检查session中是否存在userId。下面这个拦截器可以直接抄进项目public class LoginInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { HttpSession session request.getSession(); Object userId session.getAttribute(userId); if (userId null) { response.setContentType(application/json;charsetUTF-8); response.getWriter().write({\code\:401,\message\:\未登录\}); return false; } return true; } }然后在配置类里注册Configuration public class WebConfig implements WebMvcConfigurer { Override public void addInterceptors(InterceptorRegistry registry) { registry.addInterceptor(new LoginInterceptor()) .addPathPatterns(/**) .excludePathPatterns(/user/login, /news/list, /news/detail); } }addPathPatterns(/**)拦截所有请求excludePathPatterns放行登录和新闻浏览。这里要注意顺序放行路径必须写全否则用户在登录页就会收到401。HandlerInterceptor比Filter好在它可以直接访问HandlerMethod将来如果你需要做“只有管理员可以访问/admin/**”在preHandle里通过request.getRequestURI()判断前缀即可。5.3 答辩前要做的三件事第一给项目写一个README.md把JDK版本、MySQL版本、导入步骤、默认账号密码三行写清楚这是演示时不慌的基础。第二把源码里预留的DoctorController相关代码删除后重新跑一遍全部功能防止答辩现场因为编译错误打不开。第三如果时间允许把数据库设计中的sys_role表真正利用起来在登录时把角色ID存进session然后通过一个自定义注解控制接口权限GetMapping(/admin/userList) RequireRole(1) public Result adminUserList() { return Result.success(userService.list()); }这个自定义注解可以仿照RequireRole配合HandlerInterceptor实现原理与登录拦截类似但多看了HandlerMethod上的注解信息。完成这三点之后这个学校管理系统就不再是只能跑通的源码而是一个你能讲清楚每个决策的完整答辩项目。本文还有配套的精品资源点击获取