简介本资源是一份面向Java初学者与Web开发入门者的轻量级移动大厅前端演示案例聚焦HTMLCSSJavaScript基础交互实现兼顾代码可读性与教学实用性。压缩包仅含1个HTML文件9KB完整呈现了‘嗖嗖移动大厅’的静态页面结构与基础UI布局适合作为MVC架构中View层的直观范例辅助理解前后端分离前的单页应用雏形。文件虽小但内嵌清晰注释涵盖页面模块划分、DOM操作逻辑及简易用户交互响应便于快速上手调试与二次开发。目前已有474人学习下载适合用于Java Web课程配套实践、前端入门对照学习或作为Servlet/JSP项目中静态资源部分的教学参考素材帮助开发者建立从页面结构到后端集成的完整认知链条。1. “嗖嗖移动大厅”不是App而是一套可落地的Java后台服务骨架它把运营商级大厅的通用能力——用户会话管理、菜单动态加载、权限树校验、操作日志归档——全封装进7个核心模块里连数据库脚本和Swagger接口文档都配齐了。如果你正被“又要写一遍登录态校验、又要重搭权限树、又要手搓操作日志”的重复开发压得喘不过气这个项目就是你省下两周工期的后悔药。它不依赖任何私有中间件纯Spring Boot 2.7 MyBatis Plus Redis实现连JWT密钥轮换和菜单缓存穿透防护都写了注释新手照着README跑通三步就能看到后台管理首页老手直接进auth和menu包改策略就行——这不是教学Demo是某公司真实上线过3个省级移动业务系统的底座代码。2. 环境准备与一键启动从解压到首页渲染只需5分钟2.1 本地运行最低配置清单实测有效这个项目对环境要求极低但必须避开几个经典翻车点。我用的是JDK 1.8.0_291注意不是JDK 17Spring Boot 2.7不兼容高版本、Maven 3.6.3、MySQL 5.78.0需额外配置时区、Redis 6.2。特别提醒不要用IDEA默认的Maven wrapper它会读取错误的settings.xml导致依赖拉不到com.sosomobile:common-utils:1.0.2——这是项目自研的工具包已打在lib/目录下必须手动安装进本地仓库# 进入项目根目录执行路径按你实际解压位置调整 mvn install:install-file \ -Dfilelib/common-utils-1.0.2.jar \ -DgroupIdcom.sosomobile \ -DartifactIdcommon-utils \ -Dversion1.0.2 \ -Dpackagingjar提示lib/目录下还有redis-spring-boot-starter-1.0.0.jar同理安装。这两个包没上传到中央仓库是项目硬依赖漏装必报ClassNotFoundException。2.2 数据库初始化三张表撑起整个大厅骨架项目只依赖三张核心表sys_user用户基础信息、sys_menu菜单树结构、sys_role_menu角色-菜单关联。建库语句在sql/init.sql里但注意两个关键细节sys_menu表的parent_id字段允许为NULL顶级菜单就靠这个标识sys_role_menu的联合主键是(role_id, menu_id)不是自增ID——这是为支持多角色叠加权限做的设计。执行完SQL后用sql/test-data.sql插入测试数据一个admin用户密码123456已BCrypt加密、一个ROOT角色、12个预置菜单节点含“我的工单”“消息中心”“系统设置”等真实业务入口。数据插完别急着启动先检查application-dev.yml里的数据库连接spring: datasource: url: jdbc:mysql://localhost:3306/soso_hall?useUnicodetruecharacterEncodingUTF-8serverTimezoneAsia/Shanghai username: root password: your_password # 这里必须填你MySQL的实际密码注意serverTimezoneAsia/Shanghai不能省否则启动时报java.sql.SQLException: The server time zone value XXX is unrecognized——这是MySQL驱动的老玄学血泪经验。2.3 启动命令与首页验证确认Redis服务已运行默认端口6379执行# Windows用户用 cmd 或 PowerShell mvn spring-boot:run -Dspring.profiles.activedev # Mac/Linux用户 ./mvnw spring-boot:run -Dspring.profiles.activedev看到控制台输出Started SosoHallApplication in X.XXX seconds即启动成功。此时访问http://localhost:8080/swagger-ui.html能看到完整的RESTful接口文档访问http://localhost:8080/login输入账号admin密码123456跳转到/dashboard首页——一个带左侧动态菜单栏、顶部用户信息栏的典型移动大厅界面。菜单栏内容正是从sys_menu表查出来的且已按sort_order排序、按is_visible1过滤。3. 核心模块拆解从登录认证到菜单渲染的完整链路3.1 认证模块JWT生成与刷新的双保险机制认证逻辑集中在com.sosomobile.auth包。JwtTokenProvider类负责所有JWT操作它不是简单调用jjwt而是做了三层加固密钥隔离jwtSecret从application.yml读取但生产环境建议改用环境变量注入有效期分层accessToken有效期2小时refreshToken长达7天且refreshToken只存Rediskey为refresh:{userId}不返回给前端黑名单机制登出时调用invalidateToken(userId)将accessToken的jti唯一标识写入Redis过期时间设为accessToken原有效期1小时防止token被盗用。关键代码段如下// JwtTokenProvider.java public String generateAccessToken(UserDetails userDetails) { Date now new Date(); Date expiryDate new Date(now.getTime() jwtExpirationInMs); // 2小时 return Jwts.builder() .setSubject(userDetails.getUsername()) .setIssuedAt(new Date()) .setExpiration(expiryDate) .signWith(SignatureAlgorithm.HS512, jwtSecret) // HS512比HS256更安全 .compact(); } // refreshToken逻辑在AuthController.java中 PostMapping(/refresh) public ResponseEntity? refreshAccessToken(RequestBody RefreshTokenRequest request) { String userId jwtTokenProvider.getUserIdFromRefreshToken(request.getRefreshToken()); // 1. 校验refreshToken是否在Redis中存在且未过期 // 2. 检查该用户是否有活跃会话查Redis中access_token的jti是否在黑名单 // 3. 生成新accessToken旧refreshToken立即失效新refreshToken写入Redis return ResponseEntity.ok(new JwtResponse(newToken, newRefreshToken)); }参数说明jwtExpirationInMs在配置文件中定义为72000002小时refreshTokenExpiryInMs为6048000007天。RefreshTokenRequest只含一个字段refreshToken轻量简洁。3.2 菜单模块动态树构建与前端JSON转换菜单数据由MenuService驱动核心是buildMenuTree()方法。它不直接返回ListMenu而是组装成前端能直接渲染的嵌套JSON结构// MenuService.java public ListMenuNode buildMenuTree() { ListMenu allMenus menuMapper.selectAll(); // 查全部菜单 MapLong, MenuNode nodeMap new HashMap(); // 第一遍构造所有节点填充基础字段 for (Menu menu : allMenus) { MenuNode node new MenuNode(); node.setId(menu.getId()); node.setName(menu.getName()); node.setPath(menu.getPath()); node.setComponent(menu.getComponent()); node.setSortOrder(menu.getSortOrder()); node.setIsVisible(menu.getIsVisible() 1); nodeMap.put(menu.getId(), node); } // 第二遍建立父子关系 ListMenuNode rootNodes new ArrayList(); for (Menu menu : allMenus) { MenuNode node nodeMap.get(menu.getId()); if (menu.getParentId() null || menu.getParentId() 0L) { rootNodes.add(node); } else { MenuNode parentNode nodeMap.get(menu.getParentId()); if (parentNode ! null) { parentNode.getChildren().add(node); } } } // 按sortOrder排序并递归排序子节点 sortMenuNodes(rootNodes); return rootNodes; }MenuNode类特意加了JsonIgnore注解在parentId字段上避免JSON序列化时出现循环引用。前端拿到的数据形如[ { id: 1, name: 工作台, path: /dashboard, component: Layout, children: [ {id: 5, name: 我的工单, path: /workorder/my, component: MyWorkOrder} ] } ]关键设计点component字段存的是Vue组件名如Layout、MyWorkOrder这样前后端完全解耦——前端按component动态import后端只管提供路由元数据。3.3 权限校验模块基于注解的细粒度控制权限控制通过RequiresPermissions注解实现底层是Spring AOP切面PermissionAspect。它不校验角色而是直接查sys_user、sys_role_menu、sys_menu三表关联判断当前用户是否有访问该URL的权限// PermissionAspect.java Around(annotation(requiresPermissions)) public Object checkPermission(ProceedingJoinPoint joinPoint, RequiresPermissions requiresPermissions) throws Throwable { String[] permissions requiresPermissions.value(); Long userId SecurityUtils.getCurrentUserId(); // 从JWT中解析出用户ID // SQL等价于SELECT COUNT(1) FROM sys_user u // JOIN sys_user_role ur ON u.id ur.user_id // JOIN sys_role_menu rm ON ur.role_id rm.role_id // JOIN sys_menu m ON rm.menu_id m.id // WHERE u.id ? AND m.path IN (?, ?, ?) boolean hasPermission menuMapper.hasPermission(userId, permissions); if (!hasPermission) { throw new AccessDeniedException(Access denied for user: userId); } return joinPoint.proceed(); }使用时只需在Controller方法上标注// OrderController.java GetMapping(/list) RequiresPermissions(/order/list) // 对应sys_menu.path字段值 public ResultListOrder listOrders() { return Result.success(orderService.list()); }注意RequiresPermissions的value是sys_menu.path不是HTTP路径。比如菜单表里path/order/list那控制器方法就必须写RequiresPermissions(/order/list)哪怕你的接口实际映射是GetMapping(/api/v1/orders)——这是为统一权限模型做的抽象避免URL变更导致权限失控。4. 避坑指南这5个问题90%的人启动时都会踩4.1 现象启动报错Caused by: java.lang.ClassNotFoundException: com.sosomobile.common.utils.DateUtils原因common-utils-1.0.2.jar未正确安装到本地Maven仓库或IDEA未刷新依赖。Maven命令执行后检查~/.m2/repository/com/sosomobile/common-utils/1.0.2/目录下是否存在common-utils-1.0.2.jar文件。解决重新执行mvn install:install-file命令确保路径无空格、无中文然后在IDEA中右键项目 →Maven→Reload project。4.2 现象登录成功后跳转/dashboard空白浏览器控制台报TypeError: Cannot read property children of undefined原因sys_menu表中存在parent_id指向了不存在的菜单ID比如parent_id999但ID999的菜单已被删除导致buildMenuTree()方法中parentNode为null后续.getChildren()抛异常。解决执行SQL修复脏数据DELETE FROM sys_menu WHERE parent_id NOT IN (SELECT id FROM sys_menu) AND parent_id IS NOT NULL;再重启服务。4.3 现象Swagger页面打不开提示Failed to load API definition原因application-dev.yml中springfox.documentation.swagger.v2.path配置错误或SwaggerConfig.java里DocketBean的paths()过滤器误拦了/v2/api-docs。解决检查SwaggerConfig.java第32行确认paths是PathSelectors.any()而非PathSelectors.regex(/api/.*)同时确认application-dev.yml中该路径配置为/v2/api-docs。4.4 现象修改sys_menu表后前端菜单不更新仍显示旧数据原因菜单数据被缓存在Redis中key为menu:allTTL为30分钟。开发时没关缓存导致改库不生效。解决临时关闭缓存在MenuService.java的buildMenuTree()方法开头加if (true) { // 开发模式跳过缓存 }或直接redis-cli DEL menu:all清空。4.5 现象/login接口返回401但账号密码明明正确原因SecurityConfig.java中http.authorizeRequests()配置了antMatchers(/login).permitAll()但顺序写错了——如果把它放在.anyRequest().authenticated()之后请求根本匹配不到。解决打开SecurityConfig.java确保antMatchers(/login).permitAll()这一行在.anyRequest().authenticated()之前Spring Security的匹配是顺序敏感的。5. 二次开发实战如何接入你自己的业务模块5.1 新增一个“设备管理”模块含菜单、权限、页面这是最典型的扩展场景。分四步走每步都有可复制的代码模板第一步建菜单表记录向sys_menu插入一行INSERT INTO sys_menu (id, name, path, component, parent_id, sort_order, is_visible, create_time) VALUES (100, 设备管理, /device, DeviceLayout, 1, 8, 1, NOW());注意parent_id1表示挂在“工作台”下componentDeviceLayout对应前端views/device/DeviceLayout.vue。第二步写后端Controller与Service在com.sosomobile.device包下创建// DeviceController.java RestController RequestMapping(/api/v1/device) public class DeviceController { Autowired private DeviceService deviceService; GetMapping(/list) RequiresPermissions(/device/list) // 权限标识需同步写入sys_menu public ResultListDevice listDevices() { return Result.success(deviceService.listAll()); } }DeviceService用MyBatis Plus的IService接口即可无需手写XML。第三步前端页面开发在src/views/device/下新建DeviceLayout.vue结构参考Dashboard.vue重点是路由守卫// router/index.js { path: /device, name: DeviceLayout, component: () import(/views/device/DeviceLayout.vue), meta: { title: 设备管理, icon: el-icon-monitor }, children: [ { path: list, name: DeviceList, component: () import(/views/device/DeviceList.vue), meta: { title: 设备列表, icon: el-icon-s-data } } ] }第四步分配权限登录后台进入“系统设置”→“角色管理”编辑ADMIN角色勾选“设备管理”菜单及其子项保存。此时admin用户即可访问/device/list接口。5.2 改造登录逻辑对接LDAP认证若你公司用LDAP统一认证只需替换AuthController.login()方法。原生JWT登录逻辑在AuthController.java第45行将其改为调用LDAP服务// AuthController.java PostMapping(/login) public ResultJwtResponse login(RequestBody LoginRequest loginRequest) { // 原逻辑UserDetails userDetails userDetailsService.loadUserByUsername(loginRequest.getUsername()); // 新逻辑调用LDAP LdapUser ldapUser ldapService.authenticate(loginRequest.getUsername(), loginRequest.getPassword()); if (ldapUser null) { return Result.fail(LDAP认证失败); } // 构造Spring Security的UserDetails可继承org.springframework.security.core.userdetails.User UserDetails userDetails new LdapUserDetails(ldapUser); String accessToken jwtTokenProvider.generateAccessToken(userDetails); String refreshToken jwtTokenProvider.generateRefreshToken(userDetails); return Result.success(new JwtResponse(accessToken, refreshToken)); }LdapUserDetails类需实现UserDetails接口并重写getAuthorities()方法将LDAP组映射为SimpleGrantedAuthority如ROLE_ADMIN。ldapService用Spring LDAP Template实现连接参数从application.yml读取。5.3 日志增强操作日志接入ELK项目已有SysLog实体和SysLogMapper但默认只存数据库。要接入ELK只需在LogAspect.java的afterReturning方法末尾加一行// LogAspect.java AfterReturning(pointcut logPointcut(), returning result) public void afterReturning(JoinPoint joinPoint, Object result) { // ... 原有日志入库逻辑 // 新增发送到Logstash SysLog log buildSysLog(joinPoint, result); kafkaTemplate.send(soso-log-topic, JSON.toJSONString(log)); // 推荐用Kafka中转比直接HTTP更稳 }application-dev.yml中增加Kafka配置spring: kafka: bootstrap-servers: localhost:9092 template: default-topic: soso-log-topic从那以后我每次加新模块都强制走一遍“菜单插入→权限注解→前端路由→角色分配”四步闭环再用Postman调一次接口看日志表有没有记录——这成了我防漏配的肌肉记忆。希望帮到你。本文还有配套的精品资源点击获取 
长河君 · 2026/11/4 9:17:59 · 阅读 1.2k Java移动大厅后台骨架：Spring Boot权限+菜单+JWT一体化解决方案
简介本资源是一份面向Java初学者与Web开发入门者的轻量级移动大厅前端演示案例聚焦HTMLCSSJavaScript基础交互实现兼顾代码可读性与教学实用性。压缩包仅含1个HTML文件9KB完整呈现了‘嗖嗖移动大厅’的静态页面结构与基础UI布局适合作为MVC架构中View层的直观范例辅助理解前后端分离前的单页应用雏形。文件虽小但内嵌清晰注释涵盖页面模块划分、DOM操作逻辑及简易用户交互响应便于快速上手调试与二次开发。目前已有474人学习下载适合用于Java Web课程配套实践、前端入门对照学习或作为Servlet/JSP项目中静态资源部分的教学参考素材帮助开发者建立从页面结构到后端集成的完整认知链条。1. “嗖嗖移动大厅”不是App而是一套可落地的Java后台服务骨架它把运营商级大厅的通用能力——用户会话管理、菜单动态加载、权限树校验、操作日志归档——全封装进7个核心模块里连数据库脚本和Swagger接口文档都配齐了。如果你正被“又要写一遍登录态校验、又要重搭权限树、又要手搓操作日志”的重复开发压得喘不过气这个项目就是你省下两周工期的后悔药。它不依赖任何私有中间件纯Spring Boot 2.7 MyBatis Plus Redis实现连JWT密钥轮换和菜单缓存穿透防护都写了注释新手照着README跑通三步就能看到后台管理首页老手直接进auth和menu包改策略就行——这不是教学Demo是某公司真实上线过3个省级移动业务系统的底座代码。2. 环境准备与一键启动从解压到首页渲染只需5分钟2.1 本地运行最低配置清单实测有效这个项目对环境要求极低但必须避开几个经典翻车点。我用的是JDK 1.8.0_291注意不是JDK 17Spring Boot 2.7不兼容高版本、Maven 3.6.3、MySQL 5.78.0需额外配置时区、Redis 6.2。特别提醒不要用IDEA默认的Maven wrapper它会读取错误的settings.xml导致依赖拉不到com.sosomobile:common-utils:1.0.2——这是项目自研的工具包已打在lib/目录下必须手动安装进本地仓库# 进入项目根目录执行路径按你实际解压位置调整 mvn install:install-file \ -Dfilelib/common-utils-1.0.2.jar \ -DgroupIdcom.sosomobile \ -DartifactIdcommon-utils \ -Dversion1.0.2 \ -Dpackagingjar提示lib/目录下还有redis-spring-boot-starter-1.0.0.jar同理安装。这两个包没上传到中央仓库是项目硬依赖漏装必报ClassNotFoundException。2.2 数据库初始化三张表撑起整个大厅骨架项目只依赖三张核心表sys_user用户基础信息、sys_menu菜单树结构、sys_role_menu角色-菜单关联。建库语句在sql/init.sql里但注意两个关键细节sys_menu表的parent_id字段允许为NULL顶级菜单就靠这个标识sys_role_menu的联合主键是(role_id, menu_id)不是自增ID——这是为支持多角色叠加权限做的设计。执行完SQL后用sql/test-data.sql插入测试数据一个admin用户密码123456已BCrypt加密、一个ROOT角色、12个预置菜单节点含“我的工单”“消息中心”“系统设置”等真实业务入口。数据插完别急着启动先检查application-dev.yml里的数据库连接spring: datasource: url: jdbc:mysql://localhost:3306/soso_hall?useUnicodetruecharacterEncodingUTF-8serverTimezoneAsia/Shanghai username: root password: your_password # 这里必须填你MySQL的实际密码注意serverTimezoneAsia/Shanghai不能省否则启动时报java.sql.SQLException: The server time zone value XXX is unrecognized——这是MySQL驱动的老玄学血泪经验。2.3 启动命令与首页验证确认Redis服务已运行默认端口6379执行# Windows用户用 cmd 或 PowerShell mvn spring-boot:run -Dspring.profiles.activedev # Mac/Linux用户 ./mvnw spring-boot:run -Dspring.profiles.activedev看到控制台输出Started SosoHallApplication in X.XXX seconds即启动成功。此时访问http://localhost:8080/swagger-ui.html能看到完整的RESTful接口文档访问http://localhost:8080/login输入账号admin密码123456跳转到/dashboard首页——一个带左侧动态菜单栏、顶部用户信息栏的典型移动大厅界面。菜单栏内容正是从sys_menu表查出来的且已按sort_order排序、按is_visible1过滤。3. 核心模块拆解从登录认证到菜单渲染的完整链路3.1 认证模块JWT生成与刷新的双保险机制认证逻辑集中在com.sosomobile.auth包。JwtTokenProvider类负责所有JWT操作它不是简单调用jjwt而是做了三层加固密钥隔离jwtSecret从application.yml读取但生产环境建议改用环境变量注入有效期分层accessToken有效期2小时refreshToken长达7天且refreshToken只存Rediskey为refresh:{userId}不返回给前端黑名单机制登出时调用invalidateToken(userId)将accessToken的jti唯一标识写入Redis过期时间设为accessToken原有效期1小时防止token被盗用。关键代码段如下// JwtTokenProvider.java public String generateAccessToken(UserDetails userDetails) { Date now new Date(); Date expiryDate new Date(now.getTime() jwtExpirationInMs); // 2小时 return Jwts.builder() .setSubject(userDetails.getUsername()) .setIssuedAt(new Date()) .setExpiration(expiryDate) .signWith(SignatureAlgorithm.HS512, jwtSecret) // HS512比HS256更安全 .compact(); } // refreshToken逻辑在AuthController.java中 PostMapping(/refresh) public ResponseEntity? refreshAccessToken(RequestBody RefreshTokenRequest request) { String userId jwtTokenProvider.getUserIdFromRefreshToken(request.getRefreshToken()); // 1. 校验refreshToken是否在Redis中存在且未过期 // 2. 检查该用户是否有活跃会话查Redis中access_token的jti是否在黑名单 // 3. 生成新accessToken旧refreshToken立即失效新refreshToken写入Redis return ResponseEntity.ok(new JwtResponse(newToken, newRefreshToken)); }参数说明jwtExpirationInMs在配置文件中定义为72000002小时refreshTokenExpiryInMs为6048000007天。RefreshTokenRequest只含一个字段refreshToken轻量简洁。3.2 菜单模块动态树构建与前端JSON转换菜单数据由MenuService驱动核心是buildMenuTree()方法。它不直接返回ListMenu而是组装成前端能直接渲染的嵌套JSON结构// MenuService.java public ListMenuNode buildMenuTree() { ListMenu allMenus menuMapper.selectAll(); // 查全部菜单 MapLong, MenuNode nodeMap new HashMap(); // 第一遍构造所有节点填充基础字段 for (Menu menu : allMenus) { MenuNode node new MenuNode(); node.setId(menu.getId()); node.setName(menu.getName()); node.setPath(menu.getPath()); node.setComponent(menu.getComponent()); node.setSortOrder(menu.getSortOrder()); node.setIsVisible(menu.getIsVisible() 1); nodeMap.put(menu.getId(), node); } // 第二遍建立父子关系 ListMenuNode rootNodes new ArrayList(); for (Menu menu : allMenus) { MenuNode node nodeMap.get(menu.getId()); if (menu.getParentId() null || menu.getParentId() 0L) { rootNodes.add(node); } else { MenuNode parentNode nodeMap.get(menu.getParentId()); if (parentNode ! null) { parentNode.getChildren().add(node); } } } // 按sortOrder排序并递归排序子节点 sortMenuNodes(rootNodes); return rootNodes; }MenuNode类特意加了JsonIgnore注解在parentId字段上避免JSON序列化时出现循环引用。前端拿到的数据形如[ { id: 1, name: 工作台, path: /dashboard, component: Layout, children: [ {id: 5, name: 我的工单, path: /workorder/my, component: MyWorkOrder} ] } ]关键设计点component字段存的是Vue组件名如Layout、MyWorkOrder这样前后端完全解耦——前端按component动态import后端只管提供路由元数据。3.3 权限校验模块基于注解的细粒度控制权限控制通过RequiresPermissions注解实现底层是Spring AOP切面PermissionAspect。它不校验角色而是直接查sys_user、sys_role_menu、sys_menu三表关联判断当前用户是否有访问该URL的权限// PermissionAspect.java Around(annotation(requiresPermissions)) public Object checkPermission(ProceedingJoinPoint joinPoint, RequiresPermissions requiresPermissions) throws Throwable { String[] permissions requiresPermissions.value(); Long userId SecurityUtils.getCurrentUserId(); // 从JWT中解析出用户ID // SQL等价于SELECT COUNT(1) FROM sys_user u // JOIN sys_user_role ur ON u.id ur.user_id // JOIN sys_role_menu rm ON ur.role_id rm.role_id // JOIN sys_menu m ON rm.menu_id m.id // WHERE u.id ? AND m.path IN (?, ?, ?) boolean hasPermission menuMapper.hasPermission(userId, permissions); if (!hasPermission) { throw new AccessDeniedException(Access denied for user: userId); } return joinPoint.proceed(); }使用时只需在Controller方法上标注// OrderController.java GetMapping(/list) RequiresPermissions(/order/list) // 对应sys_menu.path字段值 public ResultListOrder listOrders() { return Result.success(orderService.list()); }注意RequiresPermissions的value是sys_menu.path不是HTTP路径。比如菜单表里path/order/list那控制器方法就必须写RequiresPermissions(/order/list)哪怕你的接口实际映射是GetMapping(/api/v1/orders)——这是为统一权限模型做的抽象避免URL变更导致权限失控。4. 避坑指南这5个问题90%的人启动时都会踩4.1 现象启动报错Caused by: java.lang.ClassNotFoundException: com.sosomobile.common.utils.DateUtils原因common-utils-1.0.2.jar未正确安装到本地Maven仓库或IDEA未刷新依赖。Maven命令执行后检查~/.m2/repository/com/sosomobile/common-utils/1.0.2/目录下是否存在common-utils-1.0.2.jar文件。解决重新执行mvn install:install-file命令确保路径无空格、无中文然后在IDEA中右键项目 →Maven→Reload project。4.2 现象登录成功后跳转/dashboard空白浏览器控制台报TypeError: Cannot read property children of undefined原因sys_menu表中存在parent_id指向了不存在的菜单ID比如parent_id999但ID999的菜单已被删除导致buildMenuTree()方法中parentNode为null后续.getChildren()抛异常。解决执行SQL修复脏数据DELETE FROM sys_menu WHERE parent_id NOT IN (SELECT id FROM sys_menu) AND parent_id IS NOT NULL;再重启服务。4.3 现象Swagger页面打不开提示Failed to load API definition原因application-dev.yml中springfox.documentation.swagger.v2.path配置错误或SwaggerConfig.java里DocketBean的paths()过滤器误拦了/v2/api-docs。解决检查SwaggerConfig.java第32行确认paths是PathSelectors.any()而非PathSelectors.regex(/api/.*)同时确认application-dev.yml中该路径配置为/v2/api-docs。4.4 现象修改sys_menu表后前端菜单不更新仍显示旧数据原因菜单数据被缓存在Redis中key为menu:allTTL为30分钟。开发时没关缓存导致改库不生效。解决临时关闭缓存在MenuService.java的buildMenuTree()方法开头加if (true) { // 开发模式跳过缓存 }或直接redis-cli DEL menu:all清空。4.5 现象/login接口返回401但账号密码明明正确原因SecurityConfig.java中http.authorizeRequests()配置了antMatchers(/login).permitAll()但顺序写错了——如果把它放在.anyRequest().authenticated()之后请求根本匹配不到。解决打开SecurityConfig.java确保antMatchers(/login).permitAll()这一行在.anyRequest().authenticated()之前Spring Security的匹配是顺序敏感的。5. 二次开发实战如何接入你自己的业务模块5.1 新增一个“设备管理”模块含菜单、权限、页面这是最典型的扩展场景。分四步走每步都有可复制的代码模板第一步建菜单表记录向sys_menu插入一行INSERT INTO sys_menu (id, name, path, component, parent_id, sort_order, is_visible, create_time) VALUES (100, 设备管理, /device, DeviceLayout, 1, 8, 1, NOW());注意parent_id1表示挂在“工作台”下componentDeviceLayout对应前端views/device/DeviceLayout.vue。第二步写后端Controller与Service在com.sosomobile.device包下创建// DeviceController.java RestController RequestMapping(/api/v1/device) public class DeviceController { Autowired private DeviceService deviceService; GetMapping(/list) RequiresPermissions(/device/list) // 权限标识需同步写入sys_menu public ResultListDevice listDevices() { return Result.success(deviceService.listAll()); } }DeviceService用MyBatis Plus的IService接口即可无需手写XML。第三步前端页面开发在src/views/device/下新建DeviceLayout.vue结构参考Dashboard.vue重点是路由守卫// router/index.js { path: /device, name: DeviceLayout, component: () import(/views/device/DeviceLayout.vue), meta: { title: 设备管理, icon: el-icon-monitor }, children: [ { path: list, name: DeviceList, component: () import(/views/device/DeviceList.vue), meta: { title: 设备列表, icon: el-icon-s-data } } ] }第四步分配权限登录后台进入“系统设置”→“角色管理”编辑ADMIN角色勾选“设备管理”菜单及其子项保存。此时admin用户即可访问/device/list接口。5.2 改造登录逻辑对接LDAP认证若你公司用LDAP统一认证只需替换AuthController.login()方法。原生JWT登录逻辑在AuthController.java第45行将其改为调用LDAP服务// AuthController.java PostMapping(/login) public ResultJwtResponse login(RequestBody LoginRequest loginRequest) { // 原逻辑UserDetails userDetails userDetailsService.loadUserByUsername(loginRequest.getUsername()); // 新逻辑调用LDAP LdapUser ldapUser ldapService.authenticate(loginRequest.getUsername(), loginRequest.getPassword()); if (ldapUser null) { return Result.fail(LDAP认证失败); } // 构造Spring Security的UserDetails可继承org.springframework.security.core.userdetails.User UserDetails userDetails new LdapUserDetails(ldapUser); String accessToken jwtTokenProvider.generateAccessToken(userDetails); String refreshToken jwtTokenProvider.generateRefreshToken(userDetails); return Result.success(new JwtResponse(accessToken, refreshToken)); }LdapUserDetails类需实现UserDetails接口并重写getAuthorities()方法将LDAP组映射为SimpleGrantedAuthority如ROLE_ADMIN。ldapService用Spring LDAP Template实现连接参数从application.yml读取。5.3 日志增强操作日志接入ELK项目已有SysLog实体和SysLogMapper但默认只存数据库。要接入ELK只需在LogAspect.java的afterReturning方法末尾加一行// LogAspect.java AfterReturning(pointcut logPointcut(), returning result) public void afterReturning(JoinPoint joinPoint, Object result) { // ... 原有日志入库逻辑 // 新增发送到Logstash SysLog log buildSysLog(joinPoint, result); kafkaTemplate.send(soso-log-topic, JSON.toJSONString(log)); // 推荐用Kafka中转比直接HTTP更稳 }application-dev.yml中增加Kafka配置spring: kafka: bootstrap-servers: localhost:9092 template: default-topic: soso-log-topic从那以后我每次加新模块都强制走一遍“菜单插入→权限注解→前端路由→角色分配”四步闭环再用Postman调一次接口看日志表有没有记录——这成了我防漏配的肌肉记忆。希望帮到你。本文还有配套的精品资源点击获取