当前位置：首页 > news >正文

毕业设计可用的智慧社区全栈项目：SpringBoot后端+Vue前端+MySQL脚本+IDEA部署指南

news 2026/6/8 18:22:10

本文还有配套的精品资源，点击获取

简介：直接导入IDEA就能跑的智慧社区系统，后端用SpringBoot 2.x + MyBatis + JDK 1.8 + Maven 3.6，前端基于Vue CLI开发，数据库用MySQL 5.7，附带完整建表SQL和初始化数据。功能覆盖用户管理、物业报修、社区公告、门禁通行记录、访客预约登记等真实场景模块。项目结构规范，含标准src主代码目录、resources配置文件、test单元测试、pom.xml和mvnw构建脚本，还提供详细必读文档，一步步说明如何在IDEA中导入项目、配置MySQL连接、启动内嵌Tomcat、浏览器访问首页。所有模块均经本地调试验证，支持Chrome、Edge、Firefox主流浏览器。适合计算机、软件工程、信息管理等专业学生做课程设计、期末大作业或毕业设计，无需二次改造即可演示核心流程。

1. 项目概述：为什么这个智慧社区系统能成为毕业设计的“稳赢之选”

你是不是正在为毕业设计选题发愁？翻遍GitHub，要么是只有前端没后端的半成品，要么是功能堆砌但逻辑混乱、连数据库字段都对不上的“演示型项目”；要么就是文档缺失、环境配置像解谜游戏——装完JDK又卡在Maven镜像源，配好MySQL又发现驱动版本不兼容，最后花三天时间折腾环境，真正写业务代码只剩两天。我带过六届毕设，每年都有学生因为项目跑不起来，在答辩前一周临时换题，手忙脚乱拼凑PPT，结果答辩被老师一句“这个接口返回格式怎么和数据库字段不一致？”直接问懵。而眼前这套智慧社区系统，不是“看起来很美”的Demo，而是我亲手在三台不同配置的笔记本（i5-8250U/Win10、Ryzen5-4600H/Ubuntu20.04、M1 Mac/Big Sur）上逐行验证过的“毕业设计友好型”全栈工程。它用最主流、最稳妥的技术组合：SpringBoot 2.3.12.RELEASE + MyBatis 3.4.6 + Vue CLI 4.5.15 + MySQL 5.7.33，所有组件版本经过交叉测试，不存在“官网最新版反而跑不通”的坑。更关键的是，它把学生最头疼的“环境适配”问题，拆解成可执行、可回溯、可截图的标准化动作——比如MySQL配置，它不只告诉你填spring.datasource.url，而是明确指出：必须关闭validate-timeout、必须启用useSSL=false、必须设置serverTimezone=Asia/Shanghai，否则启动时控制台会刷屏报错，而错误日志里根本找不到这三行配置的蛛丝马迹。这不是一个“能跑就行”的项目，而是一个“跑得稳、改得清、讲得透、答得准”的教学级工程。它覆盖了用户角色分级（业主/物业/管理员）、真实业务闭环（访客预约→门禁授权→通行记录→超时提醒）、数据一致性保障（报修单状态变更触发消息通知），每个模块背后都有对应的教学价值点：用户管理练权限设计，报修模块练状态机与异步通知，门禁记录练高频写入优化，公告发布练缓存策略。如果你的目标是交一份让导师点头、答辩不卡壳、查重不踩雷的毕业设计，那么这套系统不是“可用”，而是“必选”——它省下的不是时间，是焦虑。

2. 整体架构设计与技术选型逻辑拆解

2.1 为什么锁定SpringBoot 2.x而非3.x？——兼容性与教学成本的平衡术

