尧图网页设计 
简介面向计算机相关专业本科及专科毕业设计学生这是一份基于SSM/Mysql的文物管理系统完整项目包覆盖需求分析、总体设计、功能实现、系统测试到验收答辩的全流程可直接作为毕设参考框架。内含源码、论文、答辩PPT、开发文档和演示视频管理员与前台用户双端功能均已实现涉及用户管理、文物分类、文物信息、外借登记、维修记录、留言板、论坛交流及系统管理等典型模块可帮助读者快速搭建可运行的系统并理解前后台交互逻辑。资源共1331个文件以jsp动态页面、java后台逻辑、js交互脚本、css样式、png/jpg图片素材为主附带sql数据库脚本与mp4演示录屏压缩包整体68.17MB目录结构完整清晰便于逐项检索。目前已有64人学习下载适合需要成套毕设方案、论文写作范文或答辩演示素材的开发者。1. 这套SSMMysql的文物管理系统值不值得拿来改很多计算机专业的学生第一次接触SSM项目是在毕业设计这个节点。文物管理系统这个题目不像电商、博客那样烂大街又不像AI算法那样需要数学功底它天然适合用SSM框架来落地文物的登记、出入库、借展、修复记录、用户权限核心就是一组围绕数据对象的增删改查流程清晰能把Spring、SpringMVC、MyBatis三者的整合要点完整串起来。如果你拿到的是一份带源码、论文、PPT、开发文档和演示视频的压缩包真正的问题不是「能不能跑」而是「怎么把它变成你自己的项目并在答辩时讲明白」。这篇笔记我会沿着这套项目的骨架从数据库表设计讲到SpringMVC的请求流转再到部署验证与演示技巧穿插真实踩过的坑。适合三类人打算用现成源码交毕设的学生、想快速上手SSM整合的初级开发者、以及需要把管理系统模板改造成实际业务的后端入门者。2. SSM整合的文物管理系统框架选型、模块划分与工程结构这一章把项目的地基讲清楚。拿到源码包后第一个动作不是双击IDEA而是先看pom.xml和目录结构理解这个项目的骨架。很多新人上来就找applicationContext.xml在哪结果被一堆配置文件绕晕。实际上SSM项目就三个层次表现层SpringMVC、业务层Spring Service、持久层MyBatis对应的代码包结构和配置文件的职责是固定的。2.1 选型逻辑Spring、SpringMVC、MyBatis各自管哪一段文物管理系统是一个典型的单体Web应用。选SSM而不选Spring Boot不是因为Boot不好而是这套组合在毕业设计语境下有一个独特优势配置是显式的每一条bean、每一个扫描路径都是自己写的答辩时「框架原理」部分有东西可讲。Spring Boot的自动配置固然香但面试官追问「为什么这个注解就能启动一个Web应用」时说不清楚反而减分。三层框架的分工用一个就好记的比喻Spring是后勤部统一管理对象的创建和依赖关系SpringMVC是前台接待负责接收HTTP请求、找对处理人、把结果送回浏览器MyBatis是档案室负责查数据库表把记录翻译成Java对象。在一个文物管理请求里浏览器提交「查询所有青铜器」的GET请求SpringMVC把URL映到对应Controller方法Controller调用ServiceService调用MapperMapper执行SQL结果一层层返回最后JSP渲染成HTML表格。理解这条链路后面所有调试都有方向。报错时先判断是哪一层出的问题URL都进不了Controller是SpringMVC配置Service里抛异常是业务逻辑SQL执行报错是MyBatis和表结构的事。分清了排查效率直接翻倍。2.2 业务模块划分五个核心域的边界在哪一套完整的文物管理系统模块划分一般围绕五个核心业务域展开。对照源码包里的Controller和Service你会发现它们的包名就是按这个维度拆的业务域核心实体典型功能点对应数据表系统管理用户、角色登录、登出、权限分配user、role、user_role文物信息管理文物登记、修改、删除、列表查询、详情relic出入库管理文物、出入库单入库登记、出库登记、库存查询relic、inout_record借展管理借展记录借展申请、审批、归还、过期提醒borrow_record、relic修复管理修复记录修复登记、修复历史、费用统计repair_record、relic实际源码包里文物信息管理这一组代码量最大改动优先级也最高。加字段、调页面、改SQL都在这块动基本不会牵动其他模块。这是一个成熟的SSM管理系统的模块化设计思路通过包名区分业务域而不是把几十个方法全堆在一个Controller里。拿到源码后先看每个Controller的RequestMapping前缀就能快速画出一张请求路由表。2.3 工程结构源码包里的目录各自是什么一般这类项目用Maven构建标准结构是src/main/java ├── com/xxx/controller # SpringMVC控制器 ├── com/xxx/service # 业务接口 ├── com/xxx/service/impl # 业务实现 ├── com/xxx/dao # MyBatis Mapper接口 ├── com/xxx/entity # 数据库对应的实体类 └── com/xxx/config # 配置类 src/main/resources ├── applicationContext.xml # Spring核心配置 ├── springmvc-servlet.xml # SpringMVC配置 ├── mybatis-config.xml # MyBatis配置 ├── mapper # 各表的Mapper XML └── jdbc.properties # 数据库连接信息 src/main/webapp ├── WEB-INF/web.xml # 应用入口配置 ├── WEB-INF/views # JSP页面 └── static # JS/CSS/图片等静态资源这里最关键是jdbc.properties里的数据库连接配置。把URL、用户名、密码改成你本地MySQL的是项目启动的第一步。很多同学拿到项目以为要先配Spring的bean其实第一步永远是先让数据库连上。后面章节会细化到具体怎么改、怎么看配置有没有生效。3. 用MySQL搭建文物数据模型核心表结构、建表SQL与字段边界数据库表设计是文物管理系统的地基。实地去看那些跑不起来的毕设项目一半以上不是代码问题而是表结构里外键、主键、字段类型不匹配导致Mapper查询结果映射失败。这一章直接给出一套可复用的建表SQL并讲清楚每个字段为什么这么设。3.1 文物主表状态字段怎么定义才能撑起全流程文物主表是整个系统的核心一般命名为relic或者cultural_artifact。字段一般包括id、relic_no文物编号、name名称、category分类、era年代、level级别、source来源、status状态、location存放位置、description描述、create_time、update_time。状态字段值得展开。文物的生命周期有「在库、出库、借展中、修复中、已下架」几种如果用字符串存后面做统计和条件查询就要写一堆if else。常见做法是用int枚举0表示在库1表示出库2表示借展中3表示修复中。MyBatis的resultMap里再做typeHandler映射把int转成中文显示。如果嫌麻烦直接用字符串加UNIQUE约束也能跑但在报表统计时不太方便WHERE status2和WHERE statusborrowing后者写错了引号就是一场排查事故。文物编号字段relic_no必须加唯一约束。这是业务硬规则一件文物编号在整个系统里只能出现一次。光靠应用层代码先查后插挡不住并发场景两个请求同时查不到编号再同时插入数据就脏了。数据库层面的UNIQUE是最后一道防线必须有。3.2 借展、修复、用户权限三张关联表的字段设计借展记录表记录一次文物的外展过程字段包括id、relic_id外键指向文物主表、borrow_unit借展单位、borrow_date借出日期、return_date计划归还日期、actual_return_date实际归还日期、contact_person联系人、contact_phone联系电话、status0申请中、1已借出、2已归还、3已驳回。归还后status从「借展中」回到「在库」这里的核心是事务更新借展表状态的同时要同步更新文物主表的状态两个SQL必须在一个事务里。修复记录表id、relic_id、repair_date、repair_content、repair_org修复单位、cost修复费用、repair_person修复人。这张表相对简单但cost字段要注意用DECIMAL(10,2)而不是FLOAT浮点数存金额会有精度问题这在MySQL里是常识性坑。用户权限这块SSM项目里最简单的做法是「用户表角色表用户角色关联表」三张表。用户表存用户名、密码MD5加密后的、真实姓名、联系电话角色表存角色名称和角色描述关联表把用户和角色关联起来。权限控制用SpringMVC的拦截器实现登录后把用户对象放session拦截器里校验角色角色是管理员的放行否则跳到无权限页面。3.3 建表SQL与导入在Navicat和命令行下怎么执行直接给一套可以在MySQL 5.7/8.0下跑的建表SQL。-- 创建数据库 CREATE DATABASE IF NOT EXISTS relic_system DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; USE relic_system; -- 文物主表 CREATE TABLE relic ( id INT PRIMARY KEY AUTO_INCREMENT, relic_no VARCHAR(50) NOT NULL UNIQUE COMMENT 文物编号, name VARCHAR(100) NOT NULL COMMENT 文物名称, category VARCHAR(50) COMMENT 分类, era VARCHAR(50) COMMENT 年代, level VARCHAR(20) COMMENT 级别, source VARCHAR(100) COMMENT 来源, status TINYINT(4) DEFAULT 0 COMMENT 0在库 1出库 2借展中 3修复中, location VARCHAR(100) COMMENT 存放位置, description TEXT COMMENT 描述, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, update_time DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, KEY idx_category (category), KEY idx_status (status) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT文物信息表; -- 借展记录表 CREATE TABLE borrow_record ( id INT PRIMARY KEY AUTO_INCREMENT, relic_id INT NOT NULL COMMENT 关联的文物ID, borrow_unit VARCHAR(150) COMMENT 借展单位, borrow_date DATE COMMENT 借出日期, return_date DATE COMMENT 计划归还日期, actual_return_date DATE COMMENT 实际归还日期, contact_person VARCHAR(50) COMMENT 联系人, contact_phone VARCHAR(20) COMMENT 联系电话, status TINYINT(4) DEFAULT 0 COMMENT 0申请中 1已借出 2已归还 3已驳回, FOREIGN KEY (relic_id) REFERENCES relic(id), KEY idx_borrow_status (status) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT借展记录表;这里有几个值得说明的取舍status用TINYINT而不是VARCHAR是为了后续SQL条件查询时不用引号也不容易写错。展示层由代码翻译成中文。relic_no加UNIQUE约束保证文物编号不重复这是业务硬约束光靠应用层校验不够。全部用InnoDB引擎外键约束加上。很多人为了图省事把外键去掉结果借展记录里出现一个主表不存在的relic_id这就是数据脏了。导入方式有两种。有Navicat之类的图形工具时右键数据库执行SQL文件没有的话用命令行MySQL 8.0版本直接用mysql -u root -p relic_system relic.sql。注意MySQL 5.7和8.0在密码校验规则上有差异8.0默认的caching_sha2_password插件会让老版本JDBC驱动报Public Key Retrieval is not allowed错误JDBC连接串里要加allowPublicKeyRetrievaltrueuseSSLfalse。这个坑在后面的避坑章节会再提到本地装MySQL时也建议顺手把编码设成utf8mb4否则后面到处是乱码。3.4 初始化数据给演示视频准备的数据量空表跑起来页面上没有数据看起来非常空。源码包里的SQL文件一般都会带insert语句但往往只有几条测试数据。做毕设演示的时候至少要保证每种状态在库、借展中、修复中都有几条列表页有分页效果才好看。我一般会写一组INSERT加多条数据INSERT INTO relic (relic_no, name, category, era, level, source, status, location, description) VALUES (RL001, 青铜鼎, 青铜器, 商, 一级, 考古发掘, 0, A区1号柜, 出土于某遗址), (RL002, 青花瓷瓶, 瓷器, 明, 二级, 征集, 0, A区2号柜, 某窑口作品), (RL003, 鎏金佛像, 佛像, 唐, 一级, 捐赠, 2, B区特展柜, 征集自某寺), (RL004, 玉璧, 玉器, 汉, 二级, 考古发掘, 3, 修复室, 正在修复), (RL005, 漆器盘, 漆器, 宋, 三级, 征集, 1, B区3号柜, 保存状态一般), (RL006, 石雕兽, 石刻, 北魏, 二级, 考古发掘, 0, C区户外, 露天存放), (RL007, 金印, 印章, 秦, 一级, 捐赠, 0, A区保险柜, 馆藏精品), (RL008, 帛画, 书画, 东晋, 二级, 征集, 1, C区恒温柜, 需低光照保存), (RL009, 唐三彩马, 陶瓷, 唐, 三级, 考古发掘, 2, B区特展柜, 借展至市博物馆), (RL010, 铁剑, 兵器, 战国, 三级, 考古发掘, 0, C区2号柜, 表面锈蚀已做初步处理);插入后做一个状态统计确认演示数据足够完整SELECT status, COUNT(*) AS cnt FROM relic GROUP BY status;如果某一个状态没有数据列表页的状态筛选就点不出效果。答辩现场演示时评委如果选了一个「修复中」筛选条件结果页面上空空如也气氛会有点尴尬。数据准备的细节点就在这里——不只是让页面有数据而是让每一种筛选条件都有数据。4. SpringMVCMyBatis打通业务链路登录、文物登记与借展的完整实现框架选型和表结构都定了接下来是真正能让项目跑起来的关键——把HTTP请求从浏览器一路送到数据库再返回。这一章以「登录→文物登记→借展申请」三个典型动作为例讲清楚整个链路的代码是怎么串起来的。4.1 登录功能Controller、Service、Mapper三层代码怎么协作登录是每个管理系统第一个要做的功能。它的链路是浏览器提交用户名和密码 → DispatcherServlet分发给LoginController的login方法 → 参数绑定到User对象 → 调用UserService的login方法 → UserMapper执行SQL查数据库 → 返回结果判断。先看Controller层Controller RequestMapping(/user) public class UserController { Autowired private UserService userService; RequestMapping(value /login, method RequestMethod.POST) public String login(RequestParam(username) String username, RequestParam(password) String password, HttpSession session, Model model) { User user userService.login(username, password); if (user ! null) { session.setAttribute(loginUser, user); return redirect:/relic/list; } else { model.addAttribute(msg, 用户名或密码错误); return login; } } RequestMapping(/logout) public String logout(HttpSession session) { session.invalidate(); return redirect:/login.jsp; } }这里的逻辑是前端JSP页面提交的form表单会带username和password两个字段SpringMVC的RequestParam注解把它们绑定到方法参数。登录成功就把User对象放进session后续拦截器取出来做权限判断。失败则把错误消息放到Model里回到登录页显示。再看Service层public interface UserService { User login(String username, String password); } Service public class UserServiceImpl implements UserService { Autowired private UserMapper userMapper; Override public User login(String username, String password) { if (username null || username.isEmpty()) { return null; } String md5Password MD5Util.md5(password); return userMapper.selectByUsernameAndPassword(username, md5Password); } }Service层做两件事一是简单的非空校验二是把明文密码用MD5加密后再去查库。数据库里存的不是明文密码这一点很多毕设项目做错了。如果源码包里的密码字段是明文强烈建议改成MD5不然答辩时老师一句「密码安全怎么保证」就接不上话。Mapper接口和XMLpublic interface UserMapper { User selectByUsernameAndPassword(Param(username) String username, Param(password) String password); }对应的MyBatis映射XML文件select idselectByUsernameAndPassword resultTypecom.example.entity.User SELECT id, username, password, real_name, role_id FROM user WHERE username #{username} AND password #{password} /select这里用的是#{username}预编译占位符不是${username}拼接。用${}的话用户名里传一个 or 11就能绕过登录验证这叫SQL注入。MyBatis默认是预编译但如果你在XML里不小心写了${}照样有风险。搜「SSM登录实现」做到这里的人值得花两分钟确认自己的Mapper文件里没有${}。拦截器控制权限public class LoginInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { HttpSession session request.getSession(); User user (User) session.getAttribute(loginUser); if (user null) { response.sendRedirect(request.getContextPath() /login.jsp); return false; } return true; } }在springmvc-servlet.xml里注册拦截器设置拦截路径mvc:interceptors mvc:interceptor mvc:mapping path/**/ mvc:exclude-mapping path/user/login/ mvc:exclude-mapping path/login.jsp/ mvc:exclude-mapping path/static/**/ /mvc:interceptor /mvc:interceptors这段配置的意思是所有请求先过登录检查登录接口和登录页面本身放行静态资源CSS、JS、图片也放行否则用户还没登录页面就全是裸样式。这个拦截器在源码包里一般都存在改权限需求时优先在这里动手。4.2 文物登记文件上传与表单数据提交文物登记页相对复杂因为往往涉及图片上传。表单里除了文本字段还有一个input typefile。这时Controller方法需要加RequestParam(file) MultipartFile file参数同时springmvc-servlet.xml里要配MultipartResolverbean idmultipartResolver classorg.springframework.web.multipart.commons.CommonsMultipartResolver property namemaxUploadSize value5242880/ property namedefaultEncoding valueUTF-8/ /beanController的保存逻辑RequestMapping(value /save, method RequestMethod.POST) public String save(ModelAttribute(relic) Relic relic, RequestParam(value file, required false) MultipartFile file, HttpServletRequest request) throws IOException { if (file ! null !file.isEmpty()) { String realPath request.getServletContext().getRealPath(/upload); File dir new File(realPath); if (!dir.exists()) { dir.mkdirs(); } String originalFilename file.getOriginalFilename(); String ext originalFilename.substring(originalFilename.lastIndexOf(.)); String newFileName UUID.randomUUID().toString().replace(-, ) ext; file.transferTo(new File(dir, newFileName)); relic.setImageUrl(/upload/ newFileName); } relicService.save(relic); return redirect:/relic/list; }这个保存方法里有几个细节值得注意。文件名用UUID重命名避免中文文件名和重复名导致服务器上文件互相覆盖。比如两个文物都叫「照片.jpg」直接存原名就会发生第二次上传把第一次覆盖掉。requiredfalse表示图片不是必填的——文物登记时不一定马上有照片。保存成功后重定向到列表页避免刷新页面时表单重复提交。再强调一次ModelAttribute直接把请求参数绑定到Relic实体上表单里的input标签name属性要和实体字段名一致。如果不一致绑定结果全是null插入数据库后出现一堆空字段排查起来很头疼。最简单的检查方式是在Controller里加一行System.out.println(relic)打印出来看。4.3 MyBatis动态SQL文物列表的条件查询列表页的核心是分页加多条件筛选。按名称、分类、状态三个条件组合查询MyBatis的动态SQL这时候就派上用场了select idselectByCondition resultMaprelicMap SELECT id, relic_no, name, category, era, level, source, status, location, description, create_time, update_time FROM relic where if testname ! null and name ! AND name LIKE CONCAT(%, #{name}, %) /if if testcategory ! null and category ! AND category #{category} /if if teststatus ! null AND status #{status} /if /where ORDER BY id DESC LIMIT #{offset}, #{pageSize} /selectwhere标签会自动去掉第一个多余的AND这个细节在拼接条件时很重要。三个条件全不填时生成的SQL是SELECT ... FROM relic ORDER BY id DESC LIMIT 0, 10不会出现语法错误。如果你不用where而是手动拼字符串第一个条件前就得小心地写WHERE 11那是一种在工程上被很多人写过的老写法能用但不好看。对应统计条数的SQLselect idcountByCondition resultTypeint SELECT COUNT(*) FROM relic where if testname ! null and name ! AND name LIKE CONCAT(%, #{name}, %) /if if testcategory ! null and category ! AND category #{category} /if if teststatus ! null AND status #{status} /if /where /select分页这层很多毕设直接写LIMIT offset, size手动算offset。如果要做得更工程化可以考虑PageHelper插件在Service层直接PageHelper.startPage(pageNum, pageSize)后面紧跟查询方法插件会拦截SQL自动拼接LIMIT。它的好处是页面上只需要传页码和每页条数不用自己算offset。但注意PageHelper的版本要和MyBatis版本匹配版本冲突时会出现分页不生效的诡异问题这也是一个常见坑。4.4 借展流程事务处理与状态联动借展比登录取录多一个关键点借展记录创建后文物主表的状态要从「在库」改成「借展中」。这两个update必须在一个事务里不然会出现借展记录建立了但文物状态没变的脏数据。Service层的实现套路是这样Service public class BorrowServiceImpl implements BorrowService { Autowired private BorrowMapper borrowMapper; Autowired private RelicMapper relicMapper; Override Transactional(rollbackFor Exception.class) public void startBorrow(BorrowRecord record) { // 1. 检查文物是否在库 Relic relic relicMapper.selectById(record.getRelicId()); if (relic null || relic.getStatus() ! 0) { throw new BusinessException(文物不在库无法借展); } // 2. 插入借展记录 record.setStatus(0); // 申请中 borrowMapper.insert(record); // 3. 更新文物状态为借展中 relic.setStatus(2); relicMapper.updateStatus(relic); } }Transactional(rollbackFor Exception.class)这个注解是事务开关。Spring默认只对RuntimeException回滚受检异常默认不回滚所以显式指定rollbackFor Exception.class可以兜住所有异常。这里面的顺序也有讲究先检查文物状态再插记录最后更新状态。如果插记录成功但更新状态失败事务会整体回滚不会留下半截数据。MySQL的InnoDB引擎才支持事务MyISAM不支持。所以建表时用InnoDB不是随便选的它在事务上的行为直接决定这个借展流程能不能原子执行。查看表引擎用SHOW TABLE STATUS LIKE borrow_record;确认Engine列是InnoDB。5. 常见问题与避坑SSM文物系统从启动到演示的翻车点SSM项目的坑几乎都长在配置和依赖上。下面按现象→原因→解决的格式列几个最常见的翻车现场。5.1 启动Tomcat就报404DispatcherServlet映射路径配错有些同学把Tomcat启动成功后访问项目名却出现404。页面报错日志里能看到类似No mapping found for HTTP request with URI [/relic/list]的信息。这通常是springmvc-servlet.xml里的组件扫描路径没覆盖到Controller包。比如配置的是context:component-scan base-packagecom.example.controller/但实际Controller在com.xxx.controller.admin子包里扫描就漏了。解决方法是把base-package改成上一级包com.example.controller或者用com.example扫描整个项目。在Controller注解的类上检查是否有RequestMapping没有的话方法路由也不生成。另外一个容易忽略的点web.xml里的servlet-mapping如果配的是/那所有请求都会进DispatcherServlet如果配的是*.do则URL必须写成/relic/list.do才进得来两种风格不要混用。5.2 MySQL 8.0连接失败Public Key Retrieval is not allowed现象是启动日志里抛异常提示Public Key Retrieval is not allowed或者Communications link failure。原因是MySQL 8.0默认认证插件改成了caching_sha2_password而项目里用的JDBC驱动版本可能偏老。另外8.0的SSL默认行为跟5.7不一样驱动在第一次连接时需要从服务器取公钥被安全策略拦住了。解决方法是改jdbc.properties里连接串jdbc.drivercom.mysql.cj.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/relic_system?useUnicodetruecharacterEncodingutf8useSSLfalseallowPublicKeyRetrievaltrueserverTimezoneAsia/Shanghai注意时区参数serverTimezone不设的话MySQL 8.0会报The server time zone value Öйú is unrecognized。这个乱码是中文时区名导致的指定成Asia/Shanghai就清净了。另外驱动类要写com.mysql.cj.jdbc.Driver而不是老的com.mysql.jdbc.Driver后者在MySQL 8.0下会直接提示过时。这类问题在本地刚装完MySQL 8.0.44之后尤其常见装完第一件事就是用这个连接串验证连通性。5.3 页面中文乱码JSP和数据库编码不一致现象是列表页面上所有中文都变成问号或乱码。排查路径是数据库表字符集、JDBC连接编码、JSP页面编码、请求响应编码四处必须统一成UTF-8。建表时用了utf8mb4JDBC连接串里加了characterEncodingutf8JSP头部也有pageEncodingUTF-8三个都设了还不够——SpringMVC还需要一个编码过滤器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这个过滤器要声明在web.xml里且url-pattern写成/*不能写成/。/只匹配路径不匹配带参数的请求POST请求的表单参数就不会被转码。forceEncoding设为true表示即使请求里带了自己的编码也强制用UTF-8这一步是很多项目漏掉的。5.4 Mapper接口绑定失败BindingException Invalid bound statement现象是调用Service方法时报错Invalid bound statement (not found): com.xxx.dao.RelicMapper.selectByCondition。原因是Mapper接口和XML文件没有建立绑定关系。检查三处第一XML文件在resources/mapper目录下第二MyBatis配置里mapper-locations指向正确第三XML的namespace值必须是Mapper接口的全限定名。如果是Spring整合MyBatis的配置常见这样bean classorg.mybatis.spring.mapper.MapperScannerConfigurer property namebasePackage valuecom.example.dao/ property namesqlSessionFactoryBeanName valuesqlSessionFactory/ /beanbasePackage写的是Mapper接口所在的包。XML则放在resources/mapper下MyBatis的sqlSessionFactory配置里加上property namemapperLocations valueclasspath:mapper/*.xml/这三处任何一个写了都会冒Invalid bound statement。排查时的窍门是看编译后的target目录里有没有对应的XML文件——Maven默认只把resources下的文件打进classpath如果你把XML放在了java源码目录下需要额外配置resource。检查target的方法ls target/classes/mapper/文件不在就是没编译进去。5.5 演示视频录好了但现场白屏静态资源路径没配对答辩演示时最尴尬的场面是前一天录像还好好的现场打开页面发现CSS全丢了页面光秃秃的登录按钮都没有样式。原因是SpringMVC默认拦截了所有请求静态资源也被DispatcherServlet截走但它找不到对应的Controller直接返回404。解决办法是在springmvc-servlet.xml里放开静态资源映射mvc:default-servlet-handler/ mvc:resources mapping/static/** location/static//第一种用default-servlet-handler交给容器默认Servlet处理第二种显式声明静态资源目录。用了第二种后要注意JSP页面里的资源引用路径要写成/static/css/style.css这种带上下文根的绝对路径反过来用../css/style.css相对路径在多层目录的JSP里容易找错位置。现场演示前用浏览器F12打开Network面板看CSS和JS请求是不是都返回200那里一眼就能看出静态资源有没有被正确加载。6. 把「能跑」变成「能答辩」演示数据、事务验证与交付前自检源码、论文、PPT、开发文档、演示视频都有了但要真的在答辩现场稳住还要做几件事把项目状态从「能跑」提升到「经得起问」。先做一个快速自检五分钟左右过一遍用Navicat导出一份最新的SQL文件确保表结构和数据都在里面。答辩现场重新建库时别发现少了一张表或字段对不上。改掉admin/admin123这种弱口令。哪怕业务上不要求答辩时被点到密码安全至少有话说。检查Tomcat的server.xml里URIEncodingUTF-8是否配置否则GET请求的中文参数会变乱码。确认演示视频重点覆盖登录、列表查询、文物登记、借展操作四个场景时长控制在5分钟以内不要录成15分钟的代码走读。准备好三个「为什么」的答案为什么选SSM不选Spring Boot为什么文物状态用int不用varchar为什么借展操作要放在事务里这三个问题几乎必问。再给一个数据验证的思路不要只在浏览器里点来点去。用一条简单的SQL验证业务流程的闭环。比如借展归还后执行SELECT b.id, b.status AS borrow_status, r.status AS relic_status FROM borrow_record b JOIN relic r ON b.relic_id r.id WHERE b.id 1;正常结果应该是borrow_status2已归还、relic_status0在库。如果两个status不匹配说明Service方法里状态联动的逻辑有bug。这种细节自己先发现比答辩时被动发现要好得多。页面跳转正常有时候是假象数据闭合才是真问题这是我在实际项目里反复得到的教训。如果想让借展流程有更完整的可验证性再补一个场景把一个状态不是「在库」的文物发起借展系统应该拦截并提示「文物不在库」。这个操作在演示时主动做一次反而是加分项因为它证明你的代码不是只会走正常流程异常分支也处理了。最后说到演示本身PPT和开发文档里如果写了「数据一致性保障」「事务边界控制」这些词务必要能指着这条SQL解释清楚。我当年就是只写了套话被评委一问数据怎么验证就卡壳了那种感觉不想让你再经历一次。这个自检流程会花掉你半小时但它比多写十行代码更有价值。毕业设计项目比拼的从来不是代码量而是你能不能把每一层设计决定讲出理由。源码包里的文件是你的起点你往里加入的这些验证细节和数据组织方式才是答辩时让你挺直腰板的底气。希望这篇笔记里的细节能帮到你祝答辩顺利。本文还有配套的精品资源点击获取 SSM+MySQL文物管理系统：从结构设计到事务避坑指南
简介面向计算机相关专业本科及专科毕业设计学生这是一份基于SSM/Mysql的文物管理系统完整项目包覆盖需求分析、总体设计、功能实现、系统测试到验收答辩的全流程可直接作为毕设参考框架。内含源码、论文、答辩PPT、开发文档和演示视频管理员与前台用户双端功能均已实现涉及用户管理、文物分类、文物信息、外借登记、维修记录、留言板、论坛交流及系统管理等典型模块可帮助读者快速搭建可运行的系统并理解前后台交互逻辑。资源共1331个文件以jsp动态页面、java后台逻辑、js交互脚本、css样式、png/jpg图片素材为主附带sql数据库脚本与mp4演示录屏压缩包整体68.17MB目录结构完整清晰便于逐项检索。目前已有64人学习下载适合需要成套毕设方案、论文写作范文或答辩演示素材的开发者。1. 这套SSMMysql的文物管理系统值不值得拿来改很多计算机专业的学生第一次接触SSM项目是在毕业设计这个节点。文物管理系统这个题目不像电商、博客那样烂大街又不像AI算法那样需要数学功底它天然适合用SSM框架来落地文物的登记、出入库、借展、修复记录、用户权限核心就是一组围绕数据对象的增删改查流程清晰能把Spring、SpringMVC、MyBatis三者的整合要点完整串起来。如果你拿到的是一份带源码、论文、PPT、开发文档和演示视频的压缩包真正的问题不是「能不能跑」而是「怎么把它变成你自己的项目并在答辩时讲明白」。这篇笔记我会沿着这套项目的骨架从数据库表设计讲到SpringMVC的请求流转再到部署验证与演示技巧穿插真实踩过的坑。适合三类人打算用现成源码交毕设的学生、想快速上手SSM整合的初级开发者、以及需要把管理系统模板改造成实际业务的后端入门者。2. SSM整合的文物管理系统框架选型、模块划分与工程结构这一章把项目的地基讲清楚。拿到源码包后第一个动作不是双击IDEA而是先看pom.xml和目录结构理解这个项目的骨架。很多新人上来就找applicationContext.xml在哪结果被一堆配置文件绕晕。实际上SSM项目就三个层次表现层SpringMVC、业务层Spring Service、持久层MyBatis对应的代码包结构和配置文件的职责是固定的。2.1 选型逻辑Spring、SpringMVC、MyBatis各自管哪一段文物管理系统是一个典型的单体Web应用。选SSM而不选Spring Boot不是因为Boot不好而是这套组合在毕业设计语境下有一个独特优势配置是显式的每一条bean、每一个扫描路径都是自己写的答辩时「框架原理」部分有东西可讲。Spring Boot的自动配置固然香但面试官追问「为什么这个注解就能启动一个Web应用」时说不清楚反而减分。三层框架的分工用一个就好记的比喻Spring是后勤部统一管理对象的创建和依赖关系SpringMVC是前台接待负责接收HTTP请求、找对处理人、把结果送回浏览器MyBatis是档案室负责查数据库表把记录翻译成Java对象。在一个文物管理请求里浏览器提交「查询所有青铜器」的GET请求SpringMVC把URL映到对应Controller方法Controller调用ServiceService调用MapperMapper执行SQL结果一层层返回最后JSP渲染成HTML表格。理解这条链路后面所有调试都有方向。报错时先判断是哪一层出的问题URL都进不了Controller是SpringMVC配置Service里抛异常是业务逻辑SQL执行报错是MyBatis和表结构的事。分清了排查效率直接翻倍。2.2 业务模块划分五个核心域的边界在哪一套完整的文物管理系统模块划分一般围绕五个核心业务域展开。对照源码包里的Controller和Service你会发现它们的包名就是按这个维度拆的业务域核心实体典型功能点对应数据表系统管理用户、角色登录、登出、权限分配user、role、user_role文物信息管理文物登记、修改、删除、列表查询、详情relic出入库管理文物、出入库单入库登记、出库登记、库存查询relic、inout_record借展管理借展记录借展申请、审批、归还、过期提醒borrow_record、relic修复管理修复记录修复登记、修复历史、费用统计repair_record、relic实际源码包里文物信息管理这一组代码量最大改动优先级也最高。加字段、调页面、改SQL都在这块动基本不会牵动其他模块。这是一个成熟的SSM管理系统的模块化设计思路通过包名区分业务域而不是把几十个方法全堆在一个Controller里。拿到源码后先看每个Controller的RequestMapping前缀就能快速画出一张请求路由表。2.3 工程结构源码包里的目录各自是什么一般这类项目用Maven构建标准结构是src/main/java ├── com/xxx/controller # SpringMVC控制器 ├── com/xxx/service # 业务接口 ├── com/xxx/service/impl # 业务实现 ├── com/xxx/dao # MyBatis Mapper接口 ├── com/xxx/entity # 数据库对应的实体类 └── com/xxx/config # 配置类 src/main/resources ├── applicationContext.xml # Spring核心配置 ├── springmvc-servlet.xml # SpringMVC配置 ├── mybatis-config.xml # MyBatis配置 ├── mapper # 各表的Mapper XML └── jdbc.properties # 数据库连接信息 src/main/webapp ├── WEB-INF/web.xml # 应用入口配置 ├── WEB-INF/views # JSP页面 └── static # JS/CSS/图片等静态资源这里最关键是jdbc.properties里的数据库连接配置。把URL、用户名、密码改成你本地MySQL的是项目启动的第一步。很多同学拿到项目以为要先配Spring的bean其实第一步永远是先让数据库连上。后面章节会细化到具体怎么改、怎么看配置有没有生效。3. 用MySQL搭建文物数据模型核心表结构、建表SQL与字段边界数据库表设计是文物管理系统的地基。实地去看那些跑不起来的毕设项目一半以上不是代码问题而是表结构里外键、主键、字段类型不匹配导致Mapper查询结果映射失败。这一章直接给出一套可复用的建表SQL并讲清楚每个字段为什么这么设。3.1 文物主表状态字段怎么定义才能撑起全流程文物主表是整个系统的核心一般命名为relic或者cultural_artifact。字段一般包括id、relic_no文物编号、name名称、category分类、era年代、level级别、source来源、status状态、location存放位置、description描述、create_time、update_time。状态字段值得展开。文物的生命周期有「在库、出库、借展中、修复中、已下架」几种如果用字符串存后面做统计和条件查询就要写一堆if else。常见做法是用int枚举0表示在库1表示出库2表示借展中3表示修复中。MyBatis的resultMap里再做typeHandler映射把int转成中文显示。如果嫌麻烦直接用字符串加UNIQUE约束也能跑但在报表统计时不太方便WHERE status2和WHERE statusborrowing后者写错了引号就是一场排查事故。文物编号字段relic_no必须加唯一约束。这是业务硬规则一件文物编号在整个系统里只能出现一次。光靠应用层代码先查后插挡不住并发场景两个请求同时查不到编号再同时插入数据就脏了。数据库层面的UNIQUE是最后一道防线必须有。3.2 借展、修复、用户权限三张关联表的字段设计借展记录表记录一次文物的外展过程字段包括id、relic_id外键指向文物主表、borrow_unit借展单位、borrow_date借出日期、return_date计划归还日期、actual_return_date实际归还日期、contact_person联系人、contact_phone联系电话、status0申请中、1已借出、2已归还、3已驳回。归还后status从「借展中」回到「在库」这里的核心是事务更新借展表状态的同时要同步更新文物主表的状态两个SQL必须在一个事务里。修复记录表id、relic_id、repair_date、repair_content、repair_org修复单位、cost修复费用、repair_person修复人。这张表相对简单但cost字段要注意用DECIMAL(10,2)而不是FLOAT浮点数存金额会有精度问题这在MySQL里是常识性坑。用户权限这块SSM项目里最简单的做法是「用户表角色表用户角色关联表」三张表。用户表存用户名、密码MD5加密后的、真实姓名、联系电话角色表存角色名称和角色描述关联表把用户和角色关联起来。权限控制用SpringMVC的拦截器实现登录后把用户对象放session拦截器里校验角色角色是管理员的放行否则跳到无权限页面。3.3 建表SQL与导入在Navicat和命令行下怎么执行直接给一套可以在MySQL 5.7/8.0下跑的建表SQL。-- 创建数据库 CREATE DATABASE IF NOT EXISTS relic_system DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; USE relic_system; -- 文物主表 CREATE TABLE relic ( id INT PRIMARY KEY AUTO_INCREMENT, relic_no VARCHAR(50) NOT NULL UNIQUE COMMENT 文物编号, name VARCHAR(100) NOT NULL COMMENT 文物名称, category VARCHAR(50) COMMENT 分类, era VARCHAR(50) COMMENT 年代, level VARCHAR(20) COMMENT 级别, source VARCHAR(100) COMMENT 来源, status TINYINT(4) DEFAULT 0 COMMENT 0在库 1出库 2借展中 3修复中, location VARCHAR(100) COMMENT 存放位置, description TEXT COMMENT 描述, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, update_time DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, KEY idx_category (category), KEY idx_status (status) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT文物信息表; -- 借展记录表 CREATE TABLE borrow_record ( id INT PRIMARY KEY AUTO_INCREMENT, relic_id INT NOT NULL COMMENT 关联的文物ID, borrow_unit VARCHAR(150) COMMENT 借展单位, borrow_date DATE COMMENT 借出日期, return_date DATE COMMENT 计划归还日期, actual_return_date DATE COMMENT 实际归还日期, contact_person VARCHAR(50) COMMENT 联系人, contact_phone VARCHAR(20) COMMENT 联系电话, status TINYINT(4) DEFAULT 0 COMMENT 0申请中 1已借出 2已归还 3已驳回, FOREIGN KEY (relic_id) REFERENCES relic(id), KEY idx_borrow_status (status) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT借展记录表;这里有几个值得说明的取舍status用TINYINT而不是VARCHAR是为了后续SQL条件查询时不用引号也不容易写错。展示层由代码翻译成中文。relic_no加UNIQUE约束保证文物编号不重复这是业务硬约束光靠应用层校验不够。全部用InnoDB引擎外键约束加上。很多人为了图省事把外键去掉结果借展记录里出现一个主表不存在的relic_id这就是数据脏了。导入方式有两种。有Navicat之类的图形工具时右键数据库执行SQL文件没有的话用命令行MySQL 8.0版本直接用mysql -u root -p relic_system relic.sql。注意MySQL 5.7和8.0在密码校验规则上有差异8.0默认的caching_sha2_password插件会让老版本JDBC驱动报Public Key Retrieval is not allowed错误JDBC连接串里要加allowPublicKeyRetrievaltrueuseSSLfalse。这个坑在后面的避坑章节会再提到本地装MySQL时也建议顺手把编码设成utf8mb4否则后面到处是乱码。3.4 初始化数据给演示视频准备的数据量空表跑起来页面上没有数据看起来非常空。源码包里的SQL文件一般都会带insert语句但往往只有几条测试数据。做毕设演示的时候至少要保证每种状态在库、借展中、修复中都有几条列表页有分页效果才好看。我一般会写一组INSERT加多条数据INSERT INTO relic (relic_no, name, category, era, level, source, status, location, description) VALUES (RL001, 青铜鼎, 青铜器, 商, 一级, 考古发掘, 0, A区1号柜, 出土于某遗址), (RL002, 青花瓷瓶, 瓷器, 明, 二级, 征集, 0, A区2号柜, 某窑口作品), (RL003, 鎏金佛像, 佛像, 唐, 一级, 捐赠, 2, B区特展柜, 征集自某寺), (RL004, 玉璧, 玉器, 汉, 二级, 考古发掘, 3, 修复室, 正在修复), (RL005, 漆器盘, 漆器, 宋, 三级, 征集, 1, B区3号柜, 保存状态一般), (RL006, 石雕兽, 石刻, 北魏, 二级, 考古发掘, 0, C区户外, 露天存放), (RL007, 金印, 印章, 秦, 一级, 捐赠, 0, A区保险柜, 馆藏精品), (RL008, 帛画, 书画, 东晋, 二级, 征集, 1, C区恒温柜, 需低光照保存), (RL009, 唐三彩马, 陶瓷, 唐, 三级, 考古发掘, 2, B区特展柜, 借展至市博物馆), (RL010, 铁剑, 兵器, 战国, 三级, 考古发掘, 0, C区2号柜, 表面锈蚀已做初步处理);插入后做一个状态统计确认演示数据足够完整SELECT status, COUNT(*) AS cnt FROM relic GROUP BY status;如果某一个状态没有数据列表页的状态筛选就点不出效果。答辩现场演示时评委如果选了一个「修复中」筛选条件结果页面上空空如也气氛会有点尴尬。数据准备的细节点就在这里——不只是让页面有数据而是让每一种筛选条件都有数据。4. SpringMVCMyBatis打通业务链路登录、文物登记与借展的完整实现框架选型和表结构都定了接下来是真正能让项目跑起来的关键——把HTTP请求从浏览器一路送到数据库再返回。这一章以「登录→文物登记→借展申请」三个典型动作为例讲清楚整个链路的代码是怎么串起来的。4.1 登录功能Controller、Service、Mapper三层代码怎么协作登录是每个管理系统第一个要做的功能。它的链路是浏览器提交用户名和密码 → DispatcherServlet分发给LoginController的login方法 → 参数绑定到User对象 → 调用UserService的login方法 → UserMapper执行SQL查数据库 → 返回结果判断。先看Controller层Controller RequestMapping(/user) public class UserController { Autowired private UserService userService; RequestMapping(value /login, method RequestMethod.POST) public String login(RequestParam(username) String username, RequestParam(password) String password, HttpSession session, Model model) { User user userService.login(username, password); if (user ! null) { session.setAttribute(loginUser, user); return redirect:/relic/list; } else { model.addAttribute(msg, 用户名或密码错误); return login; } } RequestMapping(/logout) public String logout(HttpSession session) { session.invalidate(); return redirect:/login.jsp; } }这里的逻辑是前端JSP页面提交的form表单会带username和password两个字段SpringMVC的RequestParam注解把它们绑定到方法参数。登录成功就把User对象放进session后续拦截器取出来做权限判断。失败则把错误消息放到Model里回到登录页显示。再看Service层public interface UserService { User login(String username, String password); } Service public class UserServiceImpl implements UserService { Autowired private UserMapper userMapper; Override public User login(String username, String password) { if (username null || username.isEmpty()) { return null; } String md5Password MD5Util.md5(password); return userMapper.selectByUsernameAndPassword(username, md5Password); } }Service层做两件事一是简单的非空校验二是把明文密码用MD5加密后再去查库。数据库里存的不是明文密码这一点很多毕设项目做错了。如果源码包里的密码字段是明文强烈建议改成MD5不然答辩时老师一句「密码安全怎么保证」就接不上话。Mapper接口和XMLpublic interface UserMapper { User selectByUsernameAndPassword(Param(username) String username, Param(password) String password); }对应的MyBatis映射XML文件select idselectByUsernameAndPassword resultTypecom.example.entity.User SELECT id, username, password, real_name, role_id FROM user WHERE username #{username} AND password #{password} /select这里用的是#{username}预编译占位符不是${username}拼接。用${}的话用户名里传一个 or 11就能绕过登录验证这叫SQL注入。MyBatis默认是预编译但如果你在XML里不小心写了${}照样有风险。搜「SSM登录实现」做到这里的人值得花两分钟确认自己的Mapper文件里没有${}。拦截器控制权限public class LoginInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { HttpSession session request.getSession(); User user (User) session.getAttribute(loginUser); if (user null) { response.sendRedirect(request.getContextPath() /login.jsp); return false; } return true; } }在springmvc-servlet.xml里注册拦截器设置拦截路径mvc:interceptors mvc:interceptor mvc:mapping path/**/ mvc:exclude-mapping path/user/login/ mvc:exclude-mapping path/login.jsp/ mvc:exclude-mapping path/static/**/ /mvc:interceptor /mvc:interceptors这段配置的意思是所有请求先过登录检查登录接口和登录页面本身放行静态资源CSS、JS、图片也放行否则用户还没登录页面就全是裸样式。这个拦截器在源码包里一般都存在改权限需求时优先在这里动手。4.2 文物登记文件上传与表单数据提交文物登记页相对复杂因为往往涉及图片上传。表单里除了文本字段还有一个input typefile。这时Controller方法需要加RequestParam(file) MultipartFile file参数同时springmvc-servlet.xml里要配MultipartResolverbean idmultipartResolver classorg.springframework.web.multipart.commons.CommonsMultipartResolver property namemaxUploadSize value5242880/ property namedefaultEncoding valueUTF-8/ /beanController的保存逻辑RequestMapping(value /save, method RequestMethod.POST) public String save(ModelAttribute(relic) Relic relic, RequestParam(value file, required false) MultipartFile file, HttpServletRequest request) throws IOException { if (file ! null !file.isEmpty()) { String realPath request.getServletContext().getRealPath(/upload); File dir new File(realPath); if (!dir.exists()) { dir.mkdirs(); } String originalFilename file.getOriginalFilename(); String ext originalFilename.substring(originalFilename.lastIndexOf(.)); String newFileName UUID.randomUUID().toString().replace(-, ) ext; file.transferTo(new File(dir, newFileName)); relic.setImageUrl(/upload/ newFileName); } relicService.save(relic); return redirect:/relic/list; }这个保存方法里有几个细节值得注意。文件名用UUID重命名避免中文文件名和重复名导致服务器上文件互相覆盖。比如两个文物都叫「照片.jpg」直接存原名就会发生第二次上传把第一次覆盖掉。requiredfalse表示图片不是必填的——文物登记时不一定马上有照片。保存成功后重定向到列表页避免刷新页面时表单重复提交。再强调一次ModelAttribute直接把请求参数绑定到Relic实体上表单里的input标签name属性要和实体字段名一致。如果不一致绑定结果全是null插入数据库后出现一堆空字段排查起来很头疼。最简单的检查方式是在Controller里加一行System.out.println(relic)打印出来看。4.3 MyBatis动态SQL文物列表的条件查询列表页的核心是分页加多条件筛选。按名称、分类、状态三个条件组合查询MyBatis的动态SQL这时候就派上用场了select idselectByCondition resultMaprelicMap SELECT id, relic_no, name, category, era, level, source, status, location, description, create_time, update_time FROM relic where if testname ! null and name ! AND name LIKE CONCAT(%, #{name}, %) /if if testcategory ! null and category ! AND category #{category} /if if teststatus ! null AND status #{status} /if /where ORDER BY id DESC LIMIT #{offset}, #{pageSize} /selectwhere标签会自动去掉第一个多余的AND这个细节在拼接条件时很重要。三个条件全不填时生成的SQL是SELECT ... FROM relic ORDER BY id DESC LIMIT 0, 10不会出现语法错误。如果你不用where而是手动拼字符串第一个条件前就得小心地写WHERE 11那是一种在工程上被很多人写过的老写法能用但不好看。对应统计条数的SQLselect idcountByCondition resultTypeint SELECT COUNT(*) FROM relic where if testname ! null and name ! AND name LIKE CONCAT(%, #{name}, %) /if if testcategory ! null and category ! AND category #{category} /if if teststatus ! null AND status #{status} /if /where /select分页这层很多毕设直接写LIMIT offset, size手动算offset。如果要做得更工程化可以考虑PageHelper插件在Service层直接PageHelper.startPage(pageNum, pageSize)后面紧跟查询方法插件会拦截SQL自动拼接LIMIT。它的好处是页面上只需要传页码和每页条数不用自己算offset。但注意PageHelper的版本要和MyBatis版本匹配版本冲突时会出现分页不生效的诡异问题这也是一个常见坑。4.4 借展流程事务处理与状态联动借展比登录取录多一个关键点借展记录创建后文物主表的状态要从「在库」改成「借展中」。这两个update必须在一个事务里不然会出现借展记录建立了但文物状态没变的脏数据。Service层的实现套路是这样Service public class BorrowServiceImpl implements BorrowService { Autowired private BorrowMapper borrowMapper; Autowired private RelicMapper relicMapper; Override Transactional(rollbackFor Exception.class) public void startBorrow(BorrowRecord record) { // 1. 检查文物是否在库 Relic relic relicMapper.selectById(record.getRelicId()); if (relic null || relic.getStatus() ! 0) { throw new BusinessException(文物不在库无法借展); } // 2. 插入借展记录 record.setStatus(0); // 申请中 borrowMapper.insert(record); // 3. 更新文物状态为借展中 relic.setStatus(2); relicMapper.updateStatus(relic); } }Transactional(rollbackFor Exception.class)这个注解是事务开关。Spring默认只对RuntimeException回滚受检异常默认不回滚所以显式指定rollbackFor Exception.class可以兜住所有异常。这里面的顺序也有讲究先检查文物状态再插记录最后更新状态。如果插记录成功但更新状态失败事务会整体回滚不会留下半截数据。MySQL的InnoDB引擎才支持事务MyISAM不支持。所以建表时用InnoDB不是随便选的它在事务上的行为直接决定这个借展流程能不能原子执行。查看表引擎用SHOW TABLE STATUS LIKE borrow_record;确认Engine列是InnoDB。5. 常见问题与避坑SSM文物系统从启动到演示的翻车点SSM项目的坑几乎都长在配置和依赖上。下面按现象→原因→解决的格式列几个最常见的翻车现场。5.1 启动Tomcat就报404DispatcherServlet映射路径配错有些同学把Tomcat启动成功后访问项目名却出现404。页面报错日志里能看到类似No mapping found for HTTP request with URI [/relic/list]的信息。这通常是springmvc-servlet.xml里的组件扫描路径没覆盖到Controller包。比如配置的是context:component-scan base-packagecom.example.controller/但实际Controller在com.xxx.controller.admin子包里扫描就漏了。解决方法是把base-package改成上一级包com.example.controller或者用com.example扫描整个项目。在Controller注解的类上检查是否有RequestMapping没有的话方法路由也不生成。另外一个容易忽略的点web.xml里的servlet-mapping如果配的是/那所有请求都会进DispatcherServlet如果配的是*.do则URL必须写成/relic/list.do才进得来两种风格不要混用。5.2 MySQL 8.0连接失败Public Key Retrieval is not allowed现象是启动日志里抛异常提示Public Key Retrieval is not allowed或者Communications link failure。原因是MySQL 8.0默认认证插件改成了caching_sha2_password而项目里用的JDBC驱动版本可能偏老。另外8.0的SSL默认行为跟5.7不一样驱动在第一次连接时需要从服务器取公钥被安全策略拦住了。解决方法是改jdbc.properties里连接串jdbc.drivercom.mysql.cj.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/relic_system?useUnicodetruecharacterEncodingutf8useSSLfalseallowPublicKeyRetrievaltrueserverTimezoneAsia/Shanghai注意时区参数serverTimezone不设的话MySQL 8.0会报The server time zone value Öйú is unrecognized。这个乱码是中文时区名导致的指定成Asia/Shanghai就清净了。另外驱动类要写com.mysql.cj.jdbc.Driver而不是老的com.mysql.jdbc.Driver后者在MySQL 8.0下会直接提示过时。这类问题在本地刚装完MySQL 8.0.44之后尤其常见装完第一件事就是用这个连接串验证连通性。5.3 页面中文乱码JSP和数据库编码不一致现象是列表页面上所有中文都变成问号或乱码。排查路径是数据库表字符集、JDBC连接编码、JSP页面编码、请求响应编码四处必须统一成UTF-8。建表时用了utf8mb4JDBC连接串里加了characterEncodingutf8JSP头部也有pageEncodingUTF-8三个都设了还不够——SpringMVC还需要一个编码过滤器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这个过滤器要声明在web.xml里且url-pattern写成/*不能写成/。/只匹配路径不匹配带参数的请求POST请求的表单参数就不会被转码。forceEncoding设为true表示即使请求里带了自己的编码也强制用UTF-8这一步是很多项目漏掉的。5.4 Mapper接口绑定失败BindingException Invalid bound statement现象是调用Service方法时报错Invalid bound statement (not found): com.xxx.dao.RelicMapper.selectByCondition。原因是Mapper接口和XML文件没有建立绑定关系。检查三处第一XML文件在resources/mapper目录下第二MyBatis配置里mapper-locations指向正确第三XML的namespace值必须是Mapper接口的全限定名。如果是Spring整合MyBatis的配置常见这样bean classorg.mybatis.spring.mapper.MapperScannerConfigurer property namebasePackage valuecom.example.dao/ property namesqlSessionFactoryBeanName valuesqlSessionFactory/ /beanbasePackage写的是Mapper接口所在的包。XML则放在resources/mapper下MyBatis的sqlSessionFactory配置里加上property namemapperLocations valueclasspath:mapper/*.xml/这三处任何一个写了都会冒Invalid bound statement。排查时的窍门是看编译后的target目录里有没有对应的XML文件——Maven默认只把resources下的文件打进classpath如果你把XML放在了java源码目录下需要额外配置resource。检查target的方法ls target/classes/mapper/文件不在就是没编译进去。5.5 演示视频录好了但现场白屏静态资源路径没配对答辩演示时最尴尬的场面是前一天录像还好好的现场打开页面发现CSS全丢了页面光秃秃的登录按钮都没有样式。原因是SpringMVC默认拦截了所有请求静态资源也被DispatcherServlet截走但它找不到对应的Controller直接返回404。解决办法是在springmvc-servlet.xml里放开静态资源映射mvc:default-servlet-handler/ mvc:resources mapping/static/** location/static//第一种用default-servlet-handler交给容器默认Servlet处理第二种显式声明静态资源目录。用了第二种后要注意JSP页面里的资源引用路径要写成/static/css/style.css这种带上下文根的绝对路径反过来用../css/style.css相对路径在多层目录的JSP里容易找错位置。现场演示前用浏览器F12打开Network面板看CSS和JS请求是不是都返回200那里一眼就能看出静态资源有没有被正确加载。6. 把「能跑」变成「能答辩」演示数据、事务验证与交付前自检源码、论文、PPT、开发文档、演示视频都有了但要真的在答辩现场稳住还要做几件事把项目状态从「能跑」提升到「经得起问」。先做一个快速自检五分钟左右过一遍用Navicat导出一份最新的SQL文件确保表结构和数据都在里面。答辩现场重新建库时别发现少了一张表或字段对不上。改掉admin/admin123这种弱口令。哪怕业务上不要求答辩时被点到密码安全至少有话说。检查Tomcat的server.xml里URIEncodingUTF-8是否配置否则GET请求的中文参数会变乱码。确认演示视频重点覆盖登录、列表查询、文物登记、借展操作四个场景时长控制在5分钟以内不要录成15分钟的代码走读。准备好三个「为什么」的答案为什么选SSM不选Spring Boot为什么文物状态用int不用varchar为什么借展操作要放在事务里这三个问题几乎必问。再给一个数据验证的思路不要只在浏览器里点来点去。用一条简单的SQL验证业务流程的闭环。比如借展归还后执行SELECT b.id, b.status AS borrow_status, r.status AS relic_status FROM borrow_record b JOIN relic r ON b.relic_id r.id WHERE b.id 1;正常结果应该是borrow_status2已归还、relic_status0在库。如果两个status不匹配说明Service方法里状态联动的逻辑有bug。这种细节自己先发现比答辩时被动发现要好得多。页面跳转正常有时候是假象数据闭合才是真问题这是我在实际项目里反复得到的教训。如果想让借展流程有更完整的可验证性再补一个场景把一个状态不是「在库」的文物发起借展系统应该拦截并提示「文物不在库」。这个操作在演示时主动做一次反而是加分项因为它证明你的代码不是只会走正常流程异常分支也处理了。最后说到演示本身PPT和开发文档里如果写了「数据一致性保障」「事务边界控制」这些词务必要能指着这条SQL解释清楚。我当年就是只写了套话被评委一问数据怎么验证就卡壳了那种感觉不想让你再经历一次。这个自检流程会花掉你半小时但它比多写十行代码更有价值。毕业设计项目比拼的从来不是代码量而是你能不能把每一层设计决定讲出理由。源码包里的文件是你的起点你往里加入的这些验证细节和数据组织方式才是答辩时让你挺直腰板的底气。希望这篇笔记里的细节能帮到你祝答辩顺利。本文还有配套的精品资源点击获取