简介基于Spring、SpringMVC与MyBatis构建的校园活动信息平台是一份完整的SSM项目源码面向正在学习Java Web开发、希望掌握企业级应用分层思想的开发者。项目围绕活动发布、浏览、报名与互动交流展开代码中清晰呈现了依赖注入、模型-视图-控制器请求处理、MyBatis持久化映射、数据库表设计活动表、用户表、报名表以及Spring Security安全控制等核心实践并涉及REST风格接口与单元测试方法从活动信息的管理到报名状态跟踪均有完整实现其中数据库表之间的关联关系与外键约束也得以体现适合用于课程设计、毕业设计或SSM三框架整合训练。压缩包约220KB已有282人学习下载。配套目录结构清晰便于按模块阅读和调试。通过研读源码可系统理解业务层、持久层与数据库之间的协作方式提升真实项目中的开发效率与排错能力是一份值得反复阅读和实践的参考资料。1. 拿到SSM校园活动信息平台源码包先别急着解压SSM是Spring、SpringMVC和MyBatis三种技术组合的常用缩写它在校园活动信息平台这类管理系统里出现了十年以上直到今天依然是毕业设计和课程实训中最高频的选题之一。标题压缩包里装的是一份完整的Web工程源码不是点开就能用的安装包。你拿到的本质上是Spring容器、SpringMVC路由和MyBatis映射三套配置的合集真正的核心任务是把数据库、Maven依赖和Tomcat部署环境串联起来。这篇文章按我平时接手这类项目时的实际操作顺序展开先看工程结构再配数据库和运行环境然后过一遍关键功能代码的实现逻辑最后把部署时最容易踩的几个坑列出来。无论你是刚开始写SSM的新手还是已经写过几个管理系统的熟手这套流程可以直接套用。2. 解压后先看工程结构SSM三件套在项目里的实际职责2.1 打开压缩包先找三个坐标文件ZIP完整度立刻见分晓压缩包的解压方式每个人习惯不同我的习惯是不管用什么压缩工具第一步先“查看”而不是“解压”。先看顶层结构再决定从哪开始动手。如果根目录没有pom.xml那意味着它可能是一个war目录结构或老式WEB-INF工程处理方式完全不一样。课程设计里最常用的还是Maven结构一个标准SSM项目的布局是下面这个形态campus-activity/ ├── pom.xml ├── sql/ │ └── campus_activity.sql └── src/main/ ├── java/com/campus/ │ ├── controller/ │ │ ├── UserController.java │ │ └── ActivityController.java │ ├── service/ │ │ ├── UserService.java │ │ └── impl/ │ ├── dao/ │ │ ├── UserMapper.java │ │ └── ActivityMapper.java │ └── entity/ │ ├── User.java │ └── Activity.java ├── resources/ │ ├── jdbc.properties │ ├── spring-context.xml │ ├── spring-mvc.xml │ └── mybatis/ │ ├── UserMapper.xml │ └── ActivityMapper.xml └── webapp/ ├── WEB-INF/web.xml └── jsp/ ├── login.jsp └── activity/ ├── list.jsp └── edit.jsp压缩包里如果同时具备pom.xml、sql脚本、src/main/resources和src/main/webapp那基本能判断这是一个可以完整跑起来的SSM工程。缺少任何一块都要先补充配置否则项目编译能过运行时会卡在某个环节报错。解开ZIP之后我一般会按一个固定的顺序去读代码先看entity把数据模型理清再读Mapper接口和XML然后看Service最后才看Controller。很多新手习惯从Controller入口点进去看看到Service接口又跳进去结果被多层调用绕晕。实体类字段对应数据库列Mapper XML里是真正执行的SQL这两样先对上后面所有业务逻辑自然就通了。2.2 一次请求在SSM中经历的分层流转SSM的三个框架容易被当成一个整体但它们在项目里的职责分得很清楚。Spring负责包扫描、依赖注入和事务管理SpringMVC负责HTTP请求的路由和视图解析MyBatis负责SQL与Java对象的映射。拿“查看活动列表”这个最常见请求举例一次完整调用是这样的浏览器请求/activity/list请求首先到达web.xml里注册的DispatcherServlet。这个Servlet会被映射到/接管所有进入的HTTP请求。DispatcherServlet根据URL去找HandlerMapping定位到ActivityController中标注了RequestMapping(/activity/list)的方法。方法里注入了ActivityServiceSpring容器启动时会从spring-context.xml配置的组件扫描中把这个Service实现类找出来并注入。ActivityServiceImpl内部又注入了ActivityMapper这是MyBatis生成的代理接口执行的是ActivityMapper.xml里对应id的查询语句。数据返回后Controller把它放进Model通过InternalResourceViewResolver解析到/WEB-INF/jsp/activity/list.jsp最终渲染成页面返回浏览器。这条链路中任何一环缺失异常的特征都不一样下面这张表可以作为排错索引容易出问题的地方关键配置位置报错特征DispatcherServlet没有拦截请求web.xml中的url-patternTomcat日志里没有请求进入记录Service注入失败spring-context.xml的component-scan启动时抛NoSuchBeanDefinitionExceptionMapper代理没有生成spring-context.xml中的mapper-scan启动报BeanCreationExceptionSQL与接口方法对不上mybatis目录里XML的namespace和id调用时抛Invalid bound statement (not found)视图解析失败spring-mvc.xml的InternalResourceViewResolverController执行了但页面404遇到Invalid bound statement这类问题直接对比接口方法名和XML的id值不要漫无目的地翻配置。SSM的排错节奏是先确认报错属于哪一层再只盯那一个文件效率会高很多。2.3 源码里常见的几类写法先分清楚再动手改SSM项目源码在网上流传的版本很多但写法差异并不大。一种是用注解XML混合配置Controller和Service用Controller、Service注解MyBatis的SQL放在XML文件里这是最容易维护的形式。另一种是极端到所有SQL都写在Mapper接口的注解里比如Select(select * from activity)这种写法让整个项目少了很多配置文件但复杂SQL拼接时会非常痛苦。还有一类老项目会在src目录下放一个lib目录依赖不通过Maven管理这种包我不建议继续在上面加功能依赖版本和冲突问题迟早会把你拖住。我一般会先检查pom.xml里Spring和MyBatis的版本再看jdbc.properties里数据库类型这两个信息决定了后续环境搭建的路径。另外压缩包里如果出现了名为“毕业设计”或“课程设计”的说明文档里面通常会写清楚默认账号和数据库名先读文档再动代码这是避免走弯路的最好方法。3. 在本地把SSM校园活动平台跑起来数据库、依赖与Tomcat3.1 用SQL脚本初始化数据库注意字符集和时区这一章要解决的是“能运行”的问题。顺序上有讲究先建数据库再改连接配置然后处理Maven依赖最后部署到Tomcat。数据库是第一个环节压缩包里一般有.sql脚本没有的话就根据entity自己建。一个校园活动信息平台最少需要三张表用户表、活动表、报名关联表。以下是合并后的初始脚本CREATE DATABASE IF NOT EXISTS campus_activity DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; USE campus_activity; CREATE TABLE sys_user ( id INT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(50) NOT NULL UNIQUE, password VARCHAR(64) NOT NULL, role TINYINT NOT NULL DEFAULT 1 COMMENT 1-学生 2-管理员 ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE activity ( id INT PRIMARY KEY AUTO_INCREMENT, title VARCHAR(100) NOT NULL, content TEXT, start_time DATETIME, end_time DATETIME, max_people INT DEFAULT 50, participants INT DEFAULT 0, status TINYINT DEFAULT 1 COMMENT 1-报名中 2-已结束, create_by INT NOT NULL ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE activity_user ( id INT PRIMARY KEY AUTO_INCREMENT, activity_id INT NOT NULL, user_id INT NOT NULL, sign_time DATETIME DEFAULT CURRENT_TIMESTAMP ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; INSERT INTO sys_user(username, password, role) VALUES(admin, e10adc3949ba59abbe56e057f20f883e, 2);这里有几个细节。数据库用utf8mb4而不是utf8因为活动内容里可能包含emojiutf8mb4是utf8的超集排序规则用utf8mb4_general_ci就够用。activity表里用participants冗余字段记录当前报名人数避免列表页每次都count报名表这是活动类系统常见的设计。最后一段INSERT插入了管理员账号密码字段值是“123456”的MD5SSM入门项目里普遍采用这种存储方式。导入脚本时用Navicat或DataGrip连接MySQL直接运行即可也可以用命令行mysql -uroot -p campus_activity.sql导入后执行use campus_activity; show tables;能看到三张表就说明脚本执行正常。如果报Unknown database说明第一行建库语句没执行成功单独复制那行先跑一遍。3.2 修改jdbc.properties和Maven镜像依赖下载不要硬等数据库准备好以后找到src/main/resources/jdbc.properties这是SSM连接数据库的命门。默认内容通常长这样jdbc.drivercom.mysql.cj.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/campus_activity?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghaiuseSSLfalse jdbc.usernameroot jdbc.password你的密码参数说明驱动类在MySQL 6.0以上必须写成com.mysql.cj.jdbc.Driver老版本的com.mysql.jdbc.Driver在新驱动里被移除了。serverTimezoneAsia/Shanghai必须保留否则启动连接时报时区错误。characterEncodingutf8要和建库时的utf8mb4保持兼容乱码问题多半出在这一项。把用户名密码改成你本机的值后先用客户端工具用同一套参数手动连一次能连上再继续。依赖层面最影响体验的是Maven下载速度。中央仓库在海外网络环境下经常超时修改Maven全局settings.xml在mirrors节点下添加阿里云镜像mirrors mirror idaliyunmaven/id mirrorOfcentral/mirrorOf urlhttps://maven.aliyun.com/repository/public/url /mirror /mirrors这个配置只替换central中央仓库不影响项目里其它自定义repository。修改后如果当前工程还是拉不下来依赖可以清掉本地仓库缓存rm -rf ~/.m2/repository/org/springframework ~/.m2/repository/org/mybatis然后再执行一次构建。依赖下载失败的典型特征是pom.xml第一行出现红色波浪线IDEA里检查Dependencies面板就可以直观看到断开的依赖列表。3.3 用一条命令打包部署进Tomcat后用日志验证Maven里最常用的一条命令是mvn clean package -DskipTestsclean清掉target目录package编译并打包成war-DskipTests跳过测试减少一半时间。命令执行完成后target目录下会生成类似campus-activity.war的文件。接着把这个war复制到Tomcat的webapps目录启动cp target/campus-activity.war /opt/tomcat/webapps/ cd /opt/tomcat/bin ./startup.sh tail -f /opt/tomcat/logs/catalina.out启动后重点看两类日志第一类是Spring容器日志出现Root WebApplicationContext initialized说明Spring和MyBatis配置通过第二类是部署完成日志出现Deployment of web application archive [campus-activity.war] has finished就可以访问了。浏览器打开http://localhost:8080/campus-activity/能看到登录页说明环境已经打通。如果页面直接报500或连接异常回到catalina.out里看堆栈第一行会有具体异常类型而不是盲目改代码。验证步骤预期结果不通过时优先检查执行初始化SQL生成三张表SQL脚本编码、MySQL权限Maven构建BUILD SUCCESSpom.xml依赖、镜像配置启动Tomcat无异常堆栈jdbc.properties、端口占用访问首页出现登录页面web.xml、视图路径4. 校园活动平台核心代码登录拦截、活动发布和报名流程4.1 登录状态用拦截器统一校验不用每个Controller重复判断校园活动平台里有一类特殊的页面和接口只有登录后才能访问。常见做法是在SpringMVC层面配一个处理器拦截器把公共的校验逻辑集中到一处。自定义拦截器的代码通常长这样public class LoginInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { Object loginUser request.getSession().getAttribute(loginUser); if (loginUser null) { response.sendRedirect(request.getContextPath() /login); return false; } return true; } }这个类的逻辑很直接从session里取loginUser取不到就重定向到登录页并返回false阻断后续执行。取到了就返回true让请求继续走Controller。要注意的是拦截器必须注册到spring-mvc.xml里才生效mvc:interceptors mvc:interceptor mvc:mapping path/**/ mvc:exclude-mapping path/login/ mvc:exclude-mapping path/register/ mvc:exclude-mapping path/static/**/ bean classcom.campus.interceptor.LoginInterceptor/ /mvc:interceptor /mvc:interceptors这里最容易被忽视的是exclude-mapping。我把登录接口和静态资源目录都排除掉了否则登录页的CSS和JS会被拦截页面打开时样式全丢。还有一种典型错误是排除了/login却忘了排除登录表单提交时的路径提交请求被拦截后一直弹回登录页浏览器出现“重定向次数过多”的提示。4.2 活动发布的后端控制权限校验和字段补全活动发布是管理员专属操作后端不能只依赖前端隐藏按钮必须在接口层判断当前登录用户的角色。Controller里常见的写法是这样的Controller RequestMapping(/activity) public class ActivityController { Autowired private ActivityService activityService; PostMapping(/publish) public String publish(Activity activity, HttpSession session) { User current (User) session.getAttribute(loginUser); if (current null || current.getRole() ! 2) { return redirect:/login; } activity.setCreateBy(current.getId()); activity.setStatus(1); activity.setParticipants(0); activityService.add(activity); return redirect:/activity/list; } }这段代码包含两处关键设计。第一处Controller不信任前端传来的createBy、status、participants字段不管表单里提交了什么后台都按合法值覆盖。第二处权限判断放在Controller开头拦截器只解决了“登录没登录”的问题不解决“是不是管理员”的问题所以这里必须再判一次角色。如果你把普通学生的会话打开手工构造一个POST请求打/activity/publish正确结果是跳回登录页或给出无权限提示。Service层这里至少做一次业务校验活动结束时间不能早于开始时间标题不能为空。把这些规则放到ServiceImpl里而不是Controller里是为了将来出现第二个调用这个Service的入口时逻辑不会重写一遍。4.3 报名功能要过事务这一关动态SQL也要注意更新条件报名这个动作涉及两处写入报名关联表插入一条记录同时活动表的参与人数加一。Mapper接口定义两个方法public interface ActivityMapper { int signUp(Param(activityId) Integer activityId, Param(userId) Integer userId); int increaseParticipants(Param(activityId) Integer activityId); }对应的XML实现长这样insert idsignUp INSERT INTO activity_user(activity_id, user_id) VALUES(#{activityId}, #{userId}) /insert update idincreaseParticipants UPDATE activity SET participants participants 1 WHERE id #{activityId} AND status 1 AND participants max_people /updateincreaseParticipants的WHERE里加了两个条件活动处于报名中、当前人数没满。这样把“超员”问题的兜底放在SQL层比Java里先查再判更可靠。但如果只靠这两条SQL默认自动提交模式下会出现“关联表多了一条记录、活动人数没增加”的脏数据。解决方式是把两步操作放进同一个事务Transactional(rollbackFor Exception.class) public boolean signUp(Integer activityId, Integer userId) { int inserted activityMapper.signUp(activityId, userId); if (inserted 0) { return false; } int updated activityMapper.increaseParticipants(activityId); if (updated 0) { throw new RuntimeException(活动已满或已结束); } return true; }Transactional让两个Mapper操作共享同一个数据库事务任意一步异常都会整体回滚。这里还有一个容易被忽略点increaseParticipants返回0并不代表没有执行而是UPDA TE影响行数为0说明人数已满或活动状态不对把它视为业务失败主动抛异常回滚插入记录。这个设计在并发量不大时足够用真实高并发报名场景还需要加行锁或Redis预扣减但SSM项目源码里能把事务边界写正确已经合格。5. 部署阶段的三类高频报错以及ZIP压缩包交付的检查细节5.1 Invalid bound statement、乱码和404先从这些位置入手SSM部署阶段的高频问题里“Invalid bound statement (not found)”排第一。这个报错表面意思是“找不到对应SQL”实际原因四成是Mapper XML没有被打包进classes目录。在IDEA里调试正常、用命令行打包后部署却报这个错就是Maven默认不处理src/main/java下的XML。需要在pom.xml里补充资源声明build resources resource directorysrc/main/java/directory includes include**/*.xml/include /includes /resource resource directorysrc/main/resources/directory /resource /resources /build第二类是中文乱码。检查顺序固定为JSP里的pageEncoding是否UTF-8、web.xml里有没有CharacterEncodingFilter、jdbc连接url是否带characterEncoding。CharacterEncodingFilter建议放在过滤器链最前面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第三类是页面404。接口日志显示Controller执行了但页面找不到问题在spring-mvc.xml里的InternalResourceViewResolver前后缀应指向/WEB-INF/jsp/和.jsp目录结构必须与之一致。5.2 从ZIP交付角度做一次干净解压验证最后分享我拿到任何SSM项目源码包都会执行的一个流程把压缩包复制到一个全新目录用能正确识别中文文件名的压缩工具重新解压一次然后直接在命令行构建mvn -v java -version mvn clean package -DskipTests第一条命令确认环境变量第二条命令把整个工程从零编译一遍。这一步能暴露绝大多数ZIP交付问题缺失的sql目录、路径过长的多层文件夹、文件名乱码导致的资源加载失败。如果构建通过且war能正常启动这个压缩包就是可交付状态。如果中途报错优先检查解压后的目录名里是否含有空格或中文Tomcat和部分Maven插件对带空格的路径支持并不友好把工程放到/opt/projects/campus-activity这类纯英文路径下再构建一次问题通常会消失。推荐把sql脚本和一份简短的部署说明一并打包进去让别人拿到压缩包后十分钟内能跑起来而不是再花半天猜配置。本文还有配套的精品资源点击获取 SSM校园活动平台源码部署指南：从工程结构到Tomcat运行全解析
简介基于Spring、SpringMVC与MyBatis构建的校园活动信息平台是一份完整的SSM项目源码面向正在学习Java Web开发、希望掌握企业级应用分层思想的开发者。项目围绕活动发布、浏览、报名与互动交流展开代码中清晰呈现了依赖注入、模型-视图-控制器请求处理、MyBatis持久化映射、数据库表设计活动表、用户表、报名表以及Spring Security安全控制等核心实践并涉及REST风格接口与单元测试方法从活动信息的管理到报名状态跟踪均有完整实现其中数据库表之间的关联关系与外键约束也得以体现适合用于课程设计、毕业设计或SSM三框架整合训练。压缩包约220KB已有282人学习下载。配套目录结构清晰便于按模块阅读和调试。通过研读源码可系统理解业务层、持久层与数据库之间的协作方式提升真实项目中的开发效率与排错能力是一份值得反复阅读和实践的参考资料。1. 拿到SSM校园活动信息平台源码包先别急着解压SSM是Spring、SpringMVC和MyBatis三种技术组合的常用缩写它在校园活动信息平台这类管理系统里出现了十年以上直到今天依然是毕业设计和课程实训中最高频的选题之一。标题压缩包里装的是一份完整的Web工程源码不是点开就能用的安装包。你拿到的本质上是Spring容器、SpringMVC路由和MyBatis映射三套配置的合集真正的核心任务是把数据库、Maven依赖和Tomcat部署环境串联起来。这篇文章按我平时接手这类项目时的实际操作顺序展开先看工程结构再配数据库和运行环境然后过一遍关键功能代码的实现逻辑最后把部署时最容易踩的几个坑列出来。无论你是刚开始写SSM的新手还是已经写过几个管理系统的熟手这套流程可以直接套用。2. 解压后先看工程结构SSM三件套在项目里的实际职责2.1 打开压缩包先找三个坐标文件ZIP完整度立刻见分晓压缩包的解压方式每个人习惯不同我的习惯是不管用什么压缩工具第一步先“查看”而不是“解压”。先看顶层结构再决定从哪开始动手。如果根目录没有pom.xml那意味着它可能是一个war目录结构或老式WEB-INF工程处理方式完全不一样。课程设计里最常用的还是Maven结构一个标准SSM项目的布局是下面这个形态campus-activity/ ├── pom.xml ├── sql/ │ └── campus_activity.sql └── src/main/ ├── java/com/campus/ │ ├── controller/ │ │ ├── UserController.java │ │ └── ActivityController.java │ ├── service/ │ │ ├── UserService.java │ │ └── impl/ │ ├── dao/ │ │ ├── UserMapper.java │ │ └── ActivityMapper.java │ └── entity/ │ ├── User.java │ └── Activity.java ├── resources/ │ ├── jdbc.properties │ ├── spring-context.xml │ ├── spring-mvc.xml │ └── mybatis/ │ ├── UserMapper.xml │ └── ActivityMapper.xml └── webapp/ ├── WEB-INF/web.xml └── jsp/ ├── login.jsp └── activity/ ├── list.jsp └── edit.jsp压缩包里如果同时具备pom.xml、sql脚本、src/main/resources和src/main/webapp那基本能判断这是一个可以完整跑起来的SSM工程。缺少任何一块都要先补充配置否则项目编译能过运行时会卡在某个环节报错。解开ZIP之后我一般会按一个固定的顺序去读代码先看entity把数据模型理清再读Mapper接口和XML然后看Service最后才看Controller。很多新手习惯从Controller入口点进去看看到Service接口又跳进去结果被多层调用绕晕。实体类字段对应数据库列Mapper XML里是真正执行的SQL这两样先对上后面所有业务逻辑自然就通了。2.2 一次请求在SSM中经历的分层流转SSM的三个框架容易被当成一个整体但它们在项目里的职责分得很清楚。Spring负责包扫描、依赖注入和事务管理SpringMVC负责HTTP请求的路由和视图解析MyBatis负责SQL与Java对象的映射。拿“查看活动列表”这个最常见请求举例一次完整调用是这样的浏览器请求/activity/list请求首先到达web.xml里注册的DispatcherServlet。这个Servlet会被映射到/接管所有进入的HTTP请求。DispatcherServlet根据URL去找HandlerMapping定位到ActivityController中标注了RequestMapping(/activity/list)的方法。方法里注入了ActivityServiceSpring容器启动时会从spring-context.xml配置的组件扫描中把这个Service实现类找出来并注入。ActivityServiceImpl内部又注入了ActivityMapper这是MyBatis生成的代理接口执行的是ActivityMapper.xml里对应id的查询语句。数据返回后Controller把它放进Model通过InternalResourceViewResolver解析到/WEB-INF/jsp/activity/list.jsp最终渲染成页面返回浏览器。这条链路中任何一环缺失异常的特征都不一样下面这张表可以作为排错索引容易出问题的地方关键配置位置报错特征DispatcherServlet没有拦截请求web.xml中的url-patternTomcat日志里没有请求进入记录Service注入失败spring-context.xml的component-scan启动时抛NoSuchBeanDefinitionExceptionMapper代理没有生成spring-context.xml中的mapper-scan启动报BeanCreationExceptionSQL与接口方法对不上mybatis目录里XML的namespace和id调用时抛Invalid bound statement (not found)视图解析失败spring-mvc.xml的InternalResourceViewResolverController执行了但页面404遇到Invalid bound statement这类问题直接对比接口方法名和XML的id值不要漫无目的地翻配置。SSM的排错节奏是先确认报错属于哪一层再只盯那一个文件效率会高很多。2.3 源码里常见的几类写法先分清楚再动手改SSM项目源码在网上流传的版本很多但写法差异并不大。一种是用注解XML混合配置Controller和Service用Controller、Service注解MyBatis的SQL放在XML文件里这是最容易维护的形式。另一种是极端到所有SQL都写在Mapper接口的注解里比如Select(select * from activity)这种写法让整个项目少了很多配置文件但复杂SQL拼接时会非常痛苦。还有一类老项目会在src目录下放一个lib目录依赖不通过Maven管理这种包我不建议继续在上面加功能依赖版本和冲突问题迟早会把你拖住。我一般会先检查pom.xml里Spring和MyBatis的版本再看jdbc.properties里数据库类型这两个信息决定了后续环境搭建的路径。另外压缩包里如果出现了名为“毕业设计”或“课程设计”的说明文档里面通常会写清楚默认账号和数据库名先读文档再动代码这是避免走弯路的最好方法。3. 在本地把SSM校园活动平台跑起来数据库、依赖与Tomcat3.1 用SQL脚本初始化数据库注意字符集和时区这一章要解决的是“能运行”的问题。顺序上有讲究先建数据库再改连接配置然后处理Maven依赖最后部署到Tomcat。数据库是第一个环节压缩包里一般有.sql脚本没有的话就根据entity自己建。一个校园活动信息平台最少需要三张表用户表、活动表、报名关联表。以下是合并后的初始脚本CREATE DATABASE IF NOT EXISTS campus_activity DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; USE campus_activity; CREATE TABLE sys_user ( id INT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(50) NOT NULL UNIQUE, password VARCHAR(64) NOT NULL, role TINYINT NOT NULL DEFAULT 1 COMMENT 1-学生 2-管理员 ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE activity ( id INT PRIMARY KEY AUTO_INCREMENT, title VARCHAR(100) NOT NULL, content TEXT, start_time DATETIME, end_time DATETIME, max_people INT DEFAULT 50, participants INT DEFAULT 0, status TINYINT DEFAULT 1 COMMENT 1-报名中 2-已结束, create_by INT NOT NULL ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE activity_user ( id INT PRIMARY KEY AUTO_INCREMENT, activity_id INT NOT NULL, user_id INT NOT NULL, sign_time DATETIME DEFAULT CURRENT_TIMESTAMP ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; INSERT INTO sys_user(username, password, role) VALUES(admin, e10adc3949ba59abbe56e057f20f883e, 2);这里有几个细节。数据库用utf8mb4而不是utf8因为活动内容里可能包含emojiutf8mb4是utf8的超集排序规则用utf8mb4_general_ci就够用。activity表里用participants冗余字段记录当前报名人数避免列表页每次都count报名表这是活动类系统常见的设计。最后一段INSERT插入了管理员账号密码字段值是“123456”的MD5SSM入门项目里普遍采用这种存储方式。导入脚本时用Navicat或DataGrip连接MySQL直接运行即可也可以用命令行mysql -uroot -p campus_activity.sql导入后执行use campus_activity; show tables;能看到三张表就说明脚本执行正常。如果报Unknown database说明第一行建库语句没执行成功单独复制那行先跑一遍。3.2 修改jdbc.properties和Maven镜像依赖下载不要硬等数据库准备好以后找到src/main/resources/jdbc.properties这是SSM连接数据库的命门。默认内容通常长这样jdbc.drivercom.mysql.cj.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/campus_activity?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghaiuseSSLfalse jdbc.usernameroot jdbc.password你的密码参数说明驱动类在MySQL 6.0以上必须写成com.mysql.cj.jdbc.Driver老版本的com.mysql.jdbc.Driver在新驱动里被移除了。serverTimezoneAsia/Shanghai必须保留否则启动连接时报时区错误。characterEncodingutf8要和建库时的utf8mb4保持兼容乱码问题多半出在这一项。把用户名密码改成你本机的值后先用客户端工具用同一套参数手动连一次能连上再继续。依赖层面最影响体验的是Maven下载速度。中央仓库在海外网络环境下经常超时修改Maven全局settings.xml在mirrors节点下添加阿里云镜像mirrors mirror idaliyunmaven/id mirrorOfcentral/mirrorOf urlhttps://maven.aliyun.com/repository/public/url /mirror /mirrors这个配置只替换central中央仓库不影响项目里其它自定义repository。修改后如果当前工程还是拉不下来依赖可以清掉本地仓库缓存rm -rf ~/.m2/repository/org/springframework ~/.m2/repository/org/mybatis然后再执行一次构建。依赖下载失败的典型特征是pom.xml第一行出现红色波浪线IDEA里检查Dependencies面板就可以直观看到断开的依赖列表。3.3 用一条命令打包部署进Tomcat后用日志验证Maven里最常用的一条命令是mvn clean package -DskipTestsclean清掉target目录package编译并打包成war-DskipTests跳过测试减少一半时间。命令执行完成后target目录下会生成类似campus-activity.war的文件。接着把这个war复制到Tomcat的webapps目录启动cp target/campus-activity.war /opt/tomcat/webapps/ cd /opt/tomcat/bin ./startup.sh tail -f /opt/tomcat/logs/catalina.out启动后重点看两类日志第一类是Spring容器日志出现Root WebApplicationContext initialized说明Spring和MyBatis配置通过第二类是部署完成日志出现Deployment of web application archive [campus-activity.war] has finished就可以访问了。浏览器打开http://localhost:8080/campus-activity/能看到登录页说明环境已经打通。如果页面直接报500或连接异常回到catalina.out里看堆栈第一行会有具体异常类型而不是盲目改代码。验证步骤预期结果不通过时优先检查执行初始化SQL生成三张表SQL脚本编码、MySQL权限Maven构建BUILD SUCCESSpom.xml依赖、镜像配置启动Tomcat无异常堆栈jdbc.properties、端口占用访问首页出现登录页面web.xml、视图路径4. 校园活动平台核心代码登录拦截、活动发布和报名流程4.1 登录状态用拦截器统一校验不用每个Controller重复判断校园活动平台里有一类特殊的页面和接口只有登录后才能访问。常见做法是在SpringMVC层面配一个处理器拦截器把公共的校验逻辑集中到一处。自定义拦截器的代码通常长这样public class LoginInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { Object loginUser request.getSession().getAttribute(loginUser); if (loginUser null) { response.sendRedirect(request.getContextPath() /login); return false; } return true; } }这个类的逻辑很直接从session里取loginUser取不到就重定向到登录页并返回false阻断后续执行。取到了就返回true让请求继续走Controller。要注意的是拦截器必须注册到spring-mvc.xml里才生效mvc:interceptors mvc:interceptor mvc:mapping path/**/ mvc:exclude-mapping path/login/ mvc:exclude-mapping path/register/ mvc:exclude-mapping path/static/**/ bean classcom.campus.interceptor.LoginInterceptor/ /mvc:interceptor /mvc:interceptors这里最容易被忽视的是exclude-mapping。我把登录接口和静态资源目录都排除掉了否则登录页的CSS和JS会被拦截页面打开时样式全丢。还有一种典型错误是排除了/login却忘了排除登录表单提交时的路径提交请求被拦截后一直弹回登录页浏览器出现“重定向次数过多”的提示。4.2 活动发布的后端控制权限校验和字段补全活动发布是管理员专属操作后端不能只依赖前端隐藏按钮必须在接口层判断当前登录用户的角色。Controller里常见的写法是这样的Controller RequestMapping(/activity) public class ActivityController { Autowired private ActivityService activityService; PostMapping(/publish) public String publish(Activity activity, HttpSession session) { User current (User) session.getAttribute(loginUser); if (current null || current.getRole() ! 2) { return redirect:/login; } activity.setCreateBy(current.getId()); activity.setStatus(1); activity.setParticipants(0); activityService.add(activity); return redirect:/activity/list; } }这段代码包含两处关键设计。第一处Controller不信任前端传来的createBy、status、participants字段不管表单里提交了什么后台都按合法值覆盖。第二处权限判断放在Controller开头拦截器只解决了“登录没登录”的问题不解决“是不是管理员”的问题所以这里必须再判一次角色。如果你把普通学生的会话打开手工构造一个POST请求打/activity/publish正确结果是跳回登录页或给出无权限提示。Service层这里至少做一次业务校验活动结束时间不能早于开始时间标题不能为空。把这些规则放到ServiceImpl里而不是Controller里是为了将来出现第二个调用这个Service的入口时逻辑不会重写一遍。4.3 报名功能要过事务这一关动态SQL也要注意更新条件报名这个动作涉及两处写入报名关联表插入一条记录同时活动表的参与人数加一。Mapper接口定义两个方法public interface ActivityMapper { int signUp(Param(activityId) Integer activityId, Param(userId) Integer userId); int increaseParticipants(Param(activityId) Integer activityId); }对应的XML实现长这样insert idsignUp INSERT INTO activity_user(activity_id, user_id) VALUES(#{activityId}, #{userId}) /insert update idincreaseParticipants UPDATE activity SET participants participants 1 WHERE id #{activityId} AND status 1 AND participants max_people /updateincreaseParticipants的WHERE里加了两个条件活动处于报名中、当前人数没满。这样把“超员”问题的兜底放在SQL层比Java里先查再判更可靠。但如果只靠这两条SQL默认自动提交模式下会出现“关联表多了一条记录、活动人数没增加”的脏数据。解决方式是把两步操作放进同一个事务Transactional(rollbackFor Exception.class) public boolean signUp(Integer activityId, Integer userId) { int inserted activityMapper.signUp(activityId, userId); if (inserted 0) { return false; } int updated activityMapper.increaseParticipants(activityId); if (updated 0) { throw new RuntimeException(活动已满或已结束); } return true; }Transactional让两个Mapper操作共享同一个数据库事务任意一步异常都会整体回滚。这里还有一个容易被忽略点increaseParticipants返回0并不代表没有执行而是UPDA TE影响行数为0说明人数已满或活动状态不对把它视为业务失败主动抛异常回滚插入记录。这个设计在并发量不大时足够用真实高并发报名场景还需要加行锁或Redis预扣减但SSM项目源码里能把事务边界写正确已经合格。5. 部署阶段的三类高频报错以及ZIP压缩包交付的检查细节5.1 Invalid bound statement、乱码和404先从这些位置入手SSM部署阶段的高频问题里“Invalid bound statement (not found)”排第一。这个报错表面意思是“找不到对应SQL”实际原因四成是Mapper XML没有被打包进classes目录。在IDEA里调试正常、用命令行打包后部署却报这个错就是Maven默认不处理src/main/java下的XML。需要在pom.xml里补充资源声明build resources resource directorysrc/main/java/directory includes include**/*.xml/include /includes /resource resource directorysrc/main/resources/directory /resource /resources /build第二类是中文乱码。检查顺序固定为JSP里的pageEncoding是否UTF-8、web.xml里有没有CharacterEncodingFilter、jdbc连接url是否带characterEncoding。CharacterEncodingFilter建议放在过滤器链最前面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第三类是页面404。接口日志显示Controller执行了但页面找不到问题在spring-mvc.xml里的InternalResourceViewResolver前后缀应指向/WEB-INF/jsp/和.jsp目录结构必须与之一致。5.2 从ZIP交付角度做一次干净解压验证最后分享我拿到任何SSM项目源码包都会执行的一个流程把压缩包复制到一个全新目录用能正确识别中文文件名的压缩工具重新解压一次然后直接在命令行构建mvn -v java -version mvn clean package -DskipTests第一条命令确认环境变量第二条命令把整个工程从零编译一遍。这一步能暴露绝大多数ZIP交付问题缺失的sql目录、路径过长的多层文件夹、文件名乱码导致的资源加载失败。如果构建通过且war能正常启动这个压缩包就是可交付状态。如果中途报错优先检查解压后的目录名里是否含有空格或中文Tomcat和部分Maven插件对带空格的路径支持并不友好把工程放到/opt/projects/campus-activity这类纯英文路径下再构建一次问题通常会消失。推荐把sql脚本和一份简短的部署说明一并打包进去让别人拿到压缩包后十分钟内能跑起来而不是再花半天猜配置。本文还有配套的精品资源点击获取