看到SpringBoot 3.x已成主流，你可能会疑惑：为何本项目坚持使用2.x？这不是“落后”吗？答案恰恰相反：这是针对毕业设计场景做出的精准取舍。SpringBoot 3.x强制要求JDK 17+，而国内高校实验室、学生个人电脑的主流JDK版本仍是1.8或11。我实测过：在一台预装JDK 1.8的实训机上强行升级到JDK 17，会导致IDEA部分插件失效、Maven本地仓库索引异常、甚至Tomcat 9无法识别新版本字节码。更隐蔽的坑在于依赖冲突——SpringBoot 3.x默认使用Jakarta EE 9命名空间（jakarta.servlet.*），而大量成熟中间件（如Shiro旧版、某些国产数据库驱动）仍停留在javax.servlet.*，强行迁移需手动修改数百处import，且极易遗漏。而SpringBoot 2.3.12.RELEASE完美兼容JDK 1.8，其内嵌Tomcat 9.0.52对Servlet 4.0的支持足够稳定，MyBatis 3.4.6与Spring 5.2.19.RELEASE的整合也经过千万级生产环境验证。更重要的是，2.x的自动配置原理（@ConditionalOnClass,@ConditionalOnMissingBean）比3.x的@AutoConfiguration更直观，学生调试时能清晰看到“为什么这个DataSource没创建”——是因为HikariCP类不在classpath，还是application.yml里漏写了spring.datasource.type？这种“可调试性”，对毕业设计阶段的理解深度至关重要。所以，这不是技术保守，而是把有限的学习精力，聚焦在业务逻辑而非框架迁移上。

2.2 Vue CLI 4.5.15：轻量、可控、无黑盒的前端选择

前端为何不用Vue 3 Composition API或Vite？理由很实在：降低认知负荷，提升调试确定性。Vue CLI 4.5.15基于Webpack 4，其构建流程（vue-cli-service serve→webpack-dev-server→hot-reload）每一步都可追踪、可打断点。当学生遇到“页面空白但控制台无报错”时，他可以打开node_modules/@vue/cli-service/lib/commands/serve.js，在createDevServer函数里加一行console.log('dev server starting...')，立刻确认是服务启动失败还是资源加载失败。而Vite的ESM动态导入、Vue 3的Proxy响应式机制，在调试时会产生大量底层调用栈，初学者极易迷失。此外，本项目前端采用经典的vue-router+vuex+axios组合，路由守卫（beforeEach）清晰控制登录态，Vuex Store分模块管理用户、报修、公告等状态，所有API请求统一走src/utils/request.js封装，拦截401跳转登录页、500弹出错误提示——这种结构化设计，让学生能快速理解“数据从哪来、到哪去、谁在管”。更重要的是，CLI 4.5.15生成的dist目录结构扁平（index.html,js/app.xxx.js,css/app.xxx.css），部署到Nginx时只需复制整个dist文件夹，无需理解base路径、public静态资源映射等Vite特有概念。对于需要向非技术导师演示的毕业设计，稳定压倒一切。

2.3 MySQL 5.7：拒绝“云原生幻觉”，回归本地可验证现实

数据库选用MySQL 5.7而非8.0或PostgreSQL，核心考量是本地可复现性。MySQL 5.7安装包仅150MB，Windows下双击mysql-installer-community-5.7.33.msi，勾选“Developer Default”，下一步到底即可完成安装，全程无需命令行。而MySQL 8.0默认开启caching_sha2_password认证插件，学生用Navicat连接时大概率遇到Client does not support authentication protocol requested by server错误，解决需执行ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY '123456';——这条命令本身就需要先连上数据库，形成死循环。PostgreSQL则面临更复杂的环境变量（PGDATA）、服务注册（pg_ctl register）问题。本项目的SQL脚本（sql/community_init.sql）严格遵循5.7语法：使用ENGINE=InnoDB DEFAULT CHARSET=utf8mb4而非8.0的utf8mb4_0900_ai_ci；外键约束显式声明ON DELETE CASCADE而非依赖FOREIGN_KEY_CHECKS=1；时间字段用DATETIME而非TIMESTAMP避免时区转换陷阱。所有建表语句均通过mysql -u root -p < community_init.sql一键执行，初始化数据包含20条模拟业主、5条物业人员、10条报修单、50条门禁记录——这些数据不是随机生成，而是按真实社区规模设计：业主手机号符合11位规则、报修地址含小区楼栋单元号、门禁时间戳精确到秒且跨度覆盖早中晚三个高峰时段。这种“所见即所得”的数据，能让答辩时的演示环节毫无破绽。

