Jsp+SSM实验室管理系统开发实战：从表设计、权限控制到部署避坑指南

简介在JavaWeb开发中基于SSMSpring、Spring MVC、MyBatis的传统分层架构始终是构建中小型管理系统的经典方案。该架构将对象管理、请求分发和数据持久化职责清晰分离配合Jsp服务端渲染特别适合业务边界明确、需要快速交付的B/S系统。技术价值在于分层直白、事务可控能有效支撑设备预约、状态流转、权限校验等关键逻辑。这类系统广泛应用于高校实验室的设备借用、耗材领用、实验预约与记录查询场景。本文以实验室管理系统为例详解核心表结构设计、RBAC权限模型搭建、IDEA从新建Jsp项目到war包部署的全过程并总结Mapper绑定失败、EL表达式不解析、部署乱码等高频运行期问题的排查方法帮助开发者少走弯路。1. JspSSM的实验室管理系统为什么这个老组合到现在还是毕设和实训的首选JspSSM的实验室管理系统是近十年Java Web毕业设计里最稳的组合之一。它要解决的问题很简单实验室里的设备借用、实验预约、耗材领用别再靠纸质登记和Excel排班用一个B/S系统把“谁在什么时候用了哪台设备”管起来。这套方案到现在还被反复选作基于Jsp的毕设选题不是因为技术新而是SSM分层直白——Controller接参、Service做业务、Mapper写SQL、Jsp渲染页面每一层都能对应论文里的一个章节。适合两类人想做毕设但不想碰前后端分离的本科生和刚学完JavaWeb想拿完整SSM项目练手的初级开发。这篇按“能复现、能验收、能答辩”的标准把设计、实现、部署和坑一次讲完。2. 拆解SSM在实验室管理系统里的分工MVC分别落在哪一层SSM三个框架的边界很多人背得熟但落不了地一到写代码就全塞进Controller。先花点篇幅把职责切清楚后面写设备预约和借还才不会乱。2.1 Spring管对象、Spring MVC管请求、MyBatis管SQL三个框架各守一段Spring在实验室管理系统里最核心的工作不是AOP而是IoC容器。Controller、Service、Mapper这些对象都交给Spring创建和注入Service不需要自己new一个Dao构造器或者setter注入即可。这样做的直接好处是你想给Service换一套数据访问实现或者做单元测试时Mock掉Mapper都不需要动业务代码。Spring MVC负责的是请求从浏览器到Controller的流转路径。它的核心组件是DispatcherServlet。传统Jsp项目里DispatcherServlet在前端控制器模式下接收所有以.do或者直接以路径形式进来的请求然后通过HandlerMapping找到对应Controller方法返回到ViewResolver解析出来的Jsp。这里要养成一个习惯Controller里只做参数接收、简单校验、调用Service、把结果放进ModelAndView或Model不要在Controller里写SQL或者写复杂的if-else业务规则否则答辩老师一问业务逻辑在哪层你就只能指着Controller说“都在这”非常减分。MyBatis在这套系统里只做一件事把Java方法和SQL映射起来。Mapper接口里定义一个ListDevice selectAvailableDevices(String date)对应的XML文件里写select标签MyBatis把结果集映射成Device对象列表。相比JDBCMyBatis省掉了ResultSet手工取值那几十行重复代码相比Hibernate它又能让你的SQL保持完全可控实验室管理系统的报表统计场景需要写多表关联和条件统计MyBatis显然更顺手。这三者的协作顺序一次请求走下来就是Jsp发起请求Spring MVC分发Controller调用ServiceService调用MapperMyBatis执行SQL结果再一层层返回Jsp渲染。2.2 实验室管理系统的核心实体设计设备、预约、耗材、实验记录实验室管理系统听起来大真正要落表的业务其实就那么几块。先看我一般用的第一版表结构不追求大而全但能覆盖设备借用、实验预约、耗材领用和记录留存四条主线。-- 用户表注意别用 user 这个表名MySQL 自带库里有同名系统表 CREATE TABLE sys_user ( id INT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(50) NOT NULL UNIQUE, password VARCHAR(64) NOT NULL COMMENT MD5或BCrypt存储, real_name VARCHAR(50), role_id INT COMMENT 关联角色表, status TINYINT DEFAULT 1 COMMENT 0禁用 1正常, create_time DATETIME DEFAULT CURRENT_TIMESTAMP ); -- 设备表 CREATE TABLE lab_device ( id INT PRIMARY KEY AUTO_INCREMENT, device_code VARCHAR(30) NOT NULL UNIQUE COMMENT 设备编号如 DNS-2024-001, device_name VARCHAR(100) NOT NULL, category VARCHAR(50) COMMENT 示波器/传感器/开发板等, location VARCHAR(100) COMMENT 存放位置, status TINYINT DEFAULT 0 COMMENT 0空闲 1已预约 2使用中 3维修中, version INT DEFAULT 0 COMMENT 乐观锁版本号后面会用到 ); -- 预约表 CREATE TABLE lab_reservation ( id INT PRIMARY KEY AUTO_INCREMENT, user_id INT NOT NULL, device_id INT NOT NULL, reserve_date DATE NOT NULL, time_slot VARCHAR(20) NOT NULL COMMENT 如 08:00-10:00, status TINYINT DEFAULT 0 COMMENT 0待审核 1通过 2已用 3已取消, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, UNIQUE KEY uk_device_date_slot (device_id, reserve_date, time_slot) );UNIQUE KEY uk_device_date_slot这张表的命脉。没有这个唯一索引同一台设备在同一日期同一时段极容易被两个人同时约上。代码里可以用if判断兜底但数据库的唯一索引才是最后一道防线后面避坑章节我会专门说这个。耗材表和实验记录表我一般这样设计字段看了就能懂不多解释。CREATE TABLE lab_consumable ( id INT PRIMARY KEY AUTO_INCREMENT, name VARCHAR(100) NOT NULL, spec VARCHAR(100), total_count INT DEFAULT 0, stock_count INT DEFAULT 0, threshold INT DEFAULT 10 COMMENT 低于该值提醒补货 ); CREATE TABLE lab_record ( id INT PRIMARY KEY AUTO_INCREMENT, user_id INT NOT NULL, device_id INT NOT NULL, start_time DATETIME NOT NULL, end_time DATETIME, purpose VARCHAR(255) COMMENT 实验用途说明, issue_desc VARCHAR(255) COMMENT 异常记录可选 );这里要提醒一句不要一开始就想着把所有实验室的业务都塞进去比如实验成绩管理、课程排课、仪器采购、财务报表。一份能验收的毕设或者实训项目业务边界控制在“设备预约、设备借用归还、耗材库存、实验记录查询”就够了。多一张表多一套增删改查工作量成倍涨答辩时却说不清需求来源反而容易被问穿。2.3 权限模型用RBAC三张表串起来用户、角色、菜单实验室管理系统必须有权限区分。最简单的做法是给sys_user加一个role_id字段管理员和老分师两种角色写死在代码里。这样做能跑但不够好看也扩展不动。我建议用经典RBAC多建两张关联表成本很低答辩时却可以说“子系统支持动态分配权限”。CREATE TABLE sys_role ( id INT PRIMARY KEY AUTO_INCREMENT, role_name VARCHAR(50) NOT NULL, role_key VARCHAR(50) NOT NULL COMMENT 如 admin/teacher/student ); CREATE TABLE sys_menu ( id INT PRIMARY KEY AUTO_INCREMENT, parent_id INT DEFAULT 0, menu_name VARCHAR(50) NOT NULL, url VARCHAR(100) COMMENT 如 /device/list, perms VARCHAR(100) COMMENT 如 device:add ); CREATE TABLE sys_user_role ( user_id INT NOT NULL, role_id INT NOT NULL, PRIMARY KEY (user_id, role_id) ); CREATE TABLE sys_role_menu ( role_id INT NOT NULL, menu_id INT NOT NULL, PRIMARY KEY (role_id, menu_id) );登录成功后一次联表查询把当前用户拥有的菜单URL和权限标识查出来放到session里。页面渲染时按权限标识控制按钮是否显示接口层面再用拦截器校验。这样一个学生账号登录后只看到“预约设备、我的记录”管理端账号才能看到“设备管理、耗材入库、预约审核”。权限这块做到这个程度已经超过六成以上同题目的作品。下一章开始动手把项目骨架搭起来可以新建一个maven webapp项目按2.2节的三张核心表建库建表直接开写。3. 把SSM项目在IDEA里跑起来从新建Jsp项目到war包部署这一章解决一个实际问题拿到了设计怎么在IDEA里新建一个能跑通的传统Jsp项目。网上很多教程默认你会从骨架开始实际到了IDEA这一步就有一半人翻车所以我把完整路径和配置写在这里。3.1 为什么要手工搭传统Jsp项目而不是直接SpringBoot集成Jsp先回答一个检索热度很高的问题SpringBoot 2能不能集成Jsp能但限制比传统SSM多。SpringBoot官方对Jsp的支持定位是“兼容遗留系统”打成jar包时Jsp无法在嵌入式Tomcat里正常渲染必须打成war包并部署到外部Tomcat而且Jsp文件必须放在src/main/webapp目录下不能放在resources里。对只做过Maven构建、不熟悉war包结构的同学来说这个坑很容易踩到。我做实验室管理系统这类项目时倾向直接用传统SSM而不是SpringBoot。原因很实在这个系统的核心业务是几十个接口加几张Jsp页面不需要自动配置那一大套SpringBoot虽然省事但出了问题排查路径长。传统SSM的web.xml、spring-mvc.xml、mybatis-config.xml三个配置文件立在那里项目启动失败时错误日志能明确指到某个bean或某条SQL对初学者友好得多。还有人问nginx支持jsp吗这里顺手说清楚。nginx本身不解析jsp它的定位是静态资源服务器和反向代理。你拿nginx直接指向一个.jsp文件要么返回404要么把Jsp源码当文件下载下来。正确的部署结构是nginx监听80端口location里配置proxy_pass http://127.0.0.1:8080;把动态请求转发给TomcatTomcat再把Jsp编译成Servlet去执行。实验室管理系统如果在学校机房局域网里用没有高并发不引入nginx也完全没问题把war包丢到Tomcat的webapps目录就能跑。3.2 搭SSM骨架的三件套pom.xml、web.xml、spring-mvc.xml在IDEA里新建项目选Maven骨架时不要选Spring Initializr直接选maven-archetype-webapp。这个骨架会生成标准的src/main/webapp目录和index.jsp省去后面补目录结构的工作。项目名建议全小写比如lab-manager避免出现大写字母导致Tomcat路径大小写问题。pom.xml是第一个要动手的文件。依赖版本是重灾区直接给我常用的组合Spring 5.3.x、MyBatis 3.5.xJDK用1.8或11都可以。关键依赖段如下。properties spring.version5.3.23/spring.version mybatis.version3.5.13/mybatis.version maven.compiler.source1.8/maven.compiler.source maven.compiler.target1.8/maven.compiler.target /properties dependencies dependency groupIdorg.springframework/groupId artifactIdspring-webmvc/artifactId version${spring.version}/version /dependency dependency groupIdorg.springframework/groupId artifactIdspring-jdbc/artifactId version${spring.version}/version /dependency dependency groupIdorg.mybatis/groupId artifactIdmybatis/artifactId version${mybatis.version}/version /dependency dependency groupIdorg.mybatis/groupId artifactIdmybatis-spring/artifactId version2.0.6/version /dependency dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId version8.0.27/version /dependency dependency groupIdjavax.servlet/groupId artifactIdjstl/artifactId version1.2/version /dependency dependency groupIdjavax.servlet/groupId artifactIdjavax.servlet-api/artifactId version4.0.1/version scopeprovided/scope /dependency /dependenciesspring-webmvc是Spring MVC核心spring-jdbc提供事务管理所需的数据源支持mybatis-spring是MyBatis整合Spring的桥接包。JSTL在Jsp页面里做遍历和格式化要用javax.servlet-api设置成provided因为Tomcat自带Servlet容器带进去反而会和容器冲突。接着写web.xml。用maven-archetype-webapp生成的web.xml是Servlet 2.3的旧版头必须换成Servlet 3.1的schema头否则EL表达式和部分注解会失效。web-app xmlnshttp://xmlns.jcp.org/xml/ns/javaee xmlns:xsihttp://www.w3.org/2001/XMLSchema-instance xsi:schemaLocationhttp://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd version3.1 display-namelab-manager/display-name filter filter-nameencodingFilter/filter-name filter-classorg.springframework.web.filter.CharacterEncodingFilter/filter-class init-param param-nameencoding/param-name param-valueUTF-8/param-value /init-param init-param param-nameforceEncoding/param-name param-valuetrue/param-value /init-param /filter filter-mapping filter-nameencodingFilter/filter-name url-pattern/*/url-pattern /filter-mapping servlet servlet-namedispatcher/servlet-name servlet-classorg.springframework.web.servlet.DispatcherServlet/servlet-class init-param param-namecontextConfigLocation/param-name param-valueclasspath:spring-mvc.xml/param-value /init-param load-on-startup1/load-on-startup /servlet servlet-mapping servlet-namedispatcher/servlet-name url-pattern//url-pattern /servlet-mapping /web-app编码过滤器必须配而且要放在所有过滤器最前面。很多人Jsp页面乱码就是漏了filter-mapping或者把filter写在了servlet后面。/的url-pattern表示所有请求都进DispatcherServlet静态资源css/js要在spring-mvc.xml里单独放行。spring-mvc.xml我放在src/main/resources下核心配置只有三块组件扫描、注解驱动、视图解析器。beans xmlnshttp://www.springframework.org/schema/beans xmlns:xsihttp://www.w3.org/2001/XMLSchema-instance xmlns:contexthttp://www.springframework.org/schema/context xmlns:mvchttp://www.springframework.org/schema/mvc xsi:schemaLocationhttp://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context.xsd http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc.xsd context:component-scan base-packagecom.lab.controller/ mvc:annotation-driven/ mvc:resources mapping/static/** location/static// bean classorg.springframework.web.servlet.view.InternalResourceViewResolver property nameprefix value/WEB-INF/views// property namesuffix value.jsp/ /bean /beans组件扫描只扫com.lab.controller即只把Controller层交给Spring MVC管理。Service和Mapper交给另一个spring-dao.xml在根容器里加载这是SSM的标准分工避免Bean被创建两份。实际的完整项目还需要spring-dao.xml配置数据源、SqlSessionFactoryBean和MapperScannerConfigurer篇幅原因不贴全但结构上必须和spring-mvc.xml并列存在。3.3 配置Tomcat启动项目首次访问实验室管理登录页IDEA里配Tomcat这一步操作路径是Run - Edit Configurations - 左上角加号 - Tomcat Server - Local。点击Deployment页签加号选Artifact这里有两种选择lab-manager:war和lab-manager:war exploded。开发阶段一定选war exploded。它的意思是把项目解压目录直接作为部署目录Jsp和class文件改了之后热部署基本能秒生效。选war则每次修改都要重新构建整个war包再部署改一个Jsp等半分钟极其折磨。Application context建议填/lab-manager访问路径就是http://localhost:8080/lab-manager/login.jsp。启动前检查三处第一Artifact里有没有把依赖的jar包带进去展开WEB-INF目录看有没有lib第二web.xml是不是Servlet 3.1版本头第三数据库表建好了没有。这三点有任何一个不对Tomcat启动要么报ClassNotFoundException要么报404要么Jsp页面原样输出源码。首次访问看到登录页说明DispatcherServlet和视图解析器都正常工作。接下来要把登录后的session逻辑和设备列表接口接上去这个在第四章讲核心流程时一起做。4. 实现设备预约与个人中心的核心流程从Controller到Jsp页面骨架跑通后业务代码怎么写才规范这一章直接给可复用的模板。4.1 用登录拦截器把权限校验集中起来而不是到处写if实验室管理系统的所有业务页面都必须登录后才能访问除了登录页本身。最偷懒的做法是在每个Controller方法里写一句session判断但那样代码会变成一坨重复的if。用Spring MVC的HandlerInterceptor把登录校验抽出来是传统Jsp项目里最常见的做法。package com.lab.interceptor; import org.springframework.web.servlet.HandlerInterceptor; import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletResponse; import javax.servlet.http.HttpSession; public class LoginInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { HttpSession session request.getSession(false); if (session ! null session.getAttribute(loginUser) ! null) { return true; } // 未登录一律跳回登录页带上来源路径登录后可以跳回原页面 response.sendRedirect(request.getContextPath() /login?redirect request.getRequestURI()); return false; } }年request.getSession(false)的意思是如果没有会话就返回null而不是创建一个新session。如果你写成request.getSession()那每个未登录请求都会被迫创建一个HttpSession对象白白浪费内存这是细节上的性能损耗。拦截器要在spring-mvc.xml里注册并配置放行路径不然登录页自己也被拦住形成死循环。mvc:interceptors mvc:interceptor mvc:mapping path/**/ mvc:exclude-mapping path/login/ mvc:exclude-mapping path/static/**/ bean classcom.lab.interceptor.LoginInterceptor/ /mvc:interceptor /mvc:interceptors/login是登录请求的URL必须排掉/static/**放行CSS和JS文件否则页面样式全部加载不了。登录接口本身做密码校验时从数据库查用户然后比对密码。密码建议用MD5加盐或者BCrypt加密存储明文存密码在答辩时会被老师一眼挑出安全问题。4.2 设备预约的Service事务处理状态流转必须和数据库一致设备预约的核心业务方法是reserveDevice看起来简单实际有三个状态要同步设备状态从空闲变为已预约预约记录插入同一个时段不能重复预约。这三个动作必须在一个事务里不然插入预约成功但设备状态没改或者反过来都会造成脏数据。package com.lab.service.impl; import com.lab.common.BizException; import com.lab.mapper.DeviceMapper; import com.lab.mapper.ReservationMapper; import com.lab.model.Reservation; import org.springframework.stereotype.Service; import org.springframework.transaction.annotation.Transactional; import javax.annotation.Resource; Service public class ReservationServiceImpl { Resource private ReservationMapper reservationMapper; Resource private DeviceMapper deviceMapper; Transactional(rollbackFor Exception.class) public boolean reserveDevice(Reservation reservation) { // 1. 查重同一设备同一时段只能有一条有效预约 int conflictCount reservationMapper.countConflict( reservation.getDeviceId(), reservation.getReserveDate(), reservation.getTimeSlot()); if (conflictCount 0) { throw new BizException(该时段已被预约请选择其他时段); } // 2. 插入预约记录状态为待审核或通过 reservation.setStatus(0); reservationMapper.insert(reservation); // 3. 设备状态置为已预约 deviceMapper.updateStatus(reservation.getDeviceId(), 1); return true; } }rollbackFor Exception.class必写。Spring声明式事务默认只回滚RuntimeException和Error如果你的代码抛的是自定义的CheckedException事务不会回滚预约记录就留在数据库里了。这个细节几乎每届做毕设的人都会踩。countConflict对应的SQL在Mapper的XML里其中最后一个条件是关键不能把已经取消的预约算作冲突。select idcountConflict resultTypeint SELECT COUNT(*) FROM lab_reservation WHERE device_id #{deviceId} AND reserve_date #{reserveDate} AND time_slot #{timeSlot} AND status IN (0, 1) /select设备状态和设备表里的status字段要保持同步。我会在Service里封装一个changeDeviceStatus方法所有调用方都走它而不是直接用deviceMapper.updateStatus。这样后面如果要加状态流转限制比如维修中的设备不能被预约只需要改这一个方法。4.3 Jsp页面用JSTLEL渲染预约列表别在页面里写Java脚本Jsp页面是最容易写脏的部分。很多人习惯在% %里写for循环和if判断页面看起来像垃圾场而且Scriptlet和HTML混在一起改动一行数据逻辑就要重新编译Jsp。规范的写法是只用EL表达式和JSTL标签。一个典型的Jsp个人信息展示页面加预约列表页面结构是这样的。登录后把当前用户的信息放在Model里在“我的预约”页面展示。% page contentTypetext/html;charsetUTF-8 pageEncodingUTF-8 % % taglib prefixc urihttp://java.sun.com/jsp/jstl/core % % taglib prefixfmt urihttp://java.sun.com/jsp/jstl/fmt % html head title我的预约/title link relstylesheet href${pageContext.request.contextPath}/static/css/main.css /head body h2欢迎${sessionScope.loginUser.realName}/h2 table border1 cellpadding8 cellspacing0 tr th设备名称/th th预约日期/th th时段/th th状态/th th创建时间/th /tr c:forEach items${reservationList} varr varStatusst tr td${r.deviceName}/td td${r.reserveDate}/td td${r.timeSlot}/td td c:choose c:when test${r.status 0}待审核/c:when c:when test${r.status 1}已通过/c:when c:when test${r.status 2}已使用/c:when c:otherwise已取消/c:otherwise /c:choose /td tdfmt:formatDate value${r.createTime} patternyyyy-MM-dd HH:mm//td /tr /c:forEach /table /body /html注意${sessionScope.loginUser.realName}登录用户信息在登录时放入session展示个人信息页面时直接从session取不需要每次请求都查库。reservationList由Controller放到Model里页面上的deviceName不是数据库查询出来的而是SQL里join了设备表这部分映射在Mapper的resultMap中完成页面只负责显示不参与业务。Controller层的方法模板如下逻辑简单干净。Controller RequestMapping(/reservation) public class ReservationController { Resource private ReservationService reservationService; GetMapping(/myList) public String myList(HttpSession session, Model model) { SysUser user (SysUser) session.getAttribute(loginUser); model.addAttribute(reservationList, reservationService.listByUserId(user.getId())); return reservation/myList; } }页面路径由视图解析器的/WEB-INF/views/拼接返回字符串决定实际Jsp文件放在webapp/WEB-INF/views/reservation/myList.jsp。理念是所有页面都收在WEB-INF下用户拿URL直接访问不了Jsp源文件只能通过Controller跳转安全性比裸放在webapp根目录下高一个等级。5. 避坑JspSSM项目从开发到部署最常见的5个运行期问题下面这5个问题是从“能在IDEA里跑”到“能拿着部署给老师看”之间最常见的障碍每条按现象、原因、解决三个步骤写都是我实际调过的。5.1 新建的Jsp项目在IDEA里没有src/main/webapp或者没有web.xml现象IDEA新建项目后只有一个src目录和pom.xml找不到webapp目录或者有webapp但web.xml缺失Tomcat启动直接报警。原因新版IDEA创建maven-archetype-webapp骨架时偶尔会出现目录结构生成不完整的情况更常见的情况是你选错了骨架比如选了quickstart普通Java工程再手动补目录漏了web.xml。解决切到Project Structure - Facets选中Web模块检查Web Resource Directory和Web.xml路径。如果web.xml不存在选择src/main/webapp/WEB-INF/web.xmlIDEA会帮你生成或补上。webapp目录没有的时候手动在src/main/webapp下创建WEB-INF文件夹再放一个合法的web.xml进去然后右键webapp目录选择Mark Directory as - Resources Root。标准Maven工程目录就五层src/main/java、src/main/resources、src/main/webapp、src/test/java、src/test/resources缺哪层补哪层。5.2 Mapper接口和XML没绑定报Invalid bound statement (not found)现象启动Tomcat时不报错一调用列表接口就抛org.apache.ibatis.binding.BindingException: Invalid bound statement (not found): com.lab.mapper.DeviceMapper.listAll。原因Mapper的XML文件放在了src/main/java/com/lab/mapper/目录下Maven默认只把src/main/resources下的xml打进classpathjava目录下的xml被排除在外了。IDE里直接运行有时能跑通因为IDEA对resource的标记生效了但一用Maven打包就原形毕露。解决在pom.xml的build节点里显式声明resources把java目录下的xml和properties文件一起包含进去。build finalNamelab-manager/finalName resources resource directorysrc/main/java/directory includes include**/*.xml/include include**/*.properties/include /includes /resource resource directorysrc/main/resources/directory /resource /resources /build改完执行Maven - Reload Project然后重新构建。这里有个血泪经验判断问题是不是这个看target/classes目录下有没有对应的xml文件没有就是资源打包问题。5.3 Jsp页面EL表达式不解析页面原样输出${list}现象页面文字都正常就是${reservationList}原样显示在页面上遍历标签也不生效整页像看源代码一样。原因一是web.xml用的是Servlet 2.3旧schema头EL表达式在这个版本下默认关闭二是页面缺少% page isELIgnoredfalse %或者引入了错误的JSTL版本导致标签库不识别。解决首选把web.xml的schema头改成3.1版本。改完强制刷新浏览器如果还不行再检查Jsp第一行有没有% page contentTypetext/html;charsetUTF-8 isELIgnoredfalse pageEncodingUTF-8 %。Tomcat版本也要对应好Tomcat 9对应Servlet 4.0Tomcat 8.5对应Servlet 3.1老Tomcat配新版schema虽然能启动但部分特性不生效。实验室管理系统建议直接用Tomcat 8.5或9.0配Java 8编译环境最省心。5.4 本地开发中文正常打成war包部署到Linux后全部乱码现象IDEA里跑一切正常把lab-manager.war丢到Linux服务器的Tomcat上登录后用户名、设备名称全部变成“????”。原因乱码是链条式的。至少四个环节有一个编码不是UTF-8就会这样Jsp文件本身的编码、Tomcat连接器URI编码、数据库连接URL编码、Linux系统环境编码。解决逐个检查。第一Jsp文件统一UTF-8IDEA右下角把文件编码改掉第二Tomcat的server.xml里Connector节点加URIEncodingUTF-8第三MySQL连接URL必须带参数注意是半角分号分隔第四Linux下Tomcat启动脚本catalina.sh开头加JAVA_OPTS$JAVA_OPTS -Dfile.encodingUTF-8。jdbc:mysql://localhost:3306/lab_manager?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghaiMySQL表的字符集也要检查建库的时候统一用DEFAULT CHARACTER SET utf8mb4。utf8mb4兼容emoji和生僻汉字utf8在写入部分特殊字符时会报错这个坑我踩过一次后就再没用过不带mb4的库。5.5 war包部署后报ClassNotFoundException本地却好好的现象本地IDEA启动没有任何问题把war包手动复制到Tomcat的webapps下访问时抛java.lang.ClassNotFoundException: org.springframework.web.context.ContextLoaderListener。原因IDEA开发模式下lib目录由IDEA自动拼接打war包时Artifact的WEB-INF/lib目录没有把依赖jar包放进去。这是一个典型的手工构建产物问题。解决在IDEA的Project Structure - Artifacts里选中你的war包展开WEB-INF看有没有lib目录。没有就右键WEB-INF选择Create Directory - lib然后在Available Elements里把所有依赖jar包拖进lib。构建完毕后再看out/artifacts/lab_war下的war包体积理论上应该在20MB以上如果只有几十KB基本就是lib没打进去。另一种更可靠的做法是直接用Maven的mvn clean package构建war包pom里加一个maven-war-plugin环境一致不会出这个问题。6. 进阶用乐观锁和唯一索引解决设备预约并发把踩坑经历变成答辩加分项前面讲到的查重和唯一索引在单机单用户测试时很稳但到了验收演示或真实实验室场景两台电脑同时提交同一台设备的同一个时段就会出现一个隐藏问题两个请求同时通过查重然后两个预约记录都插入成功。唯一索引uk_device_date_slot会兜住重复插入但如果你把插入和更新状态的顺序弄反了就会抛出一个DuplicateKeyException页面直接500。体验很差而且答辩老师只要问一句“并发下怎么保证不重复”你支支吾吾就掉分。我在这个项目的第二版里把两部分都补上了数据库层面保留唯一索引应用层加乐观锁。因为查重和插入之间有几十毫秒的时间窗口靠代码先查后插本来就治不了并发必须靠数据库约束。唯一索引保证数据不脏乐观锁保证状态流转不丢更新。乐观锁的核心是给lab_device表加一个version字段更新设备状态时不直接用status条件而是把version也作为条件参与更新。更新的SQL是我压箱底的一段。update idcompareAndSetStatus UPDATE lab_device SET status #{newStatus}, version version 1 WHERE id #{deviceId} AND status #{expectStatus} AND version #{version} /update先查出当前设备信息把status和version值记下来更新时带上这两个条件。如果期间有其它请求把设备状态改掉了或者版本号变化了这次update影响的行数就是0。Service层判断受影响行数为0就抛出“设备状态已变化请刷新后重试”的提示让用户重新选择。配套的Service层代码改成这样。Transactional(rollbackFor Exception.class) public boolean reserveDeviceWithLock(Reservation reservation, int version) { int rows deviceMapper.compareAndSetStatus( reservation.getDeviceId(), 0, 1, version); if (rows 0) { throw new BizException(设备状态已变化请刷新页面后重新预约); } try { reservationMapper.insert(reservation); } catch (DuplicateKeyException e) { throw new BizException(该时段已被预约请更换时间); } return true; }注意这里的事务顺序先更新设备状态再插入预约记录。如果反过来预约记录先插入成功了但设备状态更新失败回滚数据一致性问题不大但如果插入失败抛异常设备状态已经被提前改掉就需要额外的补偿逻辑。先锁设备再写预约逻辑链更短。这个版本号思路不仅用在设备状态上耗材库存扣减也可以复用。领用耗材时UPDATE lab_consumable SET stock_count stock_count - 1 WHERE id #{id} AND stock_count #{num}这个SQL天然就是乐观锁因为它把剩余库存是否足够变成了UPDATE条件影响行数为0就知道库存不够不需要先SELECT再判断。这套方案的另一个优势是演示效果直观。答辩时准备一条测试用例开两个浏览器窗口用两个学生账号同时点“预约”同一台示波器。因为唯一索引的存在第二个请求要么收到友好提示要么查询列表里已经看不到这台设备无论如何都不会产生两条有效预约。把这个并发测试的过程提前跑一遍截图放在论文测试章节里比空谈“系统稳定可靠”有说服力得多。我自己的习惯是每次把war包部署到Tomcat正式验收前必测三个场景不同浏览器同时预约同一设备、同一个账号连续点击两次提交、把系统时间改到预约日当天看状态是否自动流转。这三个场景跑通基本能覆盖实验室管理系统八成以上的隐性Bug。做技术项目就是这样把常见问题踩一遍再修一遍收获比顺风顺水跑完整套要大得多。希望帮到你。本文还有配套的精品资源点击获取