1. 选题定位与SSM框架选型逻辑每年到了毕业季总有一批计算机专业的同学为选题发愁尤其是那些既要写代码、又要写论文、还要准备答辩的“全流程”选手。如果你打开各类毕设题目列表会发现“基于SSM的某某管理系统”出现频率极高。为什么因为这套技术栈在学校教学体系里地位太稳固了网上资料全、参考代码多、老师也认可更重要的是——它确实足够简单直接适合在有限时间内产出一个完整可演示的项目。今天我就拿“高校共享单车管理系统”这个题目当例子把整个从零到一的过程掰开揉碎讲一遍。先说清楚这个题目到底要做什么。高校共享单车管理系统本质上就是一个针对校园内部单车资源的业务管理系统。它需要覆盖用户注册登录、单车信息录入与查询、借车还车流程、费用计算、报修处理、后台数据统计这些基础功能模块。对比市面上共享单车App这个项目不需要做GPS定位、扫码开锁、实时计费这种复杂功能核心反而落在“信息管理”和“流程审批”上。这正是SSM框架最擅长的事情——把数据库里的一张张数据表通过一套规范的增删改查流程变成可以被人操作的业务功能。那为什么选SSM而不是Spring Boot这里面有个很现实的原因很多高校的课程大纲还停留在SSM阶段答辩时老师也会更习惯用SSM的视角来问问题。而且SSM的配置过程本身就是一次很好的学习机会——Spring的IoC容器、Spring MVC的请求分发、MyBatis的SQL映射这三者之间如何协同工作理解了这套流程之后转Spring Boot会非常轻松。反过来如果一开始就用Spring Boot很多底层配置被框架自动完成了反而不容易讲清楚原理。再说回题目本身。共享单车有几个典型的业务特点资源有状态可用、已借出、维修中用户有角色学生、管理员操作有流程借车、还车、结算。这三个特点决定了数据表的设计逻辑、接口的权限控制逻辑、页面交互的展示逻辑。在接下来的内容里我会按照实际开发的顺序先做数据库设计再搭SSM框架然后逐个实现功能模块最后补上论文和演示相关的准备完整走一遍整个项目周期。2. 系统整体架构与功能模块拆解2.1 三层架构到底是怎么分层的SSM对应的是三个独立框架的整合Spring负责对象管理和事务控制Spring MVC负责接收HTTP请求并跳转视图MyBatis负责数据库层的SQL映射。分包结构上通常表现为controller、service、dao或者叫mapper三层。新手最容易犯的错误是把业务逻辑全部写在Controller里结果Controller里几百行代码Service层变成空壳。正确的做法是Controller只做参数接收、调用Service返回结果、然后指定跳转页面这三件事。Service层才是业务逻辑的核心比如借车的时候要检查单车状态、判断用户是否已经借过车、计算费用、更新库存这一串流程的编排全在Service里面。DAO层是最基础的SQL操作一个方法对应一条数据库操作不应该出现跨表复杂业务逻辑。分工清晰之后项目代码量和可维护性都会提升很多。以“用户借车”这个操作为例Controller在收到请求后从session里取出当前登录用户ID再从页面参数里拿到车辆ID这两步是在Controller层做的基础参数准备。接着Controller调用Service层的borrowBike方法实际的“检查单车是否可用”和“确认用户没有未还车辆”会在Service的方法内部通过多次dao层调用来完成。最终返回一个借车成功或失败的结果Controller根据这个结果决定是跳转到成功页面还是把错误信息带回页面。2.2 系统的功能模块地图高校共享单车管理系统的功能模块可以拆成两个视角来看。一个视角是面向管理员的后台管理另一个是面向学生的前台操作。两者通过角色权限自然隔离登录的时候区分用户类型不同角色登录后跳转到不同的主页也看到不同的菜单项。管理员端核心功能包括用户管理对学生账号的启用和禁用、车辆管理新增车辆、修改车辆信息、标记车辆维修报废、订单管理查看所有租借记录、处理异常订单、报修管理派单处理学生提交的故障报修、统计报表查看车辆利用率、热门车辆排行、借还趋势图。学生端核心功能包括注册登录、浏览车辆列表、按状态或位置筛选车辆、发起借车、执行还车并结算费用、提交故障报修、查看个人历史记录。为了把这个项目的业务逻辑串起来还需要设置一个核心概念——“单车状态”。它在整个系统里扮演的角色类似于电商系统里的“订单状态”所有核心流程都围绕这个状态的变化来展开。单车状态分为1表示可用2表示已借出3表示维修中。当学生借车时状态从1变成2还车时从2变成1管理员把车标记为维修时从1或者2变成3。任何一步操作如果状态不匹配系统都要给出明确提示。这个状态机的设计是整个项目代码实现时最需要留意的地方。2.3 两种常见页面设计模式前台页面我用的是列表加弹窗的组合车辆列表页面通过表格展示每一辆单车的编号、位置、租金、状态点击“借车”按钮时先判断登录状态已登录就直接调接口未登录则跳转到登录页。车辆详情不做单独页面通过弹窗显示信息这样减少页面数量也方便在答辩演示时快速操作。后台页面我用的是经典的顶部导航加左侧菜单布局。左侧菜单分为车辆管理、用户管理、订单管理、报修管理、数据统计几个入口每个入口对应一个列表页面。列表页面的后端实现套路很统一写一个分页查询的Service方法接收pageNum和pageSize参数返回PageInfo对象前端通过JSP的c:forEach标签遍历数据列表底部放分页按钮每个按钮的后面带着当前页码参数。3. 数据库设计与核心表关系梳理3.1 数据表整体规划数据库设计是这类管理系统项目的重中之重。表结构如果设计得好后续写代码会非常顺畅如果表结构一开始没想清楚开发到中期会不断回头改表非常影响心态。以这个共享单车系统为例我用MySQL建库总共设计了六张核心表用户表t_user、单车表t_bike、租借记录表t_rental、报修表t_repair、车辆位置表t_location、管理员日志表t_log。在实际开发时可按需调整字段但下面这些核心字段值得提前列清楚。用户表的主键是自增ID字段包括username、password、realName、studentNo学号、phone、role1管理员、2学生、status1正常、0禁用、createTime。角色字段用的int类型而不是字符串是为了在后面用拦截器做权限判断时更方便。密码字段我建议存MD5加密后的值虽然这个项目没有作很高的安全要求但至少不要让明文密码直接出现在数据库里这在写论文时也可以作为一个亮点描述。单车表的主键是bikeId字段包括bikeNo车辆编号、locationId所在位置ID、status1可用、2已借出、3维修中、bikeModel车辆型号、purchaseDate购买日期、dailyRent每日租金、remark备注。车辆编号要设计成唯一索引方便人工扫码或者输入时快速定位车辆。租金字段采用decimal类型设置默认值避免在代码里做空值判断。租借记录表是业务核心字段包括rentalId、userId、bikeId、rentalTime借车时间、returnTime还车时间、rentalDuration租借时长按小时计算、totalCost总费用、status1进行中、2已完成、3异常。这个表必须同时建索引在userId和bikeId上原因后面会提到。3.2 表关联关系与设计要点位置表单独拆出来而不是把位置字段直接写在单车表里看似多了一次关联查询实际上是为了后续扩展方便。比如学校后期要增加停车点只需要在位置表加一条记录不用修改单车表结构。位置表的字段很简单locationId、locationName、locationDesc。单车表通过外键locationId关联这个表。报修表和租借记录表之间用rentalId关联。报修表的字段包括repairId、rentalId、bikeId、userId、repairReason报修原因、repairStatus1待处理、2处理中、3已完成、repairTime、completeTime。管理员在处理报修时需要看到这条记录的关联租借信息和车辆信息所以查询的时候要用三表联查。管理员日志表主要用于记录管理员的关键操作谁在什么时间对哪辆车做了什么操作。这张表不是业务必需但对论文里的“系统安全性设计”章节很有帮助。答辩时候老师会问“有没有做操作日志记录”有这张表就能答上。3.3 建表语句与初始化数据以下是核心的建表SQL以及部分初始化数据在开发环境可以直接执行。需要注意设置好字符集为utf8mb4否则存入中文数据会出现乱码问题。-- 创建数据库 CREATE DATABASE IF NOT EXISTS campus_bike DEFAULT CHARSET utf8mb4 COLLATE utf8mb4_general_ci; USE campus_bike; -- 用户表 CREATE TABLE t_user ( user_id INT PRIMARY KEY AUTO_INCREMENT COMMENT 用户ID, username VARCHAR(50) NOT NULL UNIQUE COMMENT 登录名, password VARCHAR(64) NOT NULL COMMENT 密码(MD5加密), real_name VARCHAR(20) COMMENT 真实姓名, student_no VARCHAR(20) COMMENT 学号, phone VARCHAR(11) COMMENT 联系电话, role TINYINT DEFAULT 2 COMMENT 角色:1管理员,2学生, status TINYINT DEFAULT 1 COMMENT 状态:1正常,0禁用, create_time DATETIME DEFAULT CURRENT_TIMESTAMP ) COMMENT 用户表; -- 车位表 CREATE TABLE t_location ( location_id INT PRIMARY KEY AUTO_INCREMENT, location_name VARCHAR(50) NOT NULL, location_desc VARCHAR(200) ) COMMENT 车辆位置表; -- 单车表 CREATE TABLE t_bike ( bike_id INT PRIMARY KEY AUTO_INCREMENT, bike_no VARCHAR(20) NOT NULL UNIQUE COMMENT 车辆编号, location_id INT COMMENT 位置ID, status TINYINT DEFAULT 1 COMMENT 状态:1可用,2已借出,3维修中, bike_model VARCHAR(50), purchase_date DATE, daily_rent DECIMAL(6,2) DEFAULT 1.00 COMMENT 每日租金, remark VARCHAR(200), CONSTRAINT fk_bike_location FOREIGN KEY (location_id) REFERENCES t_location(location_id) ) COMMENT 单车表; -- 租借记录表 CREATE TABLE t_rental ( rental_id INT PRIMARY KEY AUTO_INCREMENT, user_id INT NOT NULL, bike_id INT NOT NULL, rental_time DATETIME DEFAULT CURRENT_TIMESTAMP, return_time DATETIME, rental_duration DECIMAL(4,1) COMMENT 租借时长(小时), total_cost DECIMAL(6,2) COMMENT 总费用, status TINYINT DEFAULT 1 COMMENT 状态:1进行中,2已完成,3异常, INDEX idx_user_id (user_id), INDEX idx_bike_id (bike_id) ) COMMENT 租借记录表; -- 报修表 CREATE TABLE t_repair ( repair_id INT PRIMARY KEY AUTO_INCREMENT, rental_id INT, bike_id INT NOT NULL, user_id INT NOT NULL, repair_reason VARCHAR(200), repair_status TINYINT DEFAULT 1 COMMENT 1待处理,2处理中,3已完成, repair_time DATETIME DEFAULT CURRENT_TIMESTAMP, complete_time DATETIME ) COMMENT 报修表; -- 初始化管理员账号密码为123456的MD5值 INSERT INTO t_user (username, password, real_name, role) VALUES (admin, e10adc3949ba59abbe56e057f20f883e, 系统管理员, 1); INSERT INTO t_location (location_name, location_desc) VALUES (图书馆门口, 靠近东门的主停车点); INSERT INTO t_location (location_name, location_desc) VALUES (二食堂门口, 二食堂侧方停车棚); INSERT INTO t_location (location_name, location_desc) VALUES (体育馆东侧, 体育馆东侧围栏边);需要提醒的是MD5加密在真实生产环境强度不足但在毕业设计里完全够用而且容易解释。如果你想显得更专业可以改成密码加盐哈希存储在论文里提一提Spring的DigestUtils工具类也算一个加分的小亮点。4. 开发环境搭建与SSM整合步骤4.1 环境清单与版本搭配SSM项目的环境版本是一大坑。网上教程里Spring 3.x、JDK 1.7的老古董大量存在照搬可能会遇到各种兼容性问题。我自己用得顺手的版本组合是JDK 1.8、Maven 3.6.3、Tomcat 8.5、Spring 5.1.8、Spring MVC 5.1.8、MyBatis 3.5.5、MySQL 5.78.0也兼容需要调整驱动坐标。这个组合在绝大多数电脑上能跑起来依赖也都能从中央仓库正常拉到。IDE方面Eclipse和IDEA都行。IDEA建议装一下Lombok插件如果你在项目里使用了Lombok的Data注解来减少实体类的getter和setter代码Eclipse则需要手动引入Lombok jar包。如果你对Maven不够熟有一个替代方案直接把jar包丢到WEB-INF/lib下但这样后续改依赖细节会很痛苦而且不方便别人复现运行。建议老老实实建Maven工程。4.2 Maven依赖与web.xml配置在pom.xml里需要引入的依赖包括spring-context、spring-webmvc、spring-jdbc、mybatis、mybatis-spring、mysql-connector-java、druid连接池、jstl、servlet-apiscope为provided、jackson-databind如果部分接口返回JSON数据。版本号可以统一用properties标签管理这样后续要换版本时只改一处就行。web.xml是整个SSM整合的入口。它要配置三样东西Spring的ContextLoaderListener监听器负责启动Spring容器Spring MVC的DispatcherServlet前端控制器以及字符编码过滤器CharacterEncodingFilter这个一定要放在所有过滤器的最前面否则POST请求乱码会很难排查。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_4_0.xsd version4.0 display-namecampus_bike/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 /filter filter-mapping filter-nameencodingFilter/filter-name url-pattern/*/url-pattern /filter-mapping !-- 启动Spring容器 -- listener listener-classorg.springframework.web.context.ContextLoaderListener/listener-class /listener context-param param-namecontextConfigLocation/param-name param-valueclasspath:spring/applicationContext.xml/param-value /context-param !-- Spring MVC前端控制器 -- servlet servlet-namedispatcher/servlet-name servlet-classorg.springframework.web.servlet.DispatcherServlet/servlet-class init-param param-namecontextConfigLocation/param-name param-valueclasspath:spring/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 !-- 防止静态资源被DispatcherServlet拦截 -- servlet-mapping servlet-namedefault/servlet-name url-pattern*.js/url-pattern /servlet-mapping servlet-mapping servlet-namedefault/servlet-name url-pattern*.css/url-pattern /servlet-mapping servlet-mapping servlet-namedefault/servlet-name url-pattern*.png/url-pattern /servlet-mapping servlet-mapping servlet-namedefault/servlet-name url-pattern*.jpg/url-pattern /servlet-mapping /web-app重点说一下url-pattern的坑。如果用“/”作为DispatcherServlet的映射路径它会拦截除了JSP之外的所有请求包括静态资源。上面的default servlet映射只是初步方案更推荐的还是在spring-mvc.xml里配置mvc:resources mapping/static/** location/static//把所有静态文件统一放在webapp/static目录下。4.3 三个Spring配置文件的职责划分SSM项目通常需要写三个配置文件applicationContext.xmlSpring核心配置、spring-mvc.xmlSpring MVC配置、mybatis-config.xmlMyBatis配置。这三个文件各管各的放到classpath下的spring目录里方便维护。applicationContext.xml里面要做的事开启注解扫描排除掉Controller注解的类因为那部分交给spring-mvc.xml扫描、配置Druid连接池、配置SqlSessionFactoryBean把数据源和mapper映射文件位置都配好、配置MapperScannerConfigurer扫描mapper接口包、配置事务管理器并开启注解事务驱动。spring-mvc.xml里面要做的事扫描Controller注解的包、开启Spring MVC的注解驱动这样RequestMapping注解才生效、配置视图解析器InternalResourceViewResolver指定prefix为/WEB-INF/views/suffix为.jsp、配置静态资源放行。mybatis-config.xml相对简单一般就配一个settings标签开启下划线转驼峰的mapUnderscoreToCamelCase。如果你愿意在applicationContext.xml里直接配置也可以。但独立文件更直观也更方便你写论文时拆分描述。4.4 连接池与数据库账号安全数据库连接池选择Druid因为它的监控页面做得很好答辩时展示一下数据源监控面板也是一个亮点。连接池配置上initialSize设为5maxActive设为20maxWait设为60000这是比较稳妥的起步参数。如果学校机房电脑内存只有8G这些参数甚至可以再调低一些避免启动时创建太多连接导致卡顿。数据库账号建议专门创建一个项目专用的MySQL用户而不要直接用root。给这个用户授予campus_bike库的全部权限即可。这样既安全也能在论文数据安全部分写上一笔最小权限原则。演示时切换账号也更方便。5. 核心功能模块实现与关键代码解析5.1 登录模块与拦截器设计登录模块是系统的入口功能看起来简单但有几个细节直接关系到后续模块的开发难度。第一个细节是密码加密验证用户输入密码后用同样算法加密再和数据库的值比较。第二个细节是登录成功之后把用户对象放到session里后续借车、还车、展示个人信息都要从session里取用户数据。第三个细节是记住状态功能用Cookie保存用户名但密码不要放进去只做一个“下次自动填入用户名”的效果即可。登录校验拦截器需要用Spring MVC的HandlerInterceptor实现。拦截器的作用是防止未登录用户通过直接输入URL访问系统内部页面。写法上要实现preHandle方法检查session里有没有user对象没有就跳转到登录页并返回false。注册和登录接口要加入excludePathPatterns白名单放行。这个拦截器是答辩时老师经常会问到的一个点——如何保证系统安全性。这是一个比较标准的实现方案。public class LoginInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { HttpSession session request.getSession(); Object loginUser session.getAttribute(loginUser); String uri request.getRequestURI(); // 放行登录、注册相关请求 if (uri.contains(/login) || uri.contains(/register) || uri.contains(/captcha)) { return true; } if (loginUser null) { // 未登录跳转到登录页面 response.sendRedirect(request.getContextPath() /login); return false; } return true; } }另外要说一下验证码。登录页面加一个简单的算术验证码或者图片验证码并不难用Java的BufferedImage就能画。验证码的作用不仅仅是防机器人在答辩演示时也能让系统看起来更加完整。我当时是用一个Servlet输出验证码图片把答案存到session登录时做比对。这个功能投入时间不长但演示效果挺好。5.2 单车管理模块的实现与状态流转车辆管理模块是后台的核心。车辆的新增、修改、删除、查询都需要在管理员的权限范围内操作。删除车辆这里我建议做逻辑删除而不是物理删除给t_bike表加一个deleted字段删除的时候只置为1。因为物理删除会存在隐患——如果这辆车关联了历史租借记录删除后订单详情页的外键关联就会出问题会出现空指针或显示不到车辆信息的bug。借车和还车的核心事务要放在Service层的同一个方法中并且标注Transactional注解。为什么要加事务因为“更新单车状态”和“插入租借记录”这两个数据库操作必须同时成功或同时失败。如果单车状态改成已借出但租借记录插入失败那这辆车就莫名消失了反过来如果记录插入成功但状态没改系统里就会出现一辆已被借走却显示可用的车。借车流程的Service代码如下Service public class RentalServiceImpl implements RentalService { Autowired private BikeMapper bikeMapper; Autowired private RentalMapper rentalMapper; Override Transactional(rollbackFor Exception.class) public Result borrowBike(Integer userId, Integer bikeId) { // 1. 查询单车检查状态 Bike bike bikeMapper.selectById(bikeId); if (bike null) { return Result.error(单车不存在); } if (bike.getStatus() ! 1) { return Result.error(该单车当前不可借出); } // 2. 检查该用户是否有未还订单 Integer unfinished rentalMapper.countUnfinishedByUserId(userId); if (unfinished 0) { return Result.error(您有未还车辆请先归还); } // 3. 更新单车状态为已借出 bikeMapper.updateStatus(bikeId, Const.BIKE_STATUS_RENTED); // 4. 插入租借记录 Rental rental new Rental(); rental.setUserId(userId); rental.setBikeId(bikeId); rental.setRentalTime(new Date()); rental.setStatus(Const.RENTAL_STATUS_ONGOING); rentalMapper.insert(rental); return Result.ok(借车成功); } }还车时除了把单车状态改回可用还要计算费用并更新returnTime和totalCost。费用计算逻辑有好几种方式最简单的按小时计费先算出借车到现在的时长不足1小时按1小时算再乘以hourlyRate日租金除以24。还有按天计费、按次计费可以自行选择但无论选哪种都要在车辆的remark字段描述清楚确保演示时不会因为计费逻辑被老师追问而解释不清。5.3 报表统计模块的多维度展示统计报表模块是为了让系统看起来有“数据分析”的意味。技术上通过MyBatis写几个聚合查询SQL返回结果给Controller再通过前端图表库展示。前端图表推荐用EChartsab不会离题。常用的统计查询有三个车辆利用率某段时间内单车被借出的时间占比、今日订单数量与总营收、单车热门排行按租借次数分组统计。第一个需要联查租借记录和单车表计算每个单车每天的平均借出时长后两个相对简单关键是SQL里用对GROUP BY和聚合函数。这里有个很关键的前后端交互细节如果统计报表的数据希望以异步方式加载图表而不是整个页面刷新的话Controller的方法上记得用ResponseBody注解返回JSON数据。需要引入jackson依赖并且把日期格式统一处理一下否则返回的日期可能是时间戳格式前端解析容易出问题。可以在配置里设置一个ObjectMapper的bean把日期格式化为yyyy-MM-dd HH:mm:ss。6. 论文写作、演示视频与答辩准备6.1 毕业设计论文的结构安排标题说了是全套服务所以论文怎么写也得安排明白。常规的论文结构分为绪论背景意义、国内外现状、研究内容、相关技术介绍SSM框架、MySQL、Druid等、系统分析可行性分析、功能需求分析、非功能需求分析、系统设计总体架构、功能模块设计、数据库设计、系统实现重点功能截图加文字描述、系统测试测试用例表、测试结果分析、总结与展望。论文写作中各位最容易犯的错误是“先写论文后写代码”结果代码实现和论文描述对不上。我的建议顺序恰好相反先把代码跑通再对着实际页面截图写系统实现部分。数据库设计章节里所有表结构要用三线表展示字段名、数据类型、约束条件、说明都列清楚。ER图用draw.io或者Visio画好之后导出图片插入论文即可。系统测试章节至少要列十条以上的测试用例覆盖登录、新增车辆、借车、还车、报修这些核心功能每条用例要写明输入、预期结果、实际结果。6.2 演示视频录制的通用技巧演示视频是整个答辩材料里最直观的部分也是很多人容易做砸的部分。录制软件推荐用OBS或者EV录屏都可以分辨率至少1280x720建议录制成1080p。录制之前要做一份演示脚本大致流程为系统登录展示管理员登录-单车列表展示车辆信息-新增单车演示表单提交-借车操作演示用户借车流程-还车操作演示结算-报修处理演示管理员处理流程-数据统计展示图表。每个操作步骤之间稍微停顿一到两秒给观看者留出理解时间不要鼠标狂点。如果某个环节出现了意外比如弹窗没有加载出来不用慌直接口播说明情况并重新操作或者在后期剪掉这一段。视频配音能录就录不能录就在关键页面上加文字标注比如“此处展示的是借车成功后车辆状态的变化”。时长控制在七到十分钟比较合适太长老师看不完太短又显得内容单薄。6.3 答辩常见问题与回答思路答辩环节老师最常问的问题其实是固定的几个方向。第一个方向是框架相关Spring的IoC和AOP分别怎么理解在项目里用在哪里回答思路是结合代码说IoC就是把对象的创建和依赖关系交给Spring容器管理比如Service和Mapper的注入AOP用在事务处理上Transactional注解就是AOP在配置事务。第二个方向是数据库相关为什么这么设计表结构有没有考虑性能回答思路是讲清楚状态字段的设计逻辑、外键关联关系加索引字段的原因加快查询不要强行吹性能优化说一句“当数据量达到一定规模时可以通过加索引、SQL优化等方式提高查询效率”就行。第三个方向是业务相关共享单车和普通租车系统有什么区别你的系统有没有考虑超时未还的情况回答思路是承认基础系统没做超时自动结算但可以通过定时任务扫描租借记录表把超时未还的单车状态置为异常、发送提醒。只要能说出这个思路就足以证明业务思考能力。7. 常见问题排查表与避坑指南整个项目开发过程中可能会遇到的坑其实高度集中在以下几个地方。把这些整理成一份速查表开发时遇到问题可以对照排查症状可能原因排查方法项目启动报404DispatcherServlet映射路径错误或web.xml配置问题检查url-pattern是否为“/”检查spring-mvc.xml是否被正确加载Controller里的变量用Autowired注入为null包扫描没扫到Service实现类或者Service实现类没加Service注解检查applicationContext.xml的component-scan配置MyBatis执行报BindingExceptionMapper接口和XML文件的namespace不匹配或方法ID不对逐一检查namespace是否和接口全限定名一致每个方法的id是否和接口方法名一致中文乱码JSP页面编码或请求编码不对确认web.xml里的CharacterEncodingFilter存在且在过滤器链第一个位置确认JSP第一行有pageEncoding前端页面样式全部丢失静态资源被DispatcherServlet拦截配置mvc:resources放行static目录或者用默认servlet处理静态资源数据库连接失败驱动的版本不匹配或连接串有问题确认mysql-connector-java版本对应你的MySQL版本确认url参数里useSSLfalse分页不生效没有引入PageHelper插件或版本不匹配确认导入pagehelper和pagehelper-spring-boot-starter坐标5.x版本的插件用法和4.x不同关于PageHelper插件再多说一句。它确实能简化分页操作但在SSM项目里使用时容易踩坑PageHelper的方法必须紧跟在要分页的查询语句之前调用中间不能夹杂其他查询否则分页信息会被后一个查询覆盖还有pageNum不能超过总页数太多否则返回空数据但total值会异常。如果你对分页原理不熟最简单的方案是自己写LIMIT语句实现分页在Service里计算偏移量Controller接收pageNum和pageSize参数。再说几个容易被忽略但很影响体验的细节。第一前端表单要做基础校验比如手机号格式、必填项是否为空可以在页面里用JavaScript实现也可以在Controller里手动校验建议两层都做。第二页面上所有涉及删除操作的按钮必须要有JavaScript二次确认弹窗防止误点。第三如果Tomcat端口被占用在IDEA里改一下Tomcat配置的端口号就好不用费劲去找占用进程。8. 最后一件事从“完成”到“说得清”项目代码写完、论文交上去、演示视频录完不等于这个毕设真的结束了。答辩前的最后两三天最值得做的事是把自己的系统当成一个陌生的产品重新走一遍所有流程梳理出每个功能模块背后的设计思考。比如为什么单车状态要用int而不是String因为程序判断和更新状态更高效。为什么租借记录表要同时建userId和bikeId索引因为这两个字段是查询的高频条件。为什么用Druid连接池因为自带监控并且有防御SQL注入的过滤器。这些问题的答案在代码里、在配置里、在数据库设计里。你能讲清楚这些答辩基本就稳了。而这份“说得清”的能力其实比代码本身更能体现你对整个项目的掌控程度——这也是我从辅导学生做毕设过程中最深的体会项目可以是练手的、功能可以是常见的但思考路径必须是你自己走通的这才是毕业设计真正的收获所在。