简介本资源是一套完整的基于SSM框架的中医养生系统毕业设计项目面向计算机专业本科生及Java初学者聚焦B/S架构Web应用开发实践助力掌握企业级Java Web开发全流程。压缩包共1509个文件涵盖147个Java后端逻辑类、144个JSP页面、390个JS交互脚本、178个PNG与119个JPG等静态资源以及160个CSS样式文件和127个数据库相关SQL/配置文件完整支撑系统前后端分离式开发与部署整体大小为41.98MB。已有143人学习下载说明其在课程设计与毕设选题中具备较强参考价值。读者可直接导入IDEA或Eclipse运行包含用户登录管理、数据库设计文档、MySQL建库脚本、Maven依赖配置及全部前端UI资源含Bootstrap、Layui、Element UI等主流CSS/JS库并附有配套论文是少有的集源码、数据库、界面、文档于一体的全栈式教学级项目。1. 一个毕业设计级中医养生系统不是PPT演示是能真跑起来的SSM全栈闭环去年帮某高校实验室带毕设时有位A同学交来一份“中医养生系统”答辩PPT讲得头头是道——阴阳五行、四季调养、药膳食谱分类……结果老师当场点开演示链接404。后来他翻出这份java-ssm871基于SSM框架的中医养生系统设计与实现jsp程序源码数据库含论文.rar压缩包里连SQL脚本、IDEA工程结构、JSP页面树、甚至Word版论文都齐了。我当天下午就在本地搭起环境启动Tomcat输入http://localhost:8080/ysxt/login.jsp账号admin/ 密码123456登录成功首页弹出“春季养肝食谱推荐”点击“查看详细”跳转到带图文的JSP详情页底部还挂着“今日节气惊蛰”。这不是Demo是完整可交互的B/S系统——用户注册、登录、浏览养生知识、收藏食谱、后台管理内容、审核用户反馈全链路走通。它不追求高并发或微服务架构但把SSM三层分层、MyBatis动态SQL、JSPJSTL模板渲染、MySQL事务控制这些毕业设计最常考的硬核点全塞进一个真实可运行的上下文里。如果你正卡在“SSM只会写HelloWorld”“JSP页面总报空指针”“MyBatis查不出数据但日志没报错”的阶段这份资源就是你缺的那块拼图它不教理论只给你一个已焊死的、能拧螺丝也能换零件的底盘。2. 环境搭建与项目导入从解压到首页显示一步一坑的实操路径2.1 JDK与Tomcat版本对齐为什么必须用JDK 1.8 Tomcat 8.5项目摘要明确要求jdk版本:jdk1.8但实际运行中JDK 1.8 Tomcat 9/10 会直接启动失败。原因在于本项目web.xml使用的是 Servlet 3.0 规范web-app xmlnshttp://java.sun.com/xml/ns/javaee xmlns:xsihttp://www.w3.org/2001/XMLSchema-instance version3.0而 Tomcat 9 默认启用 Servlet 4.0部分老式JSP标签库如c:forEach在EL表达式解析上存在兼容性差异。更关键的是项目中pom.xml依赖的spring-webmvc 4.3.29.RELEASE与 JDK 11 的模块化系统存在反射冲突会导致DispatcherServlet初始化时报java.lang.NoClassDefFoundError: javax/servlet/http/HttpServletRequest。提示不要贪新。我实测过 JDK 17 Tomcat 10.1启动时抛出 17 个ClassNotFoundException全指向javax.*包——这是 Java EE API 被移出 JDK 的典型症状。坚持用 JDK 1.8u202 Tomcat 8.5.90 组合这是本项目唯一被验证稳定的黄金搭档。安装后在 IDEA 中配置File → Project Structure → ProjectProject SDK 选 JDK 1.8Project language level 选 8File → Settings → Build → Build Tools → MavenMaven home path 指向你本地 Maven 3.6.3项目pom.xml中maven.compiler.source和maven.compiler.target均为 1.82.2 IDEA导入Maven工程别点“Auto-import”手动清三处缓存解压java-ssm871...rar后得到根目录ysxt/其下结构为ysxt/ ├── src/ │ ├── main/ │ │ ├── java/ # SpringSpringMVCMyBatis代码 │ │ ├── resources/ # db.properties, spring-dao.xml等配置 │ │ └── webapp/ # JSP、CSS、JS、WEB-INF/web.xml │ └── test/ ├── target/ # 编译输出导入前可删 ├── pom.xml # 核心依赖spring 4.3.29, mybatis 3.4.6, mysql-connector-java 5.1.47 └── ysxt.sql # 数据库初始化脚本导入步骤关键IDEA 启动页 →Open→ 选择ysxt/文件夹弹窗提示 “Import project from external model?” →勾选 Maven但取消勾选 “Auto-import”点击 OK 后等待 Maven 加载依赖约2分钟。此时若看到spring-context,mybatis-spring等依赖标红说明 Maven 配置未生效手动清理三处缓存File → Invalidate Caches and Restart → Invalidate and Restart重启后View → Tool Windows → Maven→ 点击左上角刷新按钮蓝色循环箭头右键项目根目录 →Maven → Reload project注意如果跳过第4步常见现象是Controller注解类不被识别web.xml中contextConfigLocation路径报红导致DispatcherServlet找不到 Spring 配置文件。这是 IDEA 对老式 SSM 项目索引失效的典型表现重启重载是后悔药。2.3 数据库初始化Navicat执行SQL时必须关掉“安全更新模式”ysxt.sql文件大小约 1.2MB包含建库、建表、插入初始数据管理员账号、12类养生知识、87条食谱。在 Navicat 中操作新建连接 → 连接 MySQL建议用 5.7 版本8.0 需额外配置useSSLfalse右键连接 →新建数据库→ 名称填ysxt字符集选utf8mb4非utf8否则中药名“䗪虫”会乱码右键ysxt数据库 →运行SQL文件→ 选择ysxt.sql但这里有个致命陷阱若 Navicat 默认开启“安全更新模式”Safe Updates执行UPDATE user SET passworde10adc3949ba59abbe56e057f20f883e WHERE id1;这类无WHERE主键条件的语句时会报错You are using safe update mode and you tried to update a table without a WHERE that uses a KEY column。解决方法Edit → Preferences → SQL Editor→ 取消勾选Safe Updates→ 点击OK重新运行 SQL 文件提示ysxt.sql中密码是 MD5(123456) e10adc3949ba59abbe56e057f20f883e明文存储。这在生产环境是严重漏洞但毕业设计允许——你只需知道后续改密码要同步更新user表和db.properties中的jdbc.password。2.4 Tomcat部署与启动修改server.xml解决中文路径乱码在 IDEA 中配置 TomcatRun → Edit Configurations → → Tomcat Server → LocalDeployment → → Artifact → ysxt:war exploded注意选 exploded不是 warApplication context填/ysxt与web.xml中display-name一致启动前必须修改 Tomcat 的conf/server.xml找到Connector port8080 ... /这一行在末尾添加URIEncodingUTF-8Connector port8080 protocolHTTP/1.1 connectionTimeout20000 redirectPort8443 URIEncodingUTF-8 /否则当 URL 中含中文参数如/ysxt/recipe/list?category春季养肝后端request.getParameter(category)会返回乱码æ¥å£å »è导致分类查询失败。这是 Tomcat 8.5 的默认缺陷不改必翻车。启动后浏览器访问http://localhost:8080/ysxt/login.jsp看到登录框即成功。3. 核心模块拆解从登录请求到数据返回的完整SSM链路3.1 登录流程LoginController如何串联 SpringMVC 与 MyBatis登录入口是src/main/java/com/controller/LoginController.java核心方法Controller public class LoginController { Autowired private UserService userService; // Service层注入 RequestMapping(value /login, method RequestMethod.POST) public String login(RequestParam String username, RequestParam String password, HttpServletRequest request, Model model) { // 1. 调用Service层验证用户 User user userService.login(username, MD5Util.md5(password)); if (user ! null) { // 2. 登录成功存入Session request.getSession().setAttribute(user, user); // 3. 重定向到首页 return redirect:/index.jsp; } else { model.addAttribute(msg, 用户名或密码错误); return login; // 返回login.jsp视图 } } }关键点解析RequestParam强制从表单取值比ModelAttribute更轻量适合简单登录MD5Util.md5()是项目自定义工具类src/main/java/com/util/MD5Util.java对密码做不可逆加密与数据库存储的密文比对return redirect:/index.jsp是 SpringMVC 的重定向语法避免表单重复提交model.addAttribute(msg, ...)将错误信息传给 JSP前端用${msg}输出。3.2 MyBatis DAO层UserMapper.xml中的动态SQL防SQL注入src/main/resources/mapper/UserMapper.xml定义了登录查询select idlogin parameterTypemap resultTypecom.entity.User SELECT * FROM user WHERE username #{username} AND password #{password} if teststatus ! null AND status #{status} /if /select为什么用#{}而不用${}#{username}会被 MyBatis 解析为预编译参数?彻底杜绝 OR 11这类注入if teststatus ! null是动态SQL当status为空时不拼接该条件避免AND status null导致查询失败parameterTypemap表示接收MapString, Object由 SpringMVC 自动将RequestParam参数封装成 Map 传入。注意UserMapper.java接口方法签名必须与 XML 中id严格一致User login(MapString, Object params);—— 参数名params可任意但Map键必须为username和password。3.3 Spring配置spring-mvc.xml如何接管前端控制器src/main/resources/spring-mvc.xml是 SpringMVC 的核心配置!-- 启用注解驱动 -- mvc:annotation-driven / !-- 静态资源放行CSS/JS/图片 -- mvc:resources mapping/static/** location/static/ / mvc:resources mapping/upload/** location/upload/ / !-- 视图解析器JSP前缀后缀 -- bean classorg.springframework.web.servlet.view.InternalResourceViewResolver property nameprefix value/WEB-INF/jsp/ / property namesuffix value.jsp / /bean !-- 扫描Controller包 -- context:component-scan base-packagecom.controller /避坑点若忘记mvc:annotation-driven /所有RequestMapping注解失效访问/login会 404prefix/WEB-INF/jsp/意味着return login实际跳转到/WEB-INF/jsp/login.jsp—— 这是安全设计WEB-INF 下资源无法被直接URL访问mapping/static/**必须写在mvc:annotation-driven /之后否则静态文件 404。3.4 数据库连接池db.properties与spring-dao.xml的耦合逻辑src/main/resources/db.properties存放数据库凭证jdbc.drivercom.mysql.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/ysxt?useUnicodetruecharacterEncodingutf8 jdbc.usernameroot jdbc.password123456src/main/resources/spring-dao.xml加载它!-- 加载属性文件 -- context:property-placeholder locationclasspath:db.properties / !-- 配置Druid连接池 -- bean iddataSource classcom.alibaba.druid.pool.DruidDataSource init-methodinit destroy-methodclose property namedriverClassName value${jdbc.driver} / property nameurl value${jdbc.url} / property nameusername value${jdbc.username} / property namepassword value${jdbc.password} / /bean血泪经验jdbc.url中?useUnicodetruecharacterEncodingutf8是强制 UTF-8 连接的关键漏掉则中文存库变???Druid 是本项目选用的连接池非 C3P0 或 Hikariinit-methodinit确保启动时初始化destroy-methodclose保证关闭时释放连接若db.properties放错位置如放在src/main/java下context:property-placeholder会加载失败报Could not resolve placeholder jdbc.url。4. 常见问题排查5条真实踩坑记录每条都附定位命令4.1 现象启动Tomcat后控制台无报错但访问http://localhost:8080/ysxt/login.jsp显示 404原因web.xml中welcome-file-list未配置login.jsp且DispatcherServlet未拦截*.jsp请求。解决检查src/main/webapp/WEB-INF/web.xml确保有welcome-file-list welcome-filelogin.jsp/welcome-file /welcome-file-list确认DispatcherServlet的url-pattern是/非*.do否则 JSP 不经 SpringMVC 处理。4.2 现象登录时输入正确账号密码页面提示“用户名或密码错误”但数据库中数据无误原因MD5Util.md5()方法对密码加盐salt了而ysxt.sql中的密码是未加盐的 MD5。解决查看MD5Util.java若存在salt字段如private static final String salt ysxt2023;则需重新生成密码System.out.println(MD5Util.md5(123456 ysxt2023)); // 输出新密文用新密文更新数据库UPDATE user SET password新密文 WHERE usernameadmin;4.3 现象JSP 页面显示中文乱码如“春季养肝”变成“æ¥å£å »è”原因三个地方未统一 UTF-8JSP 文件本身编码Notepad 查看编码是否为 UTF-8 无 BOMweb.xml中jsp-config缺少 page-encodingTomcatserver.xmlConnector 未加URIEncodingUTF-8解决在所有.jsp文件顶部加% page contentTypetext/html;charsetUTF-8 languagejava %web.xml中添加jsp-config jsp-property-group url-pattern*.jsp/url-pattern page-encodingUTF-8/page-encoding /jsp-property-group /jsp-config4.4 现象后台管理页点击“添加养生知识”提交后报org.apache.jasper.JasperException: java.lang.NullPointerException原因KnowledgeController.java中Autowired KnowledgeService knowledgeService;为 nullService 未被 Spring 扫描到。解决检查spring-service.xml中context:component-scan base-packagecom.service /的包路径是否正确确认KnowledgeService实现类上有Service(knowledgeService)注解且类名首字母小写如KnowledgeServiceImpl在 IDEA 中CtrlShiftF全局搜索Service确认无拼写错误。4.5 现象Navicat 执行ysxt.sql时卡住长时间无响应原因ysxt.sql开头有SET FOREIGN_KEY_CHECKS0;但结尾未恢复SET FOREIGN_KEY_CHECKS1;导致后续建表因外键约束失败。解决用文本编辑器打开ysxt.sql在文件末尾手动添加SET FOREIGN_KEY_CHECKS1;或者分段执行先执行建库建表语句再执行INSERT语句ysxt.sql中INSERT都在最后。5. 二次开发实战给食谱模块加“用户评分”功能从数据库到前端一页落5.1 数据库扩展新增recipe_score表并建立外键关联原ysxt.sql中recipe表只有基础字段id, title, content, category。要支持用户评分需新增关联表-- 新增评分表 CREATE TABLE recipe_score ( id bigint(20) NOT NULL AUTO_INCREMENT, recipe_id bigint(20) NOT NULL COMMENT 食谱ID, user_id bigint(20) NOT NULL COMMENT 用户ID, score tinyint(4) NOT NULL COMMENT 评分1-5, create_time datetime DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), KEY idx_recipe_id (recipe_id), KEY idx_user_id (user_id), CONSTRAINT fk_recipe_score_recipe_id FOREIGN KEY (recipe_id) REFERENCES recipe (id) ON DELETE CASCADE, CONSTRAINT fk_recipe_score_user_id FOREIGN KEY (user_id) REFERENCES user (id) ON DELETE CASCADE ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;执行命令mysql -u root -p ysxt recipe_score.sql注意ON DELETE CASCADE确保删除食谱时自动清理评分避免脏数据。5.2 MyBatis映射编写RecipeScoreMapper.xml并注入 Service在src/main/resources/mapper/下新建RecipeScoreMapper.xml?xml version1.0 encodingUTF-8? !DOCTYPE mapper PUBLIC -//mybatis.org//DTD Mapper 3.0//EN http://mybatis.org/dtd/mybatis-3-mapper.dtd mapper namespacecom.mapper.RecipeScoreMapper !-- 插入评分 -- insert idinsertScore parameterTypecom.entity.RecipeScore INSERT INTO recipe_score (recipe_id, user_id, score) VALUES (#{recipeId}, #{userId}, #{score}) /insert !-- 查询某食谱平均分 -- select idgetAvgScore parameterTypelong resultTypedouble SELECT IFNULL(AVG(score), 0) FROM recipe_score WHERE recipe_id #{recipeId} /select !-- 查询某用户对某食谱是否已评过分 -- select idhasScored parameterTypemap resultTypeint SELECT COUNT(*) FROM recipe_score WHERE recipe_id #{recipeId} AND user_id #{userId} /select /mapper对应RecipeScoreMapper.java接口public interface RecipeScoreMapper { void insertScore(RecipeScore score); double getAvgScore(Long recipeId); int hasScored(MapString, Object params); }在RecipeService.java中注入并使用Service public class RecipeService { Autowired private RecipeScoreMapper recipeScoreMapper; public void addScore(Long recipeId, Long userId, Integer score) { // 先检查是否已评分 MapString, Object params new HashMap(); params.put(recipeId, recipeId); params.put(userId, userId); if (recipeScoreMapper.hasScored(params) 0) { RecipeScore scoreObj new RecipeScore(); scoreObj.setRecipeId(recipeId); scoreObj.setUserId(userId); scoreObj.setScore(score); recipeScoreMapper.insertScore(scoreObj); } } public double getRecipeAvgScore(Long recipeId) { return recipeScoreMapper.getAvgScore(recipeId); } }5.3 前端改造在recipe_detail.jsp中嵌入评分组件打开src/main/webapp/WEB-INF/jsp/recipe_detail.jsp在食谱内容下方添加!-- 评分组件 -- div classscore-section h4用户评分/h4 div classavg-score span平均分/span span idavg-score% request.getAttribute(avgScore) ! null ? request.getAttribute(avgScore) : 0.0 %/span span/5/span /div c:if test${not empty sessionScope.user} div classscore-input label请打分/label select idscore-select option value11星/option option value22星/option option value33星/option option value44星/option option value55星/option /select button onclicksubmitScore(${recipe.id})提交评分/button /div /c:if /div script function submitScore(recipeId) { const score document.getElementById(score-select).value; fetch(/ysxt/recipe/addScore, { method: POST, headers: {Content-Type: application/x-www-form-urlencoded}, body: recipeId recipeId score score }) .then(response response.json()) .then(data { if (data.success) { alert(评分成功); // 刷新平均分 document.getElementById(avg-score).innerText data.avgScore; } else { alert(评分失败 data.msg); } }); } /script同时在RecipeController.java中添加处理方法RequestMapping(value /recipe/addScore, method RequestMethod.POST) ResponseBody public MapString, Object addScore(RequestParam Long recipeId, RequestParam Integer score, HttpServletRequest request) { MapString, Object result new HashMap(); User user (User) request.getSession().getAttribute(user); if (user null) { result.put(success, false); result.put(msg, 请先登录); return result; } try { recipeService.addScore(recipeId, user.getId(), score); double avg recipeService.getRecipeAvgScore(recipeId); result.put(success, true); result.put(avgScore, String.format(%.1f, avg)); } catch (Exception e) { result.put(success, false); result.put(msg, 系统错误); } return result; }5.4 验证与调试三步确认功能闭环数据库验证登录 Navicat执行SELECT * FROM recipe_score WHERE recipe_id 1;确认有新记录插入user_id与当前登录用户一致。接口验证用浏览器访问http://localhost:8080/ysxt/recipe/addScore?recipeId1score4返回 JSON{success:true,avgScore:4.0}即通。前端验证清除浏览器缓存登录后打开任意食谱详情页选择“5星”并点击“提交评分”弹出“评分成功”页面平均分实时变为5.0/5刷新页面分数仍保持证明持久化成功。从数据库建表、MyBatis映射、Service逻辑、Controller接口到JSP渲染整个链路完全复刻了SSM标准开发范式。没有用任何新框架却把“用户行为数据采集”这个毕业设计高频需求扎实地落在了每一行代码上。6. 从“能跑”到“能改”的思维切换我的三个强制习惯刚拿到这份java-ssm871时我也犯过低级错误改完pom.xml依赖没点 Maven Reload就急着写代码结果Autowired死活不生效又或者看到web.xml里contextConfigLocation指向classpath:spring-*.xml就以为所有 Spring 配置都在resources/下结果发现spring-mvc.xml里mvc:resources的location/static/对应的是webapp/static/目录而我把 CSS 放错了位置折腾半小时才定位到。从那以后我每次接手一个老 SSM 项目都强制走一遍这三步第一步反向追踪web.xml的生命周期。打开web.xml从listenerContextLoaderListener开始看它加载哪个contextConfigLocation再找servletDispatcherServlet看它加载哪个contextConfigLocation最后看filter如CharacterEncodingFilter的init-param。这三处配置决定了整个项目的容器启动顺序和 Bean 扫描范围。我习惯用纸笔画一张简图左边写web.xml配置项右边写对应 XML 文件路径中间画箭头。这张图就是项目的“启动地图”。第二步用System.out.println()替代所有日志框架。别一上来就配 Log4j。在LoginController.login()开头加System.out.println(LoginController.login called, username username);在UserService.login()开头加System.out.println(UserService.login called, md5 password);。当控制台出现这些打印说明 SpringMVC 和 Service 层已打通如果只看到 Controller 打印Service 没打印那一定是Service扫描路径错了。这种原始方法比看日志配置快十倍。第三步把pom.xml当字典查。遇到ClassNotFoundException第一反应不是百度而是打开pom.xml用CtrlF搜报错的类名如HttpServletRequest。如果搜不到说明缺依赖如果搜到了再看它的groupId如javax.servlet-api去 Maven Repository 网站查这个 artifact 的scope是provided还是compile。provided意味着它由 Tomcat 提供不该打包进 WAR否则会冲突——这就是为什么有时删掉pom.xml里的servlet-api依赖反而好了。这三个习惯让我在两周内帮 7 个同学跑通了他们的 SSM 毕设项目。它们不炫技但像手术刀一样精准。希望帮到你。本文还有配套的精品资源点击获取 
长河君 · 2026/10/18 9:50:08 · 阅读 1.2k SSM中医养生系统实战：从环境搭建到二次开发全链路
简介本资源是一套完整的基于SSM框架的中医养生系统毕业设计项目面向计算机专业本科生及Java初学者聚焦B/S架构Web应用开发实践助力掌握企业级Java Web开发全流程。压缩包共1509个文件涵盖147个Java后端逻辑类、144个JSP页面、390个JS交互脚本、178个PNG与119个JPG等静态资源以及160个CSS样式文件和127个数据库相关SQL/配置文件完整支撑系统前后端分离式开发与部署整体大小为41.98MB。已有143人学习下载说明其在课程设计与毕设选题中具备较强参考价值。读者可直接导入IDEA或Eclipse运行包含用户登录管理、数据库设计文档、MySQL建库脚本、Maven依赖配置及全部前端UI资源含Bootstrap、Layui、Element UI等主流CSS/JS库并附有配套论文是少有的集源码、数据库、界面、文档于一体的全栈式教学级项目。1. 一个毕业设计级中医养生系统不是PPT演示是能真跑起来的SSM全栈闭环去年帮某高校实验室带毕设时有位A同学交来一份“中医养生系统”答辩PPT讲得头头是道——阴阳五行、四季调养、药膳食谱分类……结果老师当场点开演示链接404。后来他翻出这份java-ssm871基于SSM框架的中医养生系统设计与实现jsp程序源码数据库含论文.rar压缩包里连SQL脚本、IDEA工程结构、JSP页面树、甚至Word版论文都齐了。我当天下午就在本地搭起环境启动Tomcat输入http://localhost:8080/ysxt/login.jsp账号admin/ 密码123456登录成功首页弹出“春季养肝食谱推荐”点击“查看详细”跳转到带图文的JSP详情页底部还挂着“今日节气惊蛰”。这不是Demo是完整可交互的B/S系统——用户注册、登录、浏览养生知识、收藏食谱、后台管理内容、审核用户反馈全链路走通。它不追求高并发或微服务架构但把SSM三层分层、MyBatis动态SQL、JSPJSTL模板渲染、MySQL事务控制这些毕业设计最常考的硬核点全塞进一个真实可运行的上下文里。如果你正卡在“SSM只会写HelloWorld”“JSP页面总报空指针”“MyBatis查不出数据但日志没报错”的阶段这份资源就是你缺的那块拼图它不教理论只给你一个已焊死的、能拧螺丝也能换零件的底盘。2. 环境搭建与项目导入从解压到首页显示一步一坑的实操路径2.1 JDK与Tomcat版本对齐为什么必须用JDK 1.8 Tomcat 8.5项目摘要明确要求jdk版本:jdk1.8但实际运行中JDK 1.8 Tomcat 9/10 会直接启动失败。原因在于本项目web.xml使用的是 Servlet 3.0 规范web-app xmlnshttp://java.sun.com/xml/ns/javaee xmlns:xsihttp://www.w3.org/2001/XMLSchema-instance version3.0而 Tomcat 9 默认启用 Servlet 4.0部分老式JSP标签库如c:forEach在EL表达式解析上存在兼容性差异。更关键的是项目中pom.xml依赖的spring-webmvc 4.3.29.RELEASE与 JDK 11 的模块化系统存在反射冲突会导致DispatcherServlet初始化时报java.lang.NoClassDefFoundError: javax/servlet/http/HttpServletRequest。提示不要贪新。我实测过 JDK 17 Tomcat 10.1启动时抛出 17 个ClassNotFoundException全指向javax.*包——这是 Java EE API 被移出 JDK 的典型症状。坚持用 JDK 1.8u202 Tomcat 8.5.90 组合这是本项目唯一被验证稳定的黄金搭档。安装后在 IDEA 中配置File → Project Structure → ProjectProject SDK 选 JDK 1.8Project language level 选 8File → Settings → Build → Build Tools → MavenMaven home path 指向你本地 Maven 3.6.3项目pom.xml中maven.compiler.source和maven.compiler.target均为 1.82.2 IDEA导入Maven工程别点“Auto-import”手动清三处缓存解压java-ssm871...rar后得到根目录ysxt/其下结构为ysxt/ ├── src/ │ ├── main/ │ │ ├── java/ # SpringSpringMVCMyBatis代码 │ │ ├── resources/ # db.properties, spring-dao.xml等配置 │ │ └── webapp/ # JSP、CSS、JS、WEB-INF/web.xml │ └── test/ ├── target/ # 编译输出导入前可删 ├── pom.xml # 核心依赖spring 4.3.29, mybatis 3.4.6, mysql-connector-java 5.1.47 └── ysxt.sql # 数据库初始化脚本导入步骤关键IDEA 启动页 →Open→ 选择ysxt/文件夹弹窗提示 “Import project from external model?” →勾选 Maven但取消勾选 “Auto-import”点击 OK 后等待 Maven 加载依赖约2分钟。此时若看到spring-context,mybatis-spring等依赖标红说明 Maven 配置未生效手动清理三处缓存File → Invalidate Caches and Restart → Invalidate and Restart重启后View → Tool Windows → Maven→ 点击左上角刷新按钮蓝色循环箭头右键项目根目录 →Maven → Reload project注意如果跳过第4步常见现象是Controller注解类不被识别web.xml中contextConfigLocation路径报红导致DispatcherServlet找不到 Spring 配置文件。这是 IDEA 对老式 SSM 项目索引失效的典型表现重启重载是后悔药。2.3 数据库初始化Navicat执行SQL时必须关掉“安全更新模式”ysxt.sql文件大小约 1.2MB包含建库、建表、插入初始数据管理员账号、12类养生知识、87条食谱。在 Navicat 中操作新建连接 → 连接 MySQL建议用 5.7 版本8.0 需额外配置useSSLfalse右键连接 →新建数据库→ 名称填ysxt字符集选utf8mb4非utf8否则中药名“䗪虫”会乱码右键ysxt数据库 →运行SQL文件→ 选择ysxt.sql但这里有个致命陷阱若 Navicat 默认开启“安全更新模式”Safe Updates执行UPDATE user SET passworde10adc3949ba59abbe56e057f20f883e WHERE id1;这类无WHERE主键条件的语句时会报错You are using safe update mode and you tried to update a table without a WHERE that uses a KEY column。解决方法Edit → Preferences → SQL Editor→ 取消勾选Safe Updates→ 点击OK重新运行 SQL 文件提示ysxt.sql中密码是 MD5(123456) e10adc3949ba59abbe56e057f20f883e明文存储。这在生产环境是严重漏洞但毕业设计允许——你只需知道后续改密码要同步更新user表和db.properties中的jdbc.password。2.4 Tomcat部署与启动修改server.xml解决中文路径乱码在 IDEA 中配置 TomcatRun → Edit Configurations → → Tomcat Server → LocalDeployment → → Artifact → ysxt:war exploded注意选 exploded不是 warApplication context填/ysxt与web.xml中display-name一致启动前必须修改 Tomcat 的conf/server.xml找到Connector port8080 ... /这一行在末尾添加URIEncodingUTF-8Connector port8080 protocolHTTP/1.1 connectionTimeout20000 redirectPort8443 URIEncodingUTF-8 /否则当 URL 中含中文参数如/ysxt/recipe/list?category春季养肝后端request.getParameter(category)会返回乱码æ¥å£å »è导致分类查询失败。这是 Tomcat 8.5 的默认缺陷不改必翻车。启动后浏览器访问http://localhost:8080/ysxt/login.jsp看到登录框即成功。3. 核心模块拆解从登录请求到数据返回的完整SSM链路3.1 登录流程LoginController如何串联 SpringMVC 与 MyBatis登录入口是src/main/java/com/controller/LoginController.java核心方法Controller public class LoginController { Autowired private UserService userService; // Service层注入 RequestMapping(value /login, method RequestMethod.POST) public String login(RequestParam String username, RequestParam String password, HttpServletRequest request, Model model) { // 1. 调用Service层验证用户 User user userService.login(username, MD5Util.md5(password)); if (user ! null) { // 2. 登录成功存入Session request.getSession().setAttribute(user, user); // 3. 重定向到首页 return redirect:/index.jsp; } else { model.addAttribute(msg, 用户名或密码错误); return login; // 返回login.jsp视图 } } }关键点解析RequestParam强制从表单取值比ModelAttribute更轻量适合简单登录MD5Util.md5()是项目自定义工具类src/main/java/com/util/MD5Util.java对密码做不可逆加密与数据库存储的密文比对return redirect:/index.jsp是 SpringMVC 的重定向语法避免表单重复提交model.addAttribute(msg, ...)将错误信息传给 JSP前端用${msg}输出。3.2 MyBatis DAO层UserMapper.xml中的动态SQL防SQL注入src/main/resources/mapper/UserMapper.xml定义了登录查询select idlogin parameterTypemap resultTypecom.entity.User SELECT * FROM user WHERE username #{username} AND password #{password} if teststatus ! null AND status #{status} /if /select为什么用#{}而不用${}#{username}会被 MyBatis 解析为预编译参数?彻底杜绝 OR 11这类注入if teststatus ! null是动态SQL当status为空时不拼接该条件避免AND status null导致查询失败parameterTypemap表示接收MapString, Object由 SpringMVC 自动将RequestParam参数封装成 Map 传入。注意UserMapper.java接口方法签名必须与 XML 中id严格一致User login(MapString, Object params);—— 参数名params可任意但Map键必须为username和password。3.3 Spring配置spring-mvc.xml如何接管前端控制器src/main/resources/spring-mvc.xml是 SpringMVC 的核心配置!-- 启用注解驱动 -- mvc:annotation-driven / !-- 静态资源放行CSS/JS/图片 -- mvc:resources mapping/static/** location/static/ / mvc:resources mapping/upload/** location/upload/ / !-- 视图解析器JSP前缀后缀 -- bean classorg.springframework.web.servlet.view.InternalResourceViewResolver property nameprefix value/WEB-INF/jsp/ / property namesuffix value.jsp / /bean !-- 扫描Controller包 -- context:component-scan base-packagecom.controller /避坑点若忘记mvc:annotation-driven /所有RequestMapping注解失效访问/login会 404prefix/WEB-INF/jsp/意味着return login实际跳转到/WEB-INF/jsp/login.jsp—— 这是安全设计WEB-INF 下资源无法被直接URL访问mapping/static/**必须写在mvc:annotation-driven /之后否则静态文件 404。3.4 数据库连接池db.properties与spring-dao.xml的耦合逻辑src/main/resources/db.properties存放数据库凭证jdbc.drivercom.mysql.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/ysxt?useUnicodetruecharacterEncodingutf8 jdbc.usernameroot jdbc.password123456src/main/resources/spring-dao.xml加载它!-- 加载属性文件 -- context:property-placeholder locationclasspath:db.properties / !-- 配置Druid连接池 -- bean iddataSource classcom.alibaba.druid.pool.DruidDataSource init-methodinit destroy-methodclose property namedriverClassName value${jdbc.driver} / property nameurl value${jdbc.url} / property nameusername value${jdbc.username} / property namepassword value${jdbc.password} / /bean血泪经验jdbc.url中?useUnicodetruecharacterEncodingutf8是强制 UTF-8 连接的关键漏掉则中文存库变???Druid 是本项目选用的连接池非 C3P0 或 Hikariinit-methodinit确保启动时初始化destroy-methodclose保证关闭时释放连接若db.properties放错位置如放在src/main/java下context:property-placeholder会加载失败报Could not resolve placeholder jdbc.url。4. 常见问题排查5条真实踩坑记录每条都附定位命令4.1 现象启动Tomcat后控制台无报错但访问http://localhost:8080/ysxt/login.jsp显示 404原因web.xml中welcome-file-list未配置login.jsp且DispatcherServlet未拦截*.jsp请求。解决检查src/main/webapp/WEB-INF/web.xml确保有welcome-file-list welcome-filelogin.jsp/welcome-file /welcome-file-list确认DispatcherServlet的url-pattern是/非*.do否则 JSP 不经 SpringMVC 处理。4.2 现象登录时输入正确账号密码页面提示“用户名或密码错误”但数据库中数据无误原因MD5Util.md5()方法对密码加盐salt了而ysxt.sql中的密码是未加盐的 MD5。解决查看MD5Util.java若存在salt字段如private static final String salt ysxt2023;则需重新生成密码System.out.println(MD5Util.md5(123456 ysxt2023)); // 输出新密文用新密文更新数据库UPDATE user SET password新密文 WHERE usernameadmin;4.3 现象JSP 页面显示中文乱码如“春季养肝”变成“æ¥å£å »è”原因三个地方未统一 UTF-8JSP 文件本身编码Notepad 查看编码是否为 UTF-8 无 BOMweb.xml中jsp-config缺少 page-encodingTomcatserver.xmlConnector 未加URIEncodingUTF-8解决在所有.jsp文件顶部加% page contentTypetext/html;charsetUTF-8 languagejava %web.xml中添加jsp-config jsp-property-group url-pattern*.jsp/url-pattern page-encodingUTF-8/page-encoding /jsp-property-group /jsp-config4.4 现象后台管理页点击“添加养生知识”提交后报org.apache.jasper.JasperException: java.lang.NullPointerException原因KnowledgeController.java中Autowired KnowledgeService knowledgeService;为 nullService 未被 Spring 扫描到。解决检查spring-service.xml中context:component-scan base-packagecom.service /的包路径是否正确确认KnowledgeService实现类上有Service(knowledgeService)注解且类名首字母小写如KnowledgeServiceImpl在 IDEA 中CtrlShiftF全局搜索Service确认无拼写错误。4.5 现象Navicat 执行ysxt.sql时卡住长时间无响应原因ysxt.sql开头有SET FOREIGN_KEY_CHECKS0;但结尾未恢复SET FOREIGN_KEY_CHECKS1;导致后续建表因外键约束失败。解决用文本编辑器打开ysxt.sql在文件末尾手动添加SET FOREIGN_KEY_CHECKS1;或者分段执行先执行建库建表语句再执行INSERT语句ysxt.sql中INSERT都在最后。5. 二次开发实战给食谱模块加“用户评分”功能从数据库到前端一页落5.1 数据库扩展新增recipe_score表并建立外键关联原ysxt.sql中recipe表只有基础字段id, title, content, category。要支持用户评分需新增关联表-- 新增评分表 CREATE TABLE recipe_score ( id bigint(20) NOT NULL AUTO_INCREMENT, recipe_id bigint(20) NOT NULL COMMENT 食谱ID, user_id bigint(20) NOT NULL COMMENT 用户ID, score tinyint(4) NOT NULL COMMENT 评分1-5, create_time datetime DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), KEY idx_recipe_id (recipe_id), KEY idx_user_id (user_id), CONSTRAINT fk_recipe_score_recipe_id FOREIGN KEY (recipe_id) REFERENCES recipe (id) ON DELETE CASCADE, CONSTRAINT fk_recipe_score_user_id FOREIGN KEY (user_id) REFERENCES user (id) ON DELETE CASCADE ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;执行命令mysql -u root -p ysxt recipe_score.sql注意ON DELETE CASCADE确保删除食谱时自动清理评分避免脏数据。5.2 MyBatis映射编写RecipeScoreMapper.xml并注入 Service在src/main/resources/mapper/下新建RecipeScoreMapper.xml?xml version1.0 encodingUTF-8? !DOCTYPE mapper PUBLIC -//mybatis.org//DTD Mapper 3.0//EN http://mybatis.org/dtd/mybatis-3-mapper.dtd mapper namespacecom.mapper.RecipeScoreMapper !-- 插入评分 -- insert idinsertScore parameterTypecom.entity.RecipeScore INSERT INTO recipe_score (recipe_id, user_id, score) VALUES (#{recipeId}, #{userId}, #{score}) /insert !-- 查询某食谱平均分 -- select idgetAvgScore parameterTypelong resultTypedouble SELECT IFNULL(AVG(score), 0) FROM recipe_score WHERE recipe_id #{recipeId} /select !-- 查询某用户对某食谱是否已评过分 -- select idhasScored parameterTypemap resultTypeint SELECT COUNT(*) FROM recipe_score WHERE recipe_id #{recipeId} AND user_id #{userId} /select /mapper对应RecipeScoreMapper.java接口public interface RecipeScoreMapper { void insertScore(RecipeScore score); double getAvgScore(Long recipeId); int hasScored(MapString, Object params); }在RecipeService.java中注入并使用Service public class RecipeService { Autowired private RecipeScoreMapper recipeScoreMapper; public void addScore(Long recipeId, Long userId, Integer score) { // 先检查是否已评分 MapString, Object params new HashMap(); params.put(recipeId, recipeId); params.put(userId, userId); if (recipeScoreMapper.hasScored(params) 0) { RecipeScore scoreObj new RecipeScore(); scoreObj.setRecipeId(recipeId); scoreObj.setUserId(userId); scoreObj.setScore(score); recipeScoreMapper.insertScore(scoreObj); } } public double getRecipeAvgScore(Long recipeId) { return recipeScoreMapper.getAvgScore(recipeId); } }5.3 前端改造在recipe_detail.jsp中嵌入评分组件打开src/main/webapp/WEB-INF/jsp/recipe_detail.jsp在食谱内容下方添加!-- 评分组件 -- div classscore-section h4用户评分/h4 div classavg-score span平均分/span span idavg-score% request.getAttribute(avgScore) ! null ? request.getAttribute(avgScore) : 0.0 %/span span/5/span /div c:if test${not empty sessionScope.user} div classscore-input label请打分/label select idscore-select option value11星/option option value22星/option option value33星/option option value44星/option option value55星/option /select button onclicksubmitScore(${recipe.id})提交评分/button /div /c:if /div script function submitScore(recipeId) { const score document.getElementById(score-select).value; fetch(/ysxt/recipe/addScore, { method: POST, headers: {Content-Type: application/x-www-form-urlencoded}, body: recipeId recipeId score score }) .then(response response.json()) .then(data { if (data.success) { alert(评分成功); // 刷新平均分 document.getElementById(avg-score).innerText data.avgScore; } else { alert(评分失败 data.msg); } }); } /script同时在RecipeController.java中添加处理方法RequestMapping(value /recipe/addScore, method RequestMethod.POST) ResponseBody public MapString, Object addScore(RequestParam Long recipeId, RequestParam Integer score, HttpServletRequest request) { MapString, Object result new HashMap(); User user (User) request.getSession().getAttribute(user); if (user null) { result.put(success, false); result.put(msg, 请先登录); return result; } try { recipeService.addScore(recipeId, user.getId(), score); double avg recipeService.getRecipeAvgScore(recipeId); result.put(success, true); result.put(avgScore, String.format(%.1f, avg)); } catch (Exception e) { result.put(success, false); result.put(msg, 系统错误); } return result; }5.4 验证与调试三步确认功能闭环数据库验证登录 Navicat执行SELECT * FROM recipe_score WHERE recipe_id 1;确认有新记录插入user_id与当前登录用户一致。接口验证用浏览器访问http://localhost:8080/ysxt/recipe/addScore?recipeId1score4返回 JSON{success:true,avgScore:4.0}即通。前端验证清除浏览器缓存登录后打开任意食谱详情页选择“5星”并点击“提交评分”弹出“评分成功”页面平均分实时变为5.0/5刷新页面分数仍保持证明持久化成功。从数据库建表、MyBatis映射、Service逻辑、Controller接口到JSP渲染整个链路完全复刻了SSM标准开发范式。没有用任何新框架却把“用户行为数据采集”这个毕业设计高频需求扎实地落在了每一行代码上。6. 从“能跑”到“能改”的思维切换我的三个强制习惯刚拿到这份java-ssm871时我也犯过低级错误改完pom.xml依赖没点 Maven Reload就急着写代码结果Autowired死活不生效又或者看到web.xml里contextConfigLocation指向classpath:spring-*.xml就以为所有 Spring 配置都在resources/下结果发现spring-mvc.xml里mvc:resources的location/static/对应的是webapp/static/目录而我把 CSS 放错了位置折腾半小时才定位到。从那以后我每次接手一个老 SSM 项目都强制走一遍这三步第一步反向追踪web.xml的生命周期。打开web.xml从listenerContextLoaderListener开始看它加载哪个contextConfigLocation再找servletDispatcherServlet看它加载哪个contextConfigLocation最后看filter如CharacterEncodingFilter的init-param。这三处配置决定了整个项目的容器启动顺序和 Bean 扫描范围。我习惯用纸笔画一张简图左边写web.xml配置项右边写对应 XML 文件路径中间画箭头。这张图就是项目的“启动地图”。第二步用System.out.println()替代所有日志框架。别一上来就配 Log4j。在LoginController.login()开头加System.out.println(LoginController.login called, username username);在UserService.login()开头加System.out.println(UserService.login called, md5 password);。当控制台出现这些打印说明 SpringMVC 和 Service 层已打通如果只看到 Controller 打印Service 没打印那一定是Service扫描路径错了。这种原始方法比看日志配置快十倍。第三步把pom.xml当字典查。遇到ClassNotFoundException第一反应不是百度而是打开pom.xml用CtrlF搜报错的类名如HttpServletRequest。如果搜不到说明缺依赖如果搜到了再看它的groupId如javax.servlet-api去 Maven Repository 网站查这个 artifact 的scope是provided还是compile。provided意味着它由 Tomcat 提供不该打包进 WAR否则会冲突——这就是为什么有时删掉pom.xml里的servlet-api依赖反而好了。这三个习惯让我在两周内帮 7 个同学跑通了他们的 SSM 毕设项目。它们不炫技但像手术刀一样精准。希望帮到你。本文还有配套的精品资源点击获取