简介基于SSM的校园外卖配送系统完整源码面向Java后端学习者和毕业设计开发者覆盖用户端、商家端、配送员端、管理员端实现从在线下单、商家接单到配送员送达的完整业务闭环。zip压缩包共1345个文件体积17.32MB内含144个Java后台逻辑、131个jsp动态页面、364个js与146个css前端交互脚本以及大量png、jpg、gif图片素材和xml、sql配置/数据库文件目录结构清晰。目前已有127人学习下载适合需要参考完整项目快速入手的学生。通过源码可系统理解SSM框架整合方式、SpringMVC请求处理流程、MyBatis持久层映射以及订单状态流转、角色权限控制等实战细节。资源中保留了前端样式备份文件与jsp原始页面模板便于对照不同版本调试页面与业务逻辑对完整走通校园外卖配送全流程开发有直接参考价值。1. 基于SSM的校园外卖配送系统源码拿到zip之后先别急着解压这类校园外卖配送系统源码包在SSM技术栈的毕设和Java课程设计里出现频率很高zip里装的是一个完整的Java Web工程加一份SQL脚本目标是把用户点餐、商家接单、骑手配送、订单状态流转这一个闭环跑通。先说个反直觉的结论这套源码最值钱的部分往往不是业务代码本身而是你能不能在一台干净的机器上把它从zip变成能访问的网页再把订单从“待支付”一路推到“已完成”。适合正在做毕设、需要接手别人工程做二次开发的同学也适合想用SSM练手、但不想从零搭框架的后端新人。下面按我实际部署这类工程的经验把环境搭配、数据库初始化、部署顺序和踩过的坑一次性讲透。2. SSM项目骨架到底怎么长从zip解压到看清包内分层2.1 Spring、SpringMVC、MyBatis三者各管哪一块SSM不是一个框架是三个框架的合称搞清楚它们的分工后面排查问题时才知道该看哪个配置文件。Spring负责管理对象和事务所有Controller、Service、Dao实例都由它创建和注入事务也由它统一控制SpringMVC负责HTTP层的请求路由把用户访问的URL映射到Controller方法上再把返回值渲染成页面或JSONMyBatis负责数据库访问把Mapper接口和XML里的SQL语句绑定起来执行结果自动映射成实体对象。这个组合在校园外卖这类业务里特别合适因为订单、菜品、配送员之间关系不复杂用MyBatis手写SQL反而比JPA更好控制尤其是库存扣减、抢单这种对SQL有精确要求的场景。相比之下如果直接上Spring Boot虽然配置更少但不少课设和毕设题目指定的就是SSM而且先跑通一次SSM整合你再看Spring Boot的自动配置会容易理解得多。拿到zip后第一步不是双击解压而是先看工程根目录下的pom.xml确认Spring版本、MyBatis版本、MySQL驱动版本这决定了你本机要装哪个版本的JDK和数据库。2.2 包结构对照controller、service、dao、entity怎么认常见的SSM工程目录长这样我一般会先用系统自带解压或7-Zip把zip解压到纯英文路径下然后看根目录结构campus-takeout/ ├── pom.xml ├── sql/ │ └── campus_takeout.sql └── src/ ├── main/ │ ├── java/ │ │ └── com/xxx/campus/ │ │ ├── controller/ # 接收请求返回页面或JSON │ │ ├── service/ # 业务逻辑事务边界在这里 │ │ ├── dao/ # MyBatis Mapper接口 │ │ └── entity/ # 数据库表对应的实体类 │ ├── resources/ │ │ ├── jdbc.properties # 数据库连接信息 │ │ ├── mybatis-config.xml # MyBatis全局配置 │ │ ├── spring/ # Spring和SpringMVC配置 │ │ └── mapper/ # 每张表对应的SQL映射XML │ └── webapp/ │ ├── WEB-INF/web.xml # 前端控制器和监听器配置 │ └── static/ # JSP、CSS、JS等前端资源 └── test/这里有个容易忽略的细节很多SSM课程设计的JSP页面放在webapp根目录或WEB-INF下而接口返回的JSON路径通常在Controller上加ResponseBody或RestController。部署后如果页面能打开但数据加载不出来多半是接口路径和页面里写的ajax地址对不上后面排查章节会再讲。另一个值得注意的点是dao接口和mapper XML的命名空间必须完全一致否则启动时就报绑定异常。2.3 配置文件之间是怎么串起来的web.xml、spring-mvc.xml、spring-mybatis.xmlSSM工程的启动顺序是Tomcat先读web.xml由ContextLoaderListener加载Spring根容器再由DispatcherServlet加载SpringMVC子容器。根容器管service、dao和事务子容器管Controller。理解这个顺序后排查“注入为null”这类问题会快很多。看工程里resources/spring目录下的配置文件通常会有spring-dao.xml、spring-service.xml、spring-mvc.xml这几个。spring-dao.xml里配置数据源、SqlSessionFactoryBean、MapperScannerConfigurer把dao接口扫描进来并让MyBatis去读mapper目录下的SQL映射spring-service.xml里配置事务管理器和ComponentScan扫描service包spring-mvc.xml里配置组件扫描controller包、注解驱动和视图解析器。如果解压后某个配置文件缺失或者某个XML里面引用了不存在的类Tomcat启动时会在catalina日志里直接报BeanCreationException。这时候不要急着改业务代码先看是不是配置文件里包名和实际代码包名不一致比如配置里写的是com.example但代码在com.campus下面这种问题在二手源码里特别常见。3. 把源码跑起来环境版本搭配、建库脚本与Tomcat部署手顺3.1 JDK、Maven、MySQL、Tomcat的版本搭配SSM老工程对版本敏感我踩过最大的坑是JDK版本过高导致javax.xml.bind找不到类。一般这类zip在README或SQL脚本头部会注明开发环境但很多二手代码没有说明我习惯按下面的组合来准备成功率最高组件推荐版本说明JDK1.88u201以上均可SSM JSP老工程在JDK 11及以上常见xml绑定报错Maven3.6.x对老工程的依赖解析最稳3.9也兼容Tomcat8.5或9.0servlet规范3.1/4.0JSP和EL兼容性好MySQL5.7或8.05.7最省心8.0需额外配置SSL和时区IDEA任意近期版本导入Maven项目时选自动导入先检查本机环境再决定是调整工程还是调整环境java -version mvn -v mysql --version如果java版本是11或17而pom.xml里没有引入javax.xml.bind相关依赖我一般会安装一个JDK 8在IDEA的Project Structure里把Project SDK和Java Compiler的版本都指过去这样比改pom引入一堆依赖更省事。MySQL建议用5.7的msi安装包或直接跑Docker容器不要图新装8.0之后又去处理加密规则和时区问题。3.2 初始化数据库执行SQL脚本而不是手动建表zip包里sql目录下的campus_takeout.sql一般包含建库、建表和测试数据。用命令行导入是最直观的做法比在Navicat里一条条执行更不容易漏mysql -u root -p -e CREATE DATABASE IF NOT EXISTS campus_takeout DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; mysql -u root -p campus_takeout sql/campus_takeout.sql导入后再确认表和数据是否完整USE campus_takeout; SHOW TABLES; SELECT COUNT(*) FROM user; SELECT COUNT(*) FROM orders;这里有两个参数要注意。一是字符集老SQL文件里可能写的是utf8如果你要用到emoji表情或者特殊符号建议建库时直接用utf8mb4并把SQL文件里的CREATE TABLE语句逐表确认二是如果SQL文件里有DROP TABLE语句它会把同名表清掉重来执行前确认这个库里没有你要保留的其他数据。3.3 改数据库连接配置jdbc.properties里的三个必调参数数据库初始化之后打开resources/jdbc.properties把连接信息改成你自己的这是部署前必改的一个文件通常长这样jdbc.drivercom.mysql.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/campus_takeout?useUnicodetruecharacterEncodingutf8useSSLfalseserverTimezoneAsia/Shanghai jdbc.usernameroot jdbc.password123456参数说明driver一项如果本机MySQL是5.7且驱动版本是5.x保持com.mysql.jdbc.Driver如果用的是MySQL 8.0或驱动是8.x要改成com.mysql.cj.jdbc.Driver否则启动报ClassNotFoundException。url里useSSLfalse关掉SSL握手serverTimezoneAsia/Shanghai解决“The server time zone value”报错这两个在MySQL 8.0下基本是必须的5.7下不加也能跑但建议统一加上。characterEncodingutf8对应你建库时的字符集如果你建库用了utf8mb4这里也可以写成utf8mb4保持两边一致。3.4 用Maven打包并部署到Tomcat从war包到能访问页面配置文件改完后在工程根目录执行打包命令跳过测试减少不必要的编译错误mvn clean package -DskipTests打包完成后target目录下会生成一个war包文件名一般以pom.xml里的artifactId和version命名比如campus-takeout-1.0.war。把这个war包复制到Tomcat的webapps目录下然后从Tomcat的bin目录启动cp target/campus-takeout-1.0.war /path/to/tomcat/webapps/ cd /path/to/tomcat/bin ./startup.sh tail -f ../logs/catalina.out如果本机是Windows启动后一样看logs/catalina.{日期}.log。Tomcat会自动解压war包访问路径默认是war包名去掉版本号比如http://localhost:8080/campus-takeout-1.0/。想用更短的路径访问可以把war包改名为ROOT.war再部署这样直接访问http://localhost:8080/。部署成功后再看日志确认“Deployment of web application archive has finished”和“Spring容器启动成功”这类关键信息接着打开浏览器访问登录页。常见做法是先跑一遍注册或登录流程确认数据库连接和Session都正常再往下测点餐流程。4. 订单状态流转与骑手配送的核心表抄得动的SQL设计4.1 用户、商家、菜品、订单、配送五张主表的关系外卖配送的数据库设计并不复杂核心是订单表把用户、商家、配送员关联起来。我在这类工程里见到最多的表结构是五张主表加一张关联表user存用户和密码seller存商家信息dish存菜品并挂seller_idorders存订单主表rider存骑手信息delivery存配送记录并挂order_id和rider_id。关键表结构可以参考下面的建表SQL字段名跟你手里的源码可能略有出入但核心字段基本一致CREATE TABLE user ( id INT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(50) NOT NULL UNIQUE, password VARCHAR(64) NOT NULL, phone VARCHAR(20), address VARCHAR(255), create_time DATETIME DEFAULT CURRENT_TIMESTAMP ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE seller ( id INT PRIMARY KEY AUTO_INCREMENT, name VARCHAR(100) NOT NULL, phone VARCHAR(20), address VARCHAR(255), status TINYINT DEFAULT 1 COMMENT 1营业 0打烊 ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE dish ( id INT PRIMARY KEY AUTO_INCREMENT, seller_id INT NOT NULL, name VARCHAR(100) NOT NULL, price DECIMAL(10,2) NOT NULL, stock INT DEFAULT 0, image VARCHAR(255), KEY idx_seller (seller_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE orders ( id INT PRIMARY KEY AUTO_INCREMENT, order_no VARCHAR(32) NOT NULL UNIQUE, user_id INT NOT NULL, seller_id INT NOT NULL, status TINYINT NOT NULL DEFAULT 0 COMMENT 0待接单 1商家确认 2配送中 3已完成 4已取消, total_price DECIMAL(10,2) NOT NULL, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, KEY idx_user (user_id), KEY idx_seller_status (seller_id, status) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE rider ( id INT PRIMARY KEY AUTO_INCREMENT, name VARCHAR(50) NOT NULL, phone VARCHAR(20), status TINYINT DEFAULT 0 COMMENT 0空闲 1配送中 ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE delivery ( id INT PRIMARY KEY AUTO_INCREMENT, order_id INT NOT NULL UNIQUE, rider_id INT, status TINYINT DEFAULT 0 COMMENT 0待分配 1配送中 2已送达, assign_time DATETIME, finish_time DATETIME, KEY idx_rider (rider_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;这里需要注意这类课设工程通常不会加物理外键原因有两点一是演示数据经常删除重建外键会阻挡删除顺序二是后期改状态时外键约束容易引发意外报错。正确做法是在service层保证关联字段的合法性订单只能由存在的用户和商家创建配送单只能关联存在的订单。4.2 订单状态与骑手接单的状态机从0到4怎么跳订单状态流转是整个系统的业务主线也是面试或答辩时最容易问的点。合理的状态机是0待接单 → 1商家确认 → 2配送中 → 3已完成其中0和1状态下用户可以取消订单进到4。骑手接单不是直接改orders表而是在delivery表里做一次更新状态从0待分配变成1配送中同时把orders表的status改成2配送中。这里最容易翻车的是抢单并发。两个骑手同时点“我要接单”如果Service里先查再改会出现一单被两个人同时抢走的情况。正确做法是用一条条件更新SQL把“查询更新”合并成一个原子操作UPDATE delivery SET rider_id #{riderId}, status 1, assign_time NOW() WHERE id #{deliveryId} AND status 0 AND rider_id IS NULL参数说明核心是WHERE里的status 0 AND rider_id IS NULL这条SQL保证只有一个骑手的UPDATE能影响到一行。MyBatis里执行这个方法后判断返回值如果影响行数是1说明抢单成功是0说明已经被别人抢走这时再给页面返回“订单已被抢”的提示而不是继续往下发配送通知。订单创建同样要注意事务。常见做法是Controller调用Service的createOrder方法Service里标注Transactional或由spring-service.xml里的事务切面包住方法内先扣菜品库存、生成订单、创建配送记录任何一个步骤失败都要回滚否则会出现库存扣了但订单没生成的数据不一致。这一点第五章避坑里还会展开。4.3 超时未接单的兜底定时任务还是手动补偿校园外卖场景中用户下单后商家长时间不接单需要在设定时间后自动取消。源码里如果实现了这个功能通常是在spring-service.xml里开启定时任务或者用Spring的Scheduled注解。如果接手时没有实现最简单的兜底方案是写一个接口由管理员手动触发或者用系统定时任务调用Java程序不一定要引入分布式任务调度中间件。Component public class OrderTimeoutTask { Scheduled(fixedDelay 60000) Transactional public void cancelTimeoutOrders() { // 查最近15分钟仍处于0待接单状态的订单 // 批量把状态更新为4已取消 } }参数说明fixedDelay60000表示上一次执行完成后间隔60秒再执行下一次适合这种轻量级补偿任务。注意Transactional要加在方法上或由Spring事务切面包住保证批量更新中途失败能回滚。定时任务里只做订单状态变更不要在这里发通知或操作第三方接口否则阻塞后会拖垮线程池。5. 避坑SSM老项目部署时最常见的5个报错现场5.1 zip解压后中文乱码、目录嵌套两层导致IDEA不识别现象Windows自带解压工具把zip展开后中文文件名变成乱码工程目录下又套了一层同名文件夹IDEA导入后没有Maven项目标记。原因zip包里文件名编码是UTF-8Windows自带解压默认按GBK解码导致乱码而不少源码zip是直接在打包目录上右键压缩的解压出来多一层嵌套。解决用7-Zip或WinRAR右键解压并在IDEA里直接打开最内层含pom.xml的目录作为项目根。工程路径不要放在桌面或带中文、空格的路径下否则Maven和Tomcat都可能出现奇怪问题。另外解压后先看pom.xml是否完整文件大小如果只有几KB很可能是一个空壳项目。5.2 Tomcat启动报java.lang.NoClassDefFoundError: javax/xml/bind现象JDK 11及以上环境启动Tomcat加载Spring时报javax/xml/bind/JAXBException找不到类工程无法启动。原因javax.xml.bind从JDK 9开始被模块化移除JRE不再自带而老SSM工程里Spring或MyBatis依赖它做XML解析。解决最稳的办法是装JDK 8并让项目使用JDK 8编译运行这是SSM老工程的标准环境。如果必须用高版本JDK就在pom.xml里手动引入javax.xml.bind相关依赖但这样还要处理javax.activation等连带包改动面更大不如直接换环境。5.3 MySQL 8.0连不上SSL握手失败、时区报错、认证失败现象数据库连接报Communications link failure、The server time zone value、客户端不支持服务器请求的认证协议。原因MySQL 8.0默认使用caching_sha2_password认证而老驱动mysql-connector-java 5.x默认用mysql_native_password同时8.0对SSL和时区要求更严格老url里没有对应参数。解决如果源码自带的是5.x驱动可以换成8.0.x驱动并把jdbc.properties改成配套写法jdbc.drivercom.mysql.cj.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/campus_takeout?useUnicodetruecharacterEncodingutf8useSSLfalseserverTimezoneAsia/ShanghaiallowPublicKeyRetrievaltrue jdbc.usernameroot jdbc.password你的密码参数说明allowPublicKeyRetrievaltrue是MySQL 8.0连接时第一次认证获取公钥用的不加可能报Public Key Retrieval is not allowed。driver必须写成com.mysql.cj.jdbc.Driver不能再是旧的com.mysql.jdbc.Driver。如果你还是想用5.7数据库就跳过这段不用改驱动。5.4 启动成功但访问404SpringMVC包扫描不到Controller或上下文路径不对现象Tomcat日志显示部署成功页面能打开但点击登录请求接口返回404或者所有JSP页面都打不开。原因spring-mvc.xml里的 context:component-scan 包名写错导致Controller没被注册或者web.xml里DispatcherServlet的url-pattern配置成*.do而页面ajax请求的是.json或裸路径还有一个常见原因是部署后的war包名和页面里写死的上下文路径不一致。解决先看Tomcat日志有没有“RequestMappingHandlerMapping”相关注册信息再用IDEA的Deployment配置页检查Application context比如war包叫campus-takeout-1.0页面里ajax地址写/campus-takeout/xxx就会404。最省事的方法是把war包重命名成ROOT.war部署这样上下文路径就是根路径所有请求直接走相对路径绕开上下文不一致的坑。5.5 启动报Invalid bound statement (not found)Mapper XML没被打进war包现象Tomcat启动成功登录或查列表时Service层调用dao方法报org.apache.ibatis.binding.BindingException: Invalid bound statement (not found)。原因源码把mapper XML放在了src/main/java的dao同包目录下而pom.xml没有对resources做扩展配置Maven默认只把src/main/resources下的文件打进包导致target/classes里没有XML文件MyBatis绑定不上SQL。解决在pom.xml的build节点里配置resources把src/main/java下的xml和properties也收进编译产物build resources resource directorysrc/main/java/directory includes include**/*.xml/include /includes /resource resource directorysrc/main/resources/directory /resource /resources /build参数说明这个配置的作用是让Maven在编译时额外把dao包下的XML复制到target/classes对应目录。改完之后重新执行mvn clean package确认target/classes/.../dao/下面有XML文件再部署。如果源码原本就把XML放在resources/mapper下就不用改pom检查mybatis-config.xml里的mapper-locations路径是否指向classpath:mapper/*.xml。6. 从“能跑”到“能讲清楚”交付演示前的日志、事务与异常验证源码能在本地跑通只完成了一半另一半是把系统逻辑讲清楚并证明它经得起提问。我每次交付这类SSM项目前至少会做三件事一是打开SQL日志确认每个操作真的落了库二是在订单创建里人为制造异常验证事务回滚三是在答辩演示前固定一套演示脚本不用临场乱点。日志是最直接的验证手段。mybatis-config.xml里把日志级别调成DEBUG控制台就能看到每条SQL和传入参数settings setting namelogImpl valueSTDOUT_LOGGING/ /settings参数说明STDOUT_LOGGING让MyBatis把SQL和执行结果直接打印到控制台适合本地调试。上线前要改回log4j2或SLF4J接日志文件避免日志刷屏影响性能。验证事务回滚更简单在订单Service的扣库存和生成订单之间临时抛个RuntimeException如果订单没有生成且库存保持原值说明事务生效验证完删掉这行。骑手抢单的演示脚本也要固定准备三个测试账号分别对应用户、商家、骑手提前造好几条测试订单演示时按“用户下单 → 商家接单 → 骑手抢单 → 确认送达 → 订单完成”的顺序走每个状态切换看一眼数据库里orders表和delivery表的变化评委问状态流时直接对着表讲。另一个容易被问到的坑是库存超卖。如果dish表里没有库存字段或者下单逻辑里只查不扣演示时连续点两次下单也不会被发现但一旦被问到并发就会露馅。我的习惯是给菜品加上库存字段并在下单SQL里用条件更新扣减UPDATE dish SET stock stock - 1 WHERE id #{dishId} AND stock 0这条SQL同样是原子操作影响行数为0说明库存不足直接提示用户。把这一层的SQL设计讲清楚整个系统的技术含量会明显高出普通课设一截。最后的建议是把默认账号密码固化下来用固定账号演示而不是现场注册新用户能省掉很多输入和校验的等待时间。SSM老项目维护到现在真正的工作量早就不在“让它跑起来”上而在你能不能在跑起来之后说清楚每一条数据是怎么流动的。希望帮到你。本文还有配套的精品资源点击获取 
长河君 · 2026/10/8 11:22:49 · 阅读 1.2k 基于SSM的校园外卖系统源码部署实战：从解压到跑通订单闭环
简介基于SSM的校园外卖配送系统完整源码面向Java后端学习者和毕业设计开发者覆盖用户端、商家端、配送员端、管理员端实现从在线下单、商家接单到配送员送达的完整业务闭环。zip压缩包共1345个文件体积17.32MB内含144个Java后台逻辑、131个jsp动态页面、364个js与146个css前端交互脚本以及大量png、jpg、gif图片素材和xml、sql配置/数据库文件目录结构清晰。目前已有127人学习下载适合需要参考完整项目快速入手的学生。通过源码可系统理解SSM框架整合方式、SpringMVC请求处理流程、MyBatis持久层映射以及订单状态流转、角色权限控制等实战细节。资源中保留了前端样式备份文件与jsp原始页面模板便于对照不同版本调试页面与业务逻辑对完整走通校园外卖配送全流程开发有直接参考价值。1. 基于SSM的校园外卖配送系统源码拿到zip之后先别急着解压这类校园外卖配送系统源码包在SSM技术栈的毕设和Java课程设计里出现频率很高zip里装的是一个完整的Java Web工程加一份SQL脚本目标是把用户点餐、商家接单、骑手配送、订单状态流转这一个闭环跑通。先说个反直觉的结论这套源码最值钱的部分往往不是业务代码本身而是你能不能在一台干净的机器上把它从zip变成能访问的网页再把订单从“待支付”一路推到“已完成”。适合正在做毕设、需要接手别人工程做二次开发的同学也适合想用SSM练手、但不想从零搭框架的后端新人。下面按我实际部署这类工程的经验把环境搭配、数据库初始化、部署顺序和踩过的坑一次性讲透。2. SSM项目骨架到底怎么长从zip解压到看清包内分层2.1 Spring、SpringMVC、MyBatis三者各管哪一块SSM不是一个框架是三个框架的合称搞清楚它们的分工后面排查问题时才知道该看哪个配置文件。Spring负责管理对象和事务所有Controller、Service、Dao实例都由它创建和注入事务也由它统一控制SpringMVC负责HTTP层的请求路由把用户访问的URL映射到Controller方法上再把返回值渲染成页面或JSONMyBatis负责数据库访问把Mapper接口和XML里的SQL语句绑定起来执行结果自动映射成实体对象。这个组合在校园外卖这类业务里特别合适因为订单、菜品、配送员之间关系不复杂用MyBatis手写SQL反而比JPA更好控制尤其是库存扣减、抢单这种对SQL有精确要求的场景。相比之下如果直接上Spring Boot虽然配置更少但不少课设和毕设题目指定的就是SSM而且先跑通一次SSM整合你再看Spring Boot的自动配置会容易理解得多。拿到zip后第一步不是双击解压而是先看工程根目录下的pom.xml确认Spring版本、MyBatis版本、MySQL驱动版本这决定了你本机要装哪个版本的JDK和数据库。2.2 包结构对照controller、service、dao、entity怎么认常见的SSM工程目录长这样我一般会先用系统自带解压或7-Zip把zip解压到纯英文路径下然后看根目录结构campus-takeout/ ├── pom.xml ├── sql/ │ └── campus_takeout.sql └── src/ ├── main/ │ ├── java/ │ │ └── com/xxx/campus/ │ │ ├── controller/ # 接收请求返回页面或JSON │ │ ├── service/ # 业务逻辑事务边界在这里 │ │ ├── dao/ # MyBatis Mapper接口 │ │ └── entity/ # 数据库表对应的实体类 │ ├── resources/ │ │ ├── jdbc.properties # 数据库连接信息 │ │ ├── mybatis-config.xml # MyBatis全局配置 │ │ ├── spring/ # Spring和SpringMVC配置 │ │ └── mapper/ # 每张表对应的SQL映射XML │ └── webapp/ │ ├── WEB-INF/web.xml # 前端控制器和监听器配置 │ └── static/ # JSP、CSS、JS等前端资源 └── test/这里有个容易忽略的细节很多SSM课程设计的JSP页面放在webapp根目录或WEB-INF下而接口返回的JSON路径通常在Controller上加ResponseBody或RestController。部署后如果页面能打开但数据加载不出来多半是接口路径和页面里写的ajax地址对不上后面排查章节会再讲。另一个值得注意的点是dao接口和mapper XML的命名空间必须完全一致否则启动时就报绑定异常。2.3 配置文件之间是怎么串起来的web.xml、spring-mvc.xml、spring-mybatis.xmlSSM工程的启动顺序是Tomcat先读web.xml由ContextLoaderListener加载Spring根容器再由DispatcherServlet加载SpringMVC子容器。根容器管service、dao和事务子容器管Controller。理解这个顺序后排查“注入为null”这类问题会快很多。看工程里resources/spring目录下的配置文件通常会有spring-dao.xml、spring-service.xml、spring-mvc.xml这几个。spring-dao.xml里配置数据源、SqlSessionFactoryBean、MapperScannerConfigurer把dao接口扫描进来并让MyBatis去读mapper目录下的SQL映射spring-service.xml里配置事务管理器和ComponentScan扫描service包spring-mvc.xml里配置组件扫描controller包、注解驱动和视图解析器。如果解压后某个配置文件缺失或者某个XML里面引用了不存在的类Tomcat启动时会在catalina日志里直接报BeanCreationException。这时候不要急着改业务代码先看是不是配置文件里包名和实际代码包名不一致比如配置里写的是com.example但代码在com.campus下面这种问题在二手源码里特别常见。3. 把源码跑起来环境版本搭配、建库脚本与Tomcat部署手顺3.1 JDK、Maven、MySQL、Tomcat的版本搭配SSM老工程对版本敏感我踩过最大的坑是JDK版本过高导致javax.xml.bind找不到类。一般这类zip在README或SQL脚本头部会注明开发环境但很多二手代码没有说明我习惯按下面的组合来准备成功率最高组件推荐版本说明JDK1.88u201以上均可SSM JSP老工程在JDK 11及以上常见xml绑定报错Maven3.6.x对老工程的依赖解析最稳3.9也兼容Tomcat8.5或9.0servlet规范3.1/4.0JSP和EL兼容性好MySQL5.7或8.05.7最省心8.0需额外配置SSL和时区IDEA任意近期版本导入Maven项目时选自动导入先检查本机环境再决定是调整工程还是调整环境java -version mvn -v mysql --version如果java版本是11或17而pom.xml里没有引入javax.xml.bind相关依赖我一般会安装一个JDK 8在IDEA的Project Structure里把Project SDK和Java Compiler的版本都指过去这样比改pom引入一堆依赖更省事。MySQL建议用5.7的msi安装包或直接跑Docker容器不要图新装8.0之后又去处理加密规则和时区问题。3.2 初始化数据库执行SQL脚本而不是手动建表zip包里sql目录下的campus_takeout.sql一般包含建库、建表和测试数据。用命令行导入是最直观的做法比在Navicat里一条条执行更不容易漏mysql -u root -p -e CREATE DATABASE IF NOT EXISTS campus_takeout DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; mysql -u root -p campus_takeout sql/campus_takeout.sql导入后再确认表和数据是否完整USE campus_takeout; SHOW TABLES; SELECT COUNT(*) FROM user; SELECT COUNT(*) FROM orders;这里有两个参数要注意。一是字符集老SQL文件里可能写的是utf8如果你要用到emoji表情或者特殊符号建议建库时直接用utf8mb4并把SQL文件里的CREATE TABLE语句逐表确认二是如果SQL文件里有DROP TABLE语句它会把同名表清掉重来执行前确认这个库里没有你要保留的其他数据。3.3 改数据库连接配置jdbc.properties里的三个必调参数数据库初始化之后打开resources/jdbc.properties把连接信息改成你自己的这是部署前必改的一个文件通常长这样jdbc.drivercom.mysql.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/campus_takeout?useUnicodetruecharacterEncodingutf8useSSLfalseserverTimezoneAsia/Shanghai jdbc.usernameroot jdbc.password123456参数说明driver一项如果本机MySQL是5.7且驱动版本是5.x保持com.mysql.jdbc.Driver如果用的是MySQL 8.0或驱动是8.x要改成com.mysql.cj.jdbc.Driver否则启动报ClassNotFoundException。url里useSSLfalse关掉SSL握手serverTimezoneAsia/Shanghai解决“The server time zone value”报错这两个在MySQL 8.0下基本是必须的5.7下不加也能跑但建议统一加上。characterEncodingutf8对应你建库时的字符集如果你建库用了utf8mb4这里也可以写成utf8mb4保持两边一致。3.4 用Maven打包并部署到Tomcat从war包到能访问页面配置文件改完后在工程根目录执行打包命令跳过测试减少不必要的编译错误mvn clean package -DskipTests打包完成后target目录下会生成一个war包文件名一般以pom.xml里的artifactId和version命名比如campus-takeout-1.0.war。把这个war包复制到Tomcat的webapps目录下然后从Tomcat的bin目录启动cp target/campus-takeout-1.0.war /path/to/tomcat/webapps/ cd /path/to/tomcat/bin ./startup.sh tail -f ../logs/catalina.out如果本机是Windows启动后一样看logs/catalina.{日期}.log。Tomcat会自动解压war包访问路径默认是war包名去掉版本号比如http://localhost:8080/campus-takeout-1.0/。想用更短的路径访问可以把war包改名为ROOT.war再部署这样直接访问http://localhost:8080/。部署成功后再看日志确认“Deployment of web application archive has finished”和“Spring容器启动成功”这类关键信息接着打开浏览器访问登录页。常见做法是先跑一遍注册或登录流程确认数据库连接和Session都正常再往下测点餐流程。4. 订单状态流转与骑手配送的核心表抄得动的SQL设计4.1 用户、商家、菜品、订单、配送五张主表的关系外卖配送的数据库设计并不复杂核心是订单表把用户、商家、配送员关联起来。我在这类工程里见到最多的表结构是五张主表加一张关联表user存用户和密码seller存商家信息dish存菜品并挂seller_idorders存订单主表rider存骑手信息delivery存配送记录并挂order_id和rider_id。关键表结构可以参考下面的建表SQL字段名跟你手里的源码可能略有出入但核心字段基本一致CREATE TABLE user ( id INT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(50) NOT NULL UNIQUE, password VARCHAR(64) NOT NULL, phone VARCHAR(20), address VARCHAR(255), create_time DATETIME DEFAULT CURRENT_TIMESTAMP ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE seller ( id INT PRIMARY KEY AUTO_INCREMENT, name VARCHAR(100) NOT NULL, phone VARCHAR(20), address VARCHAR(255), status TINYINT DEFAULT 1 COMMENT 1营业 0打烊 ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE dish ( id INT PRIMARY KEY AUTO_INCREMENT, seller_id INT NOT NULL, name VARCHAR(100) NOT NULL, price DECIMAL(10,2) NOT NULL, stock INT DEFAULT 0, image VARCHAR(255), KEY idx_seller (seller_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE orders ( id INT PRIMARY KEY AUTO_INCREMENT, order_no VARCHAR(32) NOT NULL UNIQUE, user_id INT NOT NULL, seller_id INT NOT NULL, status TINYINT NOT NULL DEFAULT 0 COMMENT 0待接单 1商家确认 2配送中 3已完成 4已取消, total_price DECIMAL(10,2) NOT NULL, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, KEY idx_user (user_id), KEY idx_seller_status (seller_id, status) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE rider ( id INT PRIMARY KEY AUTO_INCREMENT, name VARCHAR(50) NOT NULL, phone VARCHAR(20), status TINYINT DEFAULT 0 COMMENT 0空闲 1配送中 ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE delivery ( id INT PRIMARY KEY AUTO_INCREMENT, order_id INT NOT NULL UNIQUE, rider_id INT, status TINYINT DEFAULT 0 COMMENT 0待分配 1配送中 2已送达, assign_time DATETIME, finish_time DATETIME, KEY idx_rider (rider_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;这里需要注意这类课设工程通常不会加物理外键原因有两点一是演示数据经常删除重建外键会阻挡删除顺序二是后期改状态时外键约束容易引发意外报错。正确做法是在service层保证关联字段的合法性订单只能由存在的用户和商家创建配送单只能关联存在的订单。4.2 订单状态与骑手接单的状态机从0到4怎么跳订单状态流转是整个系统的业务主线也是面试或答辩时最容易问的点。合理的状态机是0待接单 → 1商家确认 → 2配送中 → 3已完成其中0和1状态下用户可以取消订单进到4。骑手接单不是直接改orders表而是在delivery表里做一次更新状态从0待分配变成1配送中同时把orders表的status改成2配送中。这里最容易翻车的是抢单并发。两个骑手同时点“我要接单”如果Service里先查再改会出现一单被两个人同时抢走的情况。正确做法是用一条条件更新SQL把“查询更新”合并成一个原子操作UPDATE delivery SET rider_id #{riderId}, status 1, assign_time NOW() WHERE id #{deliveryId} AND status 0 AND rider_id IS NULL参数说明核心是WHERE里的status 0 AND rider_id IS NULL这条SQL保证只有一个骑手的UPDATE能影响到一行。MyBatis里执行这个方法后判断返回值如果影响行数是1说明抢单成功是0说明已经被别人抢走这时再给页面返回“订单已被抢”的提示而不是继续往下发配送通知。订单创建同样要注意事务。常见做法是Controller调用Service的createOrder方法Service里标注Transactional或由spring-service.xml里的事务切面包住方法内先扣菜品库存、生成订单、创建配送记录任何一个步骤失败都要回滚否则会出现库存扣了但订单没生成的数据不一致。这一点第五章避坑里还会展开。4.3 超时未接单的兜底定时任务还是手动补偿校园外卖场景中用户下单后商家长时间不接单需要在设定时间后自动取消。源码里如果实现了这个功能通常是在spring-service.xml里开启定时任务或者用Spring的Scheduled注解。如果接手时没有实现最简单的兜底方案是写一个接口由管理员手动触发或者用系统定时任务调用Java程序不一定要引入分布式任务调度中间件。Component public class OrderTimeoutTask { Scheduled(fixedDelay 60000) Transactional public void cancelTimeoutOrders() { // 查最近15分钟仍处于0待接单状态的订单 // 批量把状态更新为4已取消 } }参数说明fixedDelay60000表示上一次执行完成后间隔60秒再执行下一次适合这种轻量级补偿任务。注意Transactional要加在方法上或由Spring事务切面包住保证批量更新中途失败能回滚。定时任务里只做订单状态变更不要在这里发通知或操作第三方接口否则阻塞后会拖垮线程池。5. 避坑SSM老项目部署时最常见的5个报错现场5.1 zip解压后中文乱码、目录嵌套两层导致IDEA不识别现象Windows自带解压工具把zip展开后中文文件名变成乱码工程目录下又套了一层同名文件夹IDEA导入后没有Maven项目标记。原因zip包里文件名编码是UTF-8Windows自带解压默认按GBK解码导致乱码而不少源码zip是直接在打包目录上右键压缩的解压出来多一层嵌套。解决用7-Zip或WinRAR右键解压并在IDEA里直接打开最内层含pom.xml的目录作为项目根。工程路径不要放在桌面或带中文、空格的路径下否则Maven和Tomcat都可能出现奇怪问题。另外解压后先看pom.xml是否完整文件大小如果只有几KB很可能是一个空壳项目。5.2 Tomcat启动报java.lang.NoClassDefFoundError: javax/xml/bind现象JDK 11及以上环境启动Tomcat加载Spring时报javax/xml/bind/JAXBException找不到类工程无法启动。原因javax.xml.bind从JDK 9开始被模块化移除JRE不再自带而老SSM工程里Spring或MyBatis依赖它做XML解析。解决最稳的办法是装JDK 8并让项目使用JDK 8编译运行这是SSM老工程的标准环境。如果必须用高版本JDK就在pom.xml里手动引入javax.xml.bind相关依赖但这样还要处理javax.activation等连带包改动面更大不如直接换环境。5.3 MySQL 8.0连不上SSL握手失败、时区报错、认证失败现象数据库连接报Communications link failure、The server time zone value、客户端不支持服务器请求的认证协议。原因MySQL 8.0默认使用caching_sha2_password认证而老驱动mysql-connector-java 5.x默认用mysql_native_password同时8.0对SSL和时区要求更严格老url里没有对应参数。解决如果源码自带的是5.x驱动可以换成8.0.x驱动并把jdbc.properties改成配套写法jdbc.drivercom.mysql.cj.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/campus_takeout?useUnicodetruecharacterEncodingutf8useSSLfalseserverTimezoneAsia/ShanghaiallowPublicKeyRetrievaltrue jdbc.usernameroot jdbc.password你的密码参数说明allowPublicKeyRetrievaltrue是MySQL 8.0连接时第一次认证获取公钥用的不加可能报Public Key Retrieval is not allowed。driver必须写成com.mysql.cj.jdbc.Driver不能再是旧的com.mysql.jdbc.Driver。如果你还是想用5.7数据库就跳过这段不用改驱动。5.4 启动成功但访问404SpringMVC包扫描不到Controller或上下文路径不对现象Tomcat日志显示部署成功页面能打开但点击登录请求接口返回404或者所有JSP页面都打不开。原因spring-mvc.xml里的 context:component-scan 包名写错导致Controller没被注册或者web.xml里DispatcherServlet的url-pattern配置成*.do而页面ajax请求的是.json或裸路径还有一个常见原因是部署后的war包名和页面里写死的上下文路径不一致。解决先看Tomcat日志有没有“RequestMappingHandlerMapping”相关注册信息再用IDEA的Deployment配置页检查Application context比如war包叫campus-takeout-1.0页面里ajax地址写/campus-takeout/xxx就会404。最省事的方法是把war包重命名成ROOT.war部署这样上下文路径就是根路径所有请求直接走相对路径绕开上下文不一致的坑。5.5 启动报Invalid bound statement (not found)Mapper XML没被打进war包现象Tomcat启动成功登录或查列表时Service层调用dao方法报org.apache.ibatis.binding.BindingException: Invalid bound statement (not found)。原因源码把mapper XML放在了src/main/java的dao同包目录下而pom.xml没有对resources做扩展配置Maven默认只把src/main/resources下的文件打进包导致target/classes里没有XML文件MyBatis绑定不上SQL。解决在pom.xml的build节点里配置resources把src/main/java下的xml和properties也收进编译产物build resources resource directorysrc/main/java/directory includes include**/*.xml/include /includes /resource resource directorysrc/main/resources/directory /resource /resources /build参数说明这个配置的作用是让Maven在编译时额外把dao包下的XML复制到target/classes对应目录。改完之后重新执行mvn clean package确认target/classes/.../dao/下面有XML文件再部署。如果源码原本就把XML放在resources/mapper下就不用改pom检查mybatis-config.xml里的mapper-locations路径是否指向classpath:mapper/*.xml。6. 从“能跑”到“能讲清楚”交付演示前的日志、事务与异常验证源码能在本地跑通只完成了一半另一半是把系统逻辑讲清楚并证明它经得起提问。我每次交付这类SSM项目前至少会做三件事一是打开SQL日志确认每个操作真的落了库二是在订单创建里人为制造异常验证事务回滚三是在答辩演示前固定一套演示脚本不用临场乱点。日志是最直接的验证手段。mybatis-config.xml里把日志级别调成DEBUG控制台就能看到每条SQL和传入参数settings setting namelogImpl valueSTDOUT_LOGGING/ /settings参数说明STDOUT_LOGGING让MyBatis把SQL和执行结果直接打印到控制台适合本地调试。上线前要改回log4j2或SLF4J接日志文件避免日志刷屏影响性能。验证事务回滚更简单在订单Service的扣库存和生成订单之间临时抛个RuntimeException如果订单没有生成且库存保持原值说明事务生效验证完删掉这行。骑手抢单的演示脚本也要固定准备三个测试账号分别对应用户、商家、骑手提前造好几条测试订单演示时按“用户下单 → 商家接单 → 骑手抢单 → 确认送达 → 订单完成”的顺序走每个状态切换看一眼数据库里orders表和delivery表的变化评委问状态流时直接对着表讲。另一个容易被问到的坑是库存超卖。如果dish表里没有库存字段或者下单逻辑里只查不扣演示时连续点两次下单也不会被发现但一旦被问到并发就会露馅。我的习惯是给菜品加上库存字段并在下单SQL里用条件更新扣减UPDATE dish SET stock stock - 1 WHERE id #{dishId} AND stock 0这条SQL同样是原子操作影响行数为0说明库存不足直接提示用户。把这一层的SQL设计讲清楚整个系统的技术含量会明显高出普通课设一截。最后的建议是把默认账号密码固化下来用固定账号演示而不是现场注册新用户能省掉很多输入和校验的等待时间。SSM老项目维护到现在真正的工作量早就不在“让它跑起来”上而在你能不能在跑起来之后说清楚每一条数据是怎么流动的。希望帮到你。本文还有配套的精品资源点击获取