2.4 前后端分离的物理隔离设计：为什么不用Thymeleaf或JSP？

本项目坚决采用前后端分离，而非将Vue打包进SpringBoot的static目录用Thymeleaf渲染。原因在于职责清晰与调试解耦。当后端接口返回{"code":500,"msg":"数据库连接超时"}时，前端开发者只需关注axios.interceptors.response.use里的错误处理逻辑，无需排查Thymeleaf模板的th:if="${session.user}"是否因Session失效而渲染异常；反之，当Vue页面显示“加载中…”却无网络请求发出，问题必然在src/api/repair.js的getRepairList()方法，而非SpringBoot的@Controller层。这种隔离让毕业设计分工明确：学生A专注后端API开发（写RepairController.java、RepairService.java、RepairMapper.xml），学生B专注前端页面实现（写RepairList.vue、RepairForm.vue、repair.js），两人通过api/swagger-ui.html定义的接口契约协作，互不影响。更重要的是，分离架构天然支持跨域调试——前端npm run serve运行在http://localhost:8080，后端mvn spring-boot:run运行在http://localhost:8081，通过vue.config.js配置devServer.proxy将/api/**代理到后端，既避免了生产环境CORS问题，又让学生深刻理解“开发期代理”与“生产期Nginx反向代理”的区别。这种架构思维，远比学会写一个JSP页面更有教学价值。

3. 核心模块功能解析与业务逻辑深挖

3.1 用户管理模块：RBAC权限模型的轻量化落地

用户管理看似简单，却是整个系统安全基石。本项目未采用Shiro或Spring Security的完整权限框架，而是用轻量级RBAC（基于角色的访问控制）实现，既满足毕业设计复杂度要求，又避免学生陷入框架源码迷宫。核心设计体现在三张表：sys_user（用户基础信息）、sys_role（角色定义）、sys_user_role（用户-角色关联）。关键细节在于角色权限的粒度控制：系统预置三个角色——ROLE_OWNER（业主）、ROLE_PROPERTY（物业）、ROLE_ADMIN（超级管理员）。权限并非绑定到角色，而是通过sys_menu（菜单表）与sys_role_menu（角色-菜单关联表）实现。例如，业主只能看到“我的报修”、“访客预约”菜单，物业能看到“报修处理”、“门禁查询”，管理员则拥有全部菜单。后端校验逻辑在LoginController.java的login()方法中：用户登录成功后，根据username查询其角色列表，再通过roleIds查询所有可访问菜单URL（如/api/repair/list、/api/visitor/add），存入Redis缓存（key为user:menu:${userId}，过期时间2小时）。前端每次路由跳转前，router.beforeEach守卫会调用getMenuList()接口，对比当前路由to.path是否在返回的菜单URL数组中，若无权限则next('/403')。这种设计的好处是：学生能清晰看到“权限如何从数据库读取→缓存→前端校验”的完整链路，修改权限只需增删sys_role_menu表记录，无需重启服务。我特别提醒学生注意一个易错点：sys_menu表中component字段存储Vue组件路径（如views/repair/RepairList.vue），但该路径必须与src/router/index.js中component: () => import('@/views/repair/RepairList.vue')的路径完全一致，大小写、斜杠方向都不能错，否则路由懒加载会失败并静默白屏。

3.2 物业报修模块：状态机驱动的业务闭环

报修模块是检验系统业务深度的核心。它不是简单的CRUD，而是实现了五状态流转：待受理→已受理→处理中→已解决→已关闭。状态变更由RepairService.java中的updateStatus()方法驱动，该方法接收repairId和newStatus，但绝不允许非法跳转——例如，不能从待受理直接到已解决，必须经过已受理。状态校验逻辑如下：

public boolean updateStatus(Long repairId, Integer newStatus) { Repair repair = repairMapper.selectById(repairId); if (repair == null) return false; // 定义合法状态转移矩阵 Map<Integer, Set<Integer>> validTransitions = new HashMap<>(); validTransitions.put(RepairStatus.WAIT_ACCEPT.getCode(), Set.of(RepairStatus.ACCEPTED.getCode())); validTransitions.put(RepairStatus.ACCEPTED.getCode(), Set.of(RepairStatus.PROCESSING.getCode(), RepairStatus.CLOSED.getCode())); validTransitions.put(RepairStatus.PROCESSING.getCode(), Set.of(RepairStatus.RESOLVED.getCode(), RepairStatus.CLOSED.getCode())); validTransitions.put(RepairStatus.RESOLVED.getCode(), Set.of(RepairStatus.CLOSED.getCode())); Set<Integer> allowed = validTransitions.getOrDefault(repair.getStatus(), Collections.emptySet()); if (!allowed.contains(newStatus)) { throw new BusinessException("状态变更非法：" + repair.getStatus() + " → " + newStatus); } repair.setStatus(newStatus); repair.setUpdateTime(new Date()); return repairMapper.updateById(repair) > 0; }

这个设计让学生理解：真实业务中，状态不是随意切换的，而是受业务规则约束。当状态变为已解决时，系统自动触发NoticeService.sendNotice()发送站内信给报修业主，通知内容包含报修单号、处理结果、处理人姓名——这通过@Async注解实现异步通知，避免阻塞主业务线程。更进一步，RepairMapper.xml中<select>语句使用<where>动态SQL，支持按状态、报修时间范围、楼栋号多条件组合查询，<resultMap>精确映射Repair实体与数据库字段，连create_time到createTime的驼峰转换都通过configuration.setMapUnderscoreToCamelCase(true)全局配置，杜绝手动AS别名。这些细节，正是毕业设计答辩时老师追问“你怎么保证数据一致性？”“查询性能如何优化？”的底气所在。

3.3 访客预约模块：时效性与安全性的双重保障

访客预约是智慧社区最具实用价值的功能，也是最容易被忽略安全细节的模块。本项目设计了三重时效控制：预约有效期（默认7天）、门禁授权时效（预约成功后2小时内有效）、通行记录留存（永久保存）。核心逻辑在VisitorController.java的addVisitor()方法：

@PostMapping("/add") public Result addVisitor(@RequestBody Visitor visitor) { // 1. 校验业主是否存在且状态正常 User owner = userMapper.selectById(visitor.getOwnerId()); if (owner == null || !owner.getStatus().equals(UserStatus.NORMAL.getCode())) { return Result.fail("业主不存在或已禁用"); } // 2. 校验预约时间：不能早于当前时间，不能晚于7天后 Date now = new Date(); if (visitor.getVisitTime().before(now) || visitor.getVisitTime().after(DateUtils.addDays(now, 7))) { return Result.fail("预约时间必须在当前时间至7天内"); } // 3. 生成唯一预约码（6位数字，防碰撞） String code = RandomStringUtils.randomNumeric(6); while (visitorMapper.selectCount(new QueryWrapper<Visitor>().eq("code", code)) > 0) { code = RandomStringUtils.randomNumeric(6); } visitor.setCode(code); // 4. 设置门禁授权时效：预约时间前30分钟至后90分钟 visitor.setAuthStartTime(DateUtils.addMinutes(visitor.getVisitTime(), -30)); visitor.setAuthEndTime(DateUtils.addMinutes(visitor.getVisitTime(), 90)); visitor.setCreateTime(now); visitor.setStatus(VisitorStatus.WAITING.getCode()); visitorMapper.insert(visitor); return Result.success(visitor.getId()); }

这里的关键是AuthStartTime和AuthEndTime的计算——它确保访客只能在约定时间窗口内刷脸/扫码通行，超出即失效。而code字段作为访客通行凭证，被打印在预约成功页，物业人员在门禁终端输入此码即可临时授权。前端VisitorAdd.vue表单中，visitTime使用el-date-picker组件，type="datetime"并设置picker-options限制可选日期范围（disabledDate: time => time.getTime() < Date.now() - 86400000），从源头杜绝非法时间提交。这种“后端强校验+前端友好提示”的组合，让学生掌握Web开发中安全与体验的平衡艺术。

3.4 门禁记录模块：高频写入的性能应对策略

门禁记录是系统写入压力最大的模块，每台门禁设备每秒可能产生多条通行记录。若直接INSERT INTO access_log (...) VALUES (...)，高并发下MySQL极易出现锁等待甚至死锁。本项目采用批量插入+异步落库策略。前端门禁终端（模拟为HTTP客户端）调用/api/access/log/batch接口，传入JSON数组：

[ {"deviceId":"DEV-001","cardNo":"CARD-123456","accessTime":"2023-10-01 08:02:15","status":1}, {"deviceId":"DEV-002","cardNo":"CARD-654321","accessTime":"2023-10-01 08:02:16","status":1} ]

后端AccessLogController.java接收后，不立即入库，而是将数据放入内存队列（ConcurrentLinkedQueue<AccessLog>），由独立线程池（@Scheduled(fixedDelay = 1000)）每秒消费一次队列，执行批量插入：

@Scheduled(fixedDelay = 1000) public void batchInsertLogs() { List<AccessLog> logs = new ArrayList<>(); AccessLog log; while ((log = logQueue.poll()) != null) { logs.add(log); if (logs.size() >= 100) break; // 达到100条或队列空则执行 } if (!logs.isEmpty()) { accessLogMapper.insertBatch(logs); // 自定义批量插入Mapper } }

insertBatch方法在AccessLogMapper.xml中使用<foreach>标签生成INSERT INTO ... VALUES (),(),()语句，单次插入100条，相比逐条插入性能提升10倍以上。同时，access_log表按access_time字段建立分区（PARTITION BY RANGE (TO_DAYS(access_time))），每月一个分区，避免单表数据膨胀影响查询。这些设计让学生明白：毕业设计不只是功能实现，更是对真实场景（高并发、大数据量）的初步应对思考。

4. IDEA全流程部署实操指南：从零到首页访问的每一步

4.1 环境准备：JDK 1.8与Maven 3.6的精准匹配

部署第一步，是确保基础环境“严丝合缝”。很多学生失败，源于JDK与Maven的版本错配。本项目要求JDK 1.8.0_202及以上，Maven 3.6.3。为什么不是最新版？因为Maven 3.6.3的maven-compiler-plugin默认source和target为1.8，与SpringBoot 2.3.12.RELEASE的编译要求完全一致。若使用Maven 3.8+，其内置的maven-compiler-plugin版本为3.8.1，需在pom.xml中显式指定：

<plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-compiler-plugin</artifactId> <version>3.8.1</version> <configuration> <source>1.8</source> <target>1.8</target> </configuration> </plugin>

而本项目pom.xml已预置此配置，故推荐使用Maven 3.6.3。安装步骤：
1. 下载JDK 1.8.0_202（Oracle官网或国内镜像站），安装路径不含中文和空格（如C:\Java\jdk1.8.0_202）；
2. 配置系统环境变量：JAVA_HOME=C:\Java\jdk1.8.0_202，PATH=%JAVA_HOME%\bin；
3. 下载Maven 3.6.3二进制包，解压到C:\Maven\apache-maven-3.6.3；
4. 配置MAVEN_HOME=C:\Maven\apache-maven-3.6.3，PATH=%MAVEN_HOME%\bin；
5. 打开CMD，执行java -version与mvn -v，确认输出均为预期版本。

提示：若mvn -v报错The JAVA_HOME environment variable is not defined correctly，检查%MAVEN_HOME%\bin\mvn.cmd第123行，确保set JAVA_HOME=%JAVA_HOME:~0,-1%未被意外修改——这是Windows批处理常见陷阱。

4.2 IDEA导入项目：破解mvnw与pom.xml的协同密码

将项目压缩包解压后，不要双击pom.xml用IDEA打开！正确姿势是：
1. 启动IDEA，选择Open（非Import Project），定位到解压后的根目录（含pom.xml、src、mvnw的文件夹）；
2. IDEA会自动识别为Maven项目，勾选Create project from existing sources；
3. 在Maven设置页，Maven home directory选择你安装的C:\Maven\apache-maven-3.6.3，User settings file保持默认（%USER_HOME%\.m2\settings.xml），Local repository可自定义为D:\MavenRepo（避免C盘爆满）；
4. 关键一步：勾选Import Maven projects automatically，并确保Runner页的Delegate IDE build/run actions to Maven被勾选——这确保IDEA的Run按钮实际执行mvn spring-boot:run，而非IDEA自带编译器。

此时，IDEA右下角会显示Importing 'xxx' Maven project，开始下载依赖。由于项目使用阿里云Maven镜像（pom.xml中<mirror>配置），下载速度极快。若卡在Downloading from aliyunmaven，检查settings.xml中<mirrorOf>*</mirrorOf>是否被其他镜像覆盖。下载完成后，Project面板应显示标准Maven结构：src/main/java（Java源码）、src/main/resources（配置文件）、src/test/java（测试代码）、pom.xml（依赖清单）。

4.3 MySQL配置：application.yml中的生死三参数

数据库配置是启动失败的最高发区。打开src/main/resources/application.yml，找到spring:节点下的datasource:配置段：

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

这里必须修改的三个参数是：
-url中的community_db：需提前在MySQL中创建同名数据库（CREATE DATABASE community_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;）；
-username和password：替换为你MySQL的实际账号密码（若未修改，默认为root/123456）；
-driver-class-name：MySQL 5.7必须用com.mysql.cj.jdbc.Driver（注意cj），而非旧版com.mysql.jdbc.Driver，否则启动报ClassNotFoundException。

注意：useSSL=false必须显式声明，否则MySQL 5.7默认要求SSL连接，而本地开发环境通常未配置SSL证书，导致连接超时；serverTimezone=Asia/Shanghai解决中国时区问题，避免数据库时间比系统时间慢8小时。

配置完成后，在IDEA右侧Maven面板，展开Plugins→spring-boot→ 双击spring-boot:run，等待控制台输出Started CommunityApplication in X.XXX seconds，即启动成功。

4.4 前端启动：Vue CLI的端口代理与跨域穿透

后端启动后，启动前端：
1. 打开命令行（推荐Git Bash或Windows Terminal），cd进入项目根目录下的src/main/frontend（或frontend，具体看目录结构）；
2. 执行npm install安装依赖（首次需约2分钟）；
3. 修改vue.config.js中的devServer.proxy配置，确保指向后端地址：

devServer: { port: 8080, proxy: { '/api': { target: 'http://localhost:8081', // 必须与后端启动端口一致 changeOrigin: true, pathRewrite: { '^/api': '/api' } } } }

执行npm run serve，等待输出App running at: http://localhost:8080；
浏览器访问http://localhost:8080，若看到智慧社区Logo及登录页，则前端启动成功。

此时，前端所有/api/**请求（如/api/user/login）将被代理到http://localhost:8081/api/**，完美规避跨域问题。若访问白屏，打开浏览器开发者工具（F12），查看Console是否有Failed to load resource错误，若有，检查Network标签页中请求URL是否为http://localhost:8080/api/user/login（代理前）而非http://localhost:8081/api/user/login（代理后）——这说明proxy配置未生效，需重启npm run serve。

5. 常见问题排查与独家避坑技巧实录

5.1 启动报错“Failed to configure a DataSource”：配置文件位置与优先级陷阱

这是新手最高频问题。错误日志末尾常带Consider the following: If you want an embedded database (H2, HSQL or Derby), please put it on the classpath.，误导学生去添加H2依赖。真相是：application.yml未被正确加载。排查步骤：
1. 检查src/main/resources目录下是否存在application.yml（而非application.properties或application.yaml）；
2. 检查application.yml中spring:缩进是否为2个空格（YAML对缩进敏感，Tab键或4空格均会解析失败）；
3. 检查pom.xml中<packaging>是否为jar（本项目是jar包，非war），若误设为war，IDEA可能尝试部署到外部Tomcat，导致资源配置路径错误；
4. 在CommunityApplication.java的main方法首行添加System.out.println("Active profiles: " + Arrays.toString(env.getActiveProfiles()));，确认是否加载了dev配置文件。

实操心得：我曾帮一位学生解决此问题，最终发现他把application.yml放在了src/main/java下——IDEA默认只将resources目录加入classpath，java目录下的文件会被忽略。移动文件后，瞬间启动成功。

5.2 登录后页面空白：“路由守卫”与“菜单权限”的隐性冲突

登录成功返回token，但跳转到/dashboard后一片空白，控制台无报错。这通常是前端路由权限校验失败。排查链路：
- 前端：打开src/router/index.js，确认router.beforeEach守卫中store.dispatch('user/getMenuList')是否被正确调用；
- 后端：检查UserController.java的getMenuList()方法，确认其SQL查询sys_role_menu表时，role_id是否从当前用户user.getRoleId()正确获取；
- 数据库：执行SELECT * FROM sys_role_menu WHERE role_id = (SELECT role_id FROM sys_user WHERE username = 'admin');，确认返回非空结果集。

独家技巧：在getMenuList()方法中添加日志log.info("Querying menus for userId: {}, roleId: {}", userId, roleId);，启动时观察控制台是否输出该日志——若无输出，说明守卫未触发；若有输出但返回空数组，检查数据库sys_role_menu表中role_id值是否与sys_user表中role_id匹配（常见错误：sys_user.role_id存的是字符串"1"，而sys_role_menu.role_id是数字1，导致JOIN失败）。

5.3 报修图片上传失败：“multipart/form-data”与Nginx的边界之战

项目支持报修时上传图片，但学生反馈点击“选择文件”后无反应，或上传后后端@RequestParam MultipartFile file为null。根源在于SpringBoot文件上传配置缺失。需在application.yml中追加：

spring: servlet: context-path: /community http: multipart: max-file-size: 10MB max-request-size: 10MB enabled: true

context-path设置为/community，确保前后端API路径统一（前端axios.defaults.baseURL = '/community'）。若使用Nginx反向代理，还需在Nginx配置中增加：

client_max_body_size 10M;

否则Nginx会拦截大于1MB的请求，返回413 Request Entity Too Large。

5.4 门禁记录查询缓慢：索引缺失的性能雪崩

当门禁记录超过10万条，SELECT * FROM access_log WHERE device_id = 'DEV-001' ORDER BY access_time DESC LIMIT 20查询耗时超5秒。解决方案是添加复合索引：

ALTER TABLE access_log ADD INDEX idx_device_time (device_id, access_time);

该索引覆盖查询条件device_id和排序字段access_time，使查询从全表扫描降为索引范围扫描。执行后，相同查询降至50ms内。此案例让学生直观理解：数据库优化不是玄学，而是基于执行计划（EXPLAIN SELECT ...）的精准手术。

6. 毕业设计扩展建议：从“能跑”到“亮眼”的跃迁路径

这套系统已足够支撑毕业设计答辩，但若想脱颖而出，可基于现有架构做三类低成本高回报扩展：
1.可视化增强：集成ECharts，在Dashboard.vue中添加“本月报修类型分布饼图”、“各楼栋通行热度地图”。只需在package.json中添加"echarts": "^4.9.0"，main.js中import * as echarts from 'echarts'并Vue.prototype.$echarts = echarts，后端提供/api/statistics/repair-type接口返回JSON数据即可。图表交互感强，答辩时老师一眼就能看到工作量。
2.消息推送升级：将站内信通知扩展为微信模板消息。申请微信公众号测试号，后端NoticeService中增加sendWechatTemplate()方法，调用微信API发送。此扩展涉及第三方API调用，体现学生整合能力，且微信通知比站内信更贴近真实场景。
3.移动端适配：利用Vue CLI的cordova插件，将前端打包为Android APK。vue add cordova后，修改config.xml配置应用名称、图标，执行npm run cordova-build-android生成APK。虽为演示性质，但“手机扫码安装APP”的演示效果，远胜于“打开Chrome访问网页”。