简介一套基于JavaWeb与MySQL实现的学生成绩管理系统源码包面向需要课程设计、毕业设计或Web开发练手的学习者帮助教育场景中快速落地成绩录入、查询与统计功能。项目已实现管理员、教师、学生三类角色的登录与权限控制覆盖学生信息维护、课程管理、成绩批量录入与单个修改、按科目和学期筛选查询、及格率与平均分统计、成绩排名等完整业务链代码采用MVC分层与Servlet/JSP技术交互中体现Controller、Service、DAO的协作及数据库安全处理。资源共244个文件以JSP页面、Java源码、class编译文件、jar依赖库、XML配置为主并附带SQL数据库脚本及CSS/JS前端资源压缩包整体约17.15MB解压后目录结构清晰便于导入集成开发环境直接运行与二次学习。当前已有1438人学习下载适合作为快速掌握JavaWeb开发全流程的参考项目也是学习MySQL表设计、JDBC/连接池使用和基础权限管理的良好素材。 每年到课程设计季“javaweb学生成绩管理系统”这个选题都会被大量学生翻出来。选题确实经典但我也见过太多人卡在同一个地方代码跟着教程敲完了启动Tomcat却一堆报错数据库连接写对了页面一刷新就500明明在IDEA里跑得好好的打包部署到服务器就404。这篇文章就把我从需求分析到Tomcat部署的全过程拆开讲清楚包括那些教程里不会明说的坑。这个项目适合谁刚学完Servlet、JSP和MySQL基础语法想做一个完整案例串一遍知识点的同学或者学期末面临课程设计需要一个能跑、能讲、能答辩的项目的人。我会按自己实际动手的顺序来写从建表到发布每一步都解释为什么这么做而不是只给你一串能复制的代码。1. 业务边界与功能规划动手写代码前先想清楚做什么很多新手拿到“学生成绩管理系统”这个题目第一反应是打开IDEA新建项目开写这是最容易翻车的操作。我见过太多半途而废的项目问题几乎都出在前期没想清楚“系统到底管理什么、谁在用、有哪些操作”。先花半小时把需求和表结构理清楚后面能省出两三天折腾的时间。1.1 角色与功能模块的划分学生成绩管理系统最常见的角色有三种管理员、教师、学生。没必要一开始就把权限做得过于复杂但至少要区分出“谁能录入成绩”和“谁能看成绩”否则系统就没有管理可言。管理员维护学生信息和课程信息比如新生入学、转班、毕业这些操作都归他管。教师录入成绩、修改成绩、查看自己所授课程的成绩统计。学生只查自己各科成绩最多再看个排名和学分绩点。对应到功能模块核心就是三大块登录认证模块、学生/课程信息管理模块、成绩管理模块。统计报表可以放到后面的迭代里做第一版先把CRUD跑通比什么都重要。我见过一些同学一上来就想做饼状图、柱状图结果连成绩表都没建出来最后答辩时项目还跑不起来这就是典型的本末倒置。1.2 数据库表结构设计三张表的关联关系成绩管理系统的数据库设计非常经典通常是四张表用户表、学生表、课程表、成绩表。用户表负责登录学生表存学生基本信息课程表存开课信息成绩表则通过外键关联学生和课程。这个设计的核心思想是避免数据冗余——如果每门课的成绩后面都跟着一长串学生姓名和课程名称后续改个名字就要改几十条记录这是新手最容易犯的错误。具体表结构我按实际用到的字段列个清单表名字段说明t_userid, username, password, rolerole区分admin/teacher/studentt_studentid, stu_no, name, gender, class_name学号建议加唯一索引t_courseid, course_no, course_name, teacher_name每门课程对应一位任课教师t_scoreid, student_id, course_id, score, exam_datestudent_id和course_id做联合唯一索引这里有个细节值得注意成绩表的联合唯一索引是必须的。如果不加同样的学生和同样的课程可以录进去两条成绩成绩单一拉出来就有重复行数据就乱了。另外学生表和用户表之间其实可以把账号密码直接放在学生表里但考虑到教师也需要登录单独拆一张用户表逻辑上更清晰扩展性也好。第一个版本哪怕只是用半张表也别省这个设计余量。2. 2023版IDEA创建JavaWeb项目这一步劝退了很多人打开IDEA新建项目很多人习惯性地选择Java Enterprise结果发现新版IDEA的模板和网上老教程完全对不上。2023版IDEA里直接新建一个普通的Java项目再手动添加Web支持反而比用模板省心。下面是我验证过的可行路径每一步都标注了关键注意点。2.1 从普通Java项目手动转成Web项目在2023.2版本中操作流程是这样的新建一个空的Java项目选择JDK版本JDK 8还是17取决于你后面用的Tomcat版本Tomcat 9配JDK 8最稳Tomcat 10以上建议JDK 11然后右键项目名选择“Add Framework Support”在弹出的窗口里勾选Web Application。这一步会自动生成web目录里面包含WEB-INF文件夹和一个空的web.xml。很多教程会建议你勾选“Create web.xml”但如果你用的是Servlet注解方式WebServletweb.xml可以留空甚至不要。不过为了兼容性我还是建议保留一个最基本的框架文件后面配置欢迎页和过滤器都要用到它。2.2 配置Tomcat的两种方式和常见失败原因IDEA里配置Tomcat的方式有两种一种是使用Smart Tomcat插件另一种是IDEA自带的Tomcat Server配置。我推荐Smart Tomcat插件主要原因是它不需要额外的部署步骤对新手友好得多。安装方式是在Settings - Plugins里搜索Smart Tomcat安装后重启IDEA。配置时注意几个地方Tomcat Server路径要选到Tomcat的根目录不是bin目录Deployment目录选择你项目的web目录Context Path建议设置为项目名比如/grade这样访问地址就是http://localhost:8080/grade/index.jsp。新手最常见的报错是端口号冲突启动日志显示Port 8080 was already in use。处理方法很简单把占用进程关掉——先netstat -ano查端口占用PID再任务管理器结束进程或者直接改Tomcat的端口号。我个人习惯直接把端口改为8081一劳永逸省得每次启动都排查。3. 数据库连接中的编码与版本匹配JDBC踩坑实录表结构建好了项目也能启动了接下来就要面对整个系统里最容易出问题的一环Java和MySQL之间的连接。很多人的代码逻辑完全正确但启动时就是报错多半是驱动版本不匹配、连接串参数不对、或者编码混乱导致的中文乱码。这三类问题我挨个说。3.1 驱动jar版本与MySQL版本的匹配这是最多人踩的坑。你在网上下载一段JDBC连接代码用的是mysql-connector-java 5.1.x的驱动但本地装的是MySQL 8.0那么一运行就会报Communications link failure或者Client does not support authentication protocol requested by server。MySQL 8.0以上版本默认使用caching_sha2_password认证插件老驱动不认识这个协议直接拒绝连接。解决方法是使用mysql-connector-j 8.0.x版本的驱动同时连接串里的Driver类要改为com.mysql.cj.jdbc.Driver。如果你用的是Maven项目在pom.xml里加依赖时也要注意版本号8.0.33是我验证过的稳定版本。需要提醒的是如果驱动jar包是手动拷贝到WEB-INF/lib目录的一定要确认IDEA的Artifacts里把这个目录包含进去了否则运行时类找不到驱动会报ClassNotFoundException这一点在切换Tomcat部署方式后特别容易忽略。3.2 连接串参数为什么一定要带serverTimezone和useSSL连接串的正确写法如下String url jdbc:mysql://localhost:3306/grade_db?useSSLfalseserverTimezoneAsia/ShanghaicharacterEncodingutf8;useSSLfalse的意思是关闭SSL加密连接本地开发环境没必要做加密而且不关会报一堆证书警告看着心烦。serverTimezoneAsia/Shanghai是MySQL 8.0以后必须加的参数不加会报The server time zone value Öйú±ê׼ʱ¼ä is unrecognized这个乱码会让你误以为是系统编码问题其实是时区问题。characterEncodingutf8解决的是中文乱码问题。这里有个细节MySQL的utf8字符集实际是utf8mb3不支持emoji等四字节字符如果连数据库的字符集都设置成utf8mb4连接串里就写characterEncodingutf8JDBC会自动协商为utf8mb4。数据表创建时统一使用utf8mb4能省掉后续一大堆显示问题。3.3 PreparedStatement防SQL注入的底线很多新手学JDBC时用的是Statement然后通过字符串拼接SQL比如SELECT * FROM t_user WHERE username name AND password pwd 。这种写法最大的隐患是SQL注入——如果用户在用户名框里输入 or 11拼接出来的SQL就变成了WHERE username or 11条件恒真等于绕过了密码校验。就算你的程序不涉及支付交易课程设计答辩时老师也极大概率会问这个问题答不上来印象分会大打折扣。正确做法是用PreparedStatement预编译参数用占位符?传递String sql SELECT * FROM t_user WHERE username ? AND password ?; PreparedStatement ps conn.prepareStatement(sql); ps.setString(1, username); ps.setString(2, password); ResultSet rs ps.executeQuery();两种写法效果完全不同Statement每次执行都要编译SQL而PreparedStatement在执行前就完成了语法解析和编译参数部分用占位符即使传入的内容包含SQL关键字也不会被当作SQL执行。4. 登录会话与成绩CRUD核心功能的完整实现链路数据库连接层稳定之后系统的业务代码就有底气了。这一节我按数据流动的顺序来讲登录请求进来后怎么校验登录成功后如何保持状态受限页面如何拦截最后是成绩数据增删改查的完整链路。4.1 登录逻辑Session会话保持与密码安全登录请求的结构一般是这样前端表单把username和password提交到LoginServletServlet调用DAO层查询用户表查询结果存在说明账号密码正确就把用户信息放入session然后重定向到index.jsp查询结果为空就返回登录页并提示错误。这里有两个容易被忽视的细节。第一个是密码安全。课程设计项目一般不要求做加密但直接在数据库里存明文密码确实很难看。最低成本的优化是用MD5加盐处理盐值取用户名这样即使数据库泄露明文密码也不会直接暴露。实现很简单不引第三方库也能写public static String md5(String input) { try { MessageDigest md MessageDigest.getInstance(MD5); byte[] digest md.digest(input.getBytes()); StringBuilder sb new StringBuilder(); for (byte b : digest) { sb.append(String.format(%02x, b)); } return sb.toString(); } catch (NoSuchAlgorithmException e) { throw new RuntimeException(e); } }存密码时写入md5(明文密码 用户名)校验时用同样的规则算一次再比对即可。这个方案的定位是“防君子不防小人”但答辩时能说明白原理就已经比大部分同学强了。第二个是Session的作用域问题。一个常见的错误是在登录成功后使用session.setAttribute但在JSP页面里用${sessionScope.user}取值时发现是null检查半天发现是跳转方式不对。记住一个原则不在Session里塞请求级别的东西登录用户信息属于会话级别放Session没错但表单提交的查询参数属于请求级别应该用request传递。很多页面数据“丢了”根源就是不该放在Session里的数据占用了内存该放request的数据被塞进了session逻辑一复杂就分不清状态来源了。4.2 用Filter统一拦截未登录访问系统里有些页面比如成绩管理后台不应该被未登录用户直接访问。最原始的写法是在每个Servlet里都判断session里有没有用户代码重复不说漏一个页面就是安全漏洞。更规范的做法是写一个全局的过滤器继承javax.servlet.Filter接口在doFilter方法里统一做拦截判断。完整实现大概是这样WebFilter(/*) public class LoginFilter implements Filter { public void doFilter(ServletRequest req, ServletResponse resp, FilterChain chain) throws IOException, ServletException { HttpServletRequest request (HttpServletRequest) req; HttpServletResponse response (HttpServletResponse) resp; HttpSession session request.getSession(false); String uri request.getRequestURI(); // 放行登录接口和静态资源 if (uri.endsWith(login.jsp) || uri.endsWith(LoginServlet) || uri.contains(/css/) || uri.contains(/js/)) { chain.doFilter(req, resp); return; } if (session null || session.getAttribute(user) null) { response.sendRedirect(request.getContextPath() /login.jsp); return; } chain.doFilter(req, resp); } }这里有个排错的关键细节request.getSession(false)和getSession()是有区别的。getSession()会强制创建一个新的Session对象即使用户没登录过也会自动建一个getSession(false)只在已有Session时返回没有就返回null。如果在这里误用了getSession()会导致每来一个请求就创建一个Session过滤器判断永远不为null登录拦截形同虚设。4.3 成绩增删改查的流程设计与重定向陷阱成绩管理页面的CRUD操作核心逻辑都不复杂就是把SQL换成对应的INSERT、UPDATE、DELETE、SELECT。真正容易出问题的是表单提交之后的跳转方式。比如添加成绩成功后很多新手直接request.getRequestDispatcher(scoreList.jsp).forward(request, response)做转发结果用户按F5刷新页面时表单被重复提交数据库里出现两条一模一样的记录。正确的做法是Redirect After Post模式Servlet执行完插入操作后用response.sendRedirect(score?actionlist)重定向到查询页面。这样浏览器地址栏会变成查询列表的URL刷新操作执行的是查询而不是重复提交表单。这个模式在课程设计答辩中是加分项因为很多同学做了几年校园项目都没关注过重复提交问题。至于成绩列表的分页建议用最简单的LIMIT分页实现不要引入PageHelper或者MyBatisPlus这种框架毕竟整个项目是Servlet技术栈用原生SQL反而更直观int pageSize 10; int currentPage request.getParameter(page) null ? 1 : Integer.parseInt(request.getParameter(page)); int offset (currentPage - 1) * pageSize; String sql SELECT s.stu_no, s.name, c.course_name, sc.score FROM t_score sc JOIN t_student s ON sc.student_id s.id JOIN t_course c ON sc.course_id c.id ORDER BY sc.id DESC LIMIT ?, ?;注意LIMIT后面的两个参数第一个是偏移量offset第二个是每页条数。用PreparedStatement设置参数时偏移量是int类型页码是int类型直接用ps.setInt即可。很多新手会把这两个位置写反结果永远只显示第一页数据。5. Tomcat发布与常见报错排查从本机到服务器的最后一公里在IDEA里跑通只是第一步很多课设还要求把项目打包部署到独立运行的Tomcat上或者在答辩现场换一台电脑演示。这个时候会遇到一系列环境相关的问题我把自己踩过的坑和排查思路整理成一张问题清单。5.1 打包war包与部署路径的坑IDEA打包Web项目有两种方式一种是Build Artifacts生成war包一种是直接把整个web目录拷贝到Tomcat的webapps目录下。生产环境推荐war包好处是部署和回滚都方便Tomcat会自动解压。但这里有个常见的路径问题需要注意war包解压后的访问路径默认是war包的文件名比如你的包叫grade.war解压后访问路径就是http://localhost:8080/grade/而不是根路径。如果想让项目直接通过根路径访问可以把war包改名为ROOT.war或者在Tomcat的server.xml里配置Context的path属性。这两种方式我推荐改名ROOT.war最简单直接不需要动配置文件。配合前面的LoginFilter逻辑登录成功后重定向的路径也要相应调整如果代码里写死了/grade/index.jsp部署到根路径后就会404。建议所有重定向都用request.getContextPath()动态拼接这样换个部署环境也不用改代码。5.2 常见Bug排查清单把我在部署过程中遇到过的典型报错整理成一张对照表按出现频率排序报错现象根本原因处理方法HTTP Status 404访问路径与Servlet映射不匹配或部署上下文路径不对检查WebServlet注解值、项目Context Path、war包名称ClassNotFoundException: com.mysql.cj.jdbc.Driver驱动jar包未打包进WEB-INF/lib把mysql-connector-j jar包放进lib目录重新构建ArtifactsPort 8080 was already in use8080端口被其他程序占用netstat -ano查PID后结束进程或修改Tomcat端口Access denied for user rootlocalhost数据库密码错误或用户权限不足检查连接串中的用户名密码确认MySQL账号允许本地连接java.sql.SQLException: Unknown database数据库名拼写错误检查连接串中jdbc:mysql://localhost:3306/grade_db的名称页面中文乱码JSP、Servlet、数据库三级编码不一致JSP统一UTF-8Servlet设request/response编码数据库表utf8mb4这里最容易被忽略的就是Artifacts的问题。在IDEA里调试时代码能正常运行因为IDEA开发模式下使用的是项目编译输出目录但部署到Tomcat时Tomcat加载的是war包或webapps目录如果驱动jar没有打进lib目录就会出现ClassNotFoundException。排查时可以先解压war包看看WEB-INF/lib下面有没有驱动文件能省下很多猜疑时间。另外提醒一下数据源连接方式。如果你在项目里用的是DriverManager获取连接每执行一次SQL就新建一个连接高并发下数据库连接数会飙升几百个请求就把MySQL打挂了。但作为课程设计这个写法可以接受答辩时能完成功能和CRUD就达标了。如果想让项目更有亮点可以引入一个简单的数据库连接池比如Druid或者HikariCP只需要在pom里加依赖加上几行配置就能让数据层的健壮性上一个档次答辩时也更有讲头。6. 我踩过的那些坑给课程设计的一次排雷手记项目做完回看整个开发过程真正让我印象深刻的不是某个技术难点而是那些看起来不起眼却浪费了大量时间的小问题。这里挑几个最典型的分享出来希望能帮你绕开。第一个是IDEA里External Libraries和WEB-INF/lib的一致性。如果你在IDEA里通过Project Structure把驱动jar添加到了Libraries但没有把jar拷贝到WEB-INF/lib目录那么在IDEA里测试没问题一旦打包部署就崩溃。我习惯的做法是建一个libs目录把所有的外部jar放进去然后右键Add as Library同时在Project Structure的Artifacts里确认lib目录被包含在Output Layout中。这样部署时才不会丢文件。第二个是JSP页面统一用一套编码。很多同学的页面里有的写charsetUTF-8有的写charsetGBK还有的干脆不写结果中文显示一会正常一会乱码。我的经验是新建项目后第一时间把JSP文件头统一为% page contentTypetext/html;charsetUTF-8 languagejava %idea的File - Settings - Editor - File Encodings里把Global Encoding、Project Encoding、Properties Files都设为UTF-8。前端页面引用中文字符时再用一个filter统一设置request和response的编码这样整个链路从头到尾都是UTF-8基本不会再出乱码。第三个是关于报错日志的阅读习惯。很多新手看到异常堆栈的第一反应是往上翻找红色的字其实Java的异常信息越往下越接近根因。比如看到Caused by: java.sql.SQLException: Unknown database grade_db这个Caused by才是真正的病根。排查时应该从下往上读先看Caused by部分它直接告诉你数据库连接层面发生了什么。做这类系统我最深的体会是它真正锻炼人的地方不在于用了多少新技术而在于逼你把一条完整链路走通——从数据库设计到后端逻辑再到前端页面最后部署到Tomcat上跑起来。这个过程中任何一个环节断裂系统都跑不起来这比单独学某个知识点要有挑战得多。建议你先按表结构把SQL建好再按照登录到增删改查的顺序逐个实现。遇到问题不要慌按异常信息一层层剥大部分坑都能自己解决。本文还有配套的精品资源点击获取 JavaWeb学生成绩管理系统从零到部署全流程详解
简介一套基于JavaWeb与MySQL实现的学生成绩管理系统源码包面向需要课程设计、毕业设计或Web开发练手的学习者帮助教育场景中快速落地成绩录入、查询与统计功能。项目已实现管理员、教师、学生三类角色的登录与权限控制覆盖学生信息维护、课程管理、成绩批量录入与单个修改、按科目和学期筛选查询、及格率与平均分统计、成绩排名等完整业务链代码采用MVC分层与Servlet/JSP技术交互中体现Controller、Service、DAO的协作及数据库安全处理。资源共244个文件以JSP页面、Java源码、class编译文件、jar依赖库、XML配置为主并附带SQL数据库脚本及CSS/JS前端资源压缩包整体约17.15MB解压后目录结构清晰便于导入集成开发环境直接运行与二次学习。当前已有1438人学习下载适合作为快速掌握JavaWeb开发全流程的参考项目也是学习MySQL表设计、JDBC/连接池使用和基础权限管理的良好素材。 每年到课程设计季“javaweb学生成绩管理系统”这个选题都会被大量学生翻出来。选题确实经典但我也见过太多人卡在同一个地方代码跟着教程敲完了启动Tomcat却一堆报错数据库连接写对了页面一刷新就500明明在IDEA里跑得好好的打包部署到服务器就404。这篇文章就把我从需求分析到Tomcat部署的全过程拆开讲清楚包括那些教程里不会明说的坑。这个项目适合谁刚学完Servlet、JSP和MySQL基础语法想做一个完整案例串一遍知识点的同学或者学期末面临课程设计需要一个能跑、能讲、能答辩的项目的人。我会按自己实际动手的顺序来写从建表到发布每一步都解释为什么这么做而不是只给你一串能复制的代码。1. 业务边界与功能规划动手写代码前先想清楚做什么很多新手拿到“学生成绩管理系统”这个题目第一反应是打开IDEA新建项目开写这是最容易翻车的操作。我见过太多半途而废的项目问题几乎都出在前期没想清楚“系统到底管理什么、谁在用、有哪些操作”。先花半小时把需求和表结构理清楚后面能省出两三天折腾的时间。1.1 角色与功能模块的划分学生成绩管理系统最常见的角色有三种管理员、教师、学生。没必要一开始就把权限做得过于复杂但至少要区分出“谁能录入成绩”和“谁能看成绩”否则系统就没有管理可言。管理员维护学生信息和课程信息比如新生入学、转班、毕业这些操作都归他管。教师录入成绩、修改成绩、查看自己所授课程的成绩统计。学生只查自己各科成绩最多再看个排名和学分绩点。对应到功能模块核心就是三大块登录认证模块、学生/课程信息管理模块、成绩管理模块。统计报表可以放到后面的迭代里做第一版先把CRUD跑通比什么都重要。我见过一些同学一上来就想做饼状图、柱状图结果连成绩表都没建出来最后答辩时项目还跑不起来这就是典型的本末倒置。1.2 数据库表结构设计三张表的关联关系成绩管理系统的数据库设计非常经典通常是四张表用户表、学生表、课程表、成绩表。用户表负责登录学生表存学生基本信息课程表存开课信息成绩表则通过外键关联学生和课程。这个设计的核心思想是避免数据冗余——如果每门课的成绩后面都跟着一长串学生姓名和课程名称后续改个名字就要改几十条记录这是新手最容易犯的错误。具体表结构我按实际用到的字段列个清单表名字段说明t_userid, username, password, rolerole区分admin/teacher/studentt_studentid, stu_no, name, gender, class_name学号建议加唯一索引t_courseid, course_no, course_name, teacher_name每门课程对应一位任课教师t_scoreid, student_id, course_id, score, exam_datestudent_id和course_id做联合唯一索引这里有个细节值得注意成绩表的联合唯一索引是必须的。如果不加同样的学生和同样的课程可以录进去两条成绩成绩单一拉出来就有重复行数据就乱了。另外学生表和用户表之间其实可以把账号密码直接放在学生表里但考虑到教师也需要登录单独拆一张用户表逻辑上更清晰扩展性也好。第一个版本哪怕只是用半张表也别省这个设计余量。2. 2023版IDEA创建JavaWeb项目这一步劝退了很多人打开IDEA新建项目很多人习惯性地选择Java Enterprise结果发现新版IDEA的模板和网上老教程完全对不上。2023版IDEA里直接新建一个普通的Java项目再手动添加Web支持反而比用模板省心。下面是我验证过的可行路径每一步都标注了关键注意点。2.1 从普通Java项目手动转成Web项目在2023.2版本中操作流程是这样的新建一个空的Java项目选择JDK版本JDK 8还是17取决于你后面用的Tomcat版本Tomcat 9配JDK 8最稳Tomcat 10以上建议JDK 11然后右键项目名选择“Add Framework Support”在弹出的窗口里勾选Web Application。这一步会自动生成web目录里面包含WEB-INF文件夹和一个空的web.xml。很多教程会建议你勾选“Create web.xml”但如果你用的是Servlet注解方式WebServletweb.xml可以留空甚至不要。不过为了兼容性我还是建议保留一个最基本的框架文件后面配置欢迎页和过滤器都要用到它。2.2 配置Tomcat的两种方式和常见失败原因IDEA里配置Tomcat的方式有两种一种是使用Smart Tomcat插件另一种是IDEA自带的Tomcat Server配置。我推荐Smart Tomcat插件主要原因是它不需要额外的部署步骤对新手友好得多。安装方式是在Settings - Plugins里搜索Smart Tomcat安装后重启IDEA。配置时注意几个地方Tomcat Server路径要选到Tomcat的根目录不是bin目录Deployment目录选择你项目的web目录Context Path建议设置为项目名比如/grade这样访问地址就是http://localhost:8080/grade/index.jsp。新手最常见的报错是端口号冲突启动日志显示Port 8080 was already in use。处理方法很简单把占用进程关掉——先netstat -ano查端口占用PID再任务管理器结束进程或者直接改Tomcat的端口号。我个人习惯直接把端口改为8081一劳永逸省得每次启动都排查。3. 数据库连接中的编码与版本匹配JDBC踩坑实录表结构建好了项目也能启动了接下来就要面对整个系统里最容易出问题的一环Java和MySQL之间的连接。很多人的代码逻辑完全正确但启动时就是报错多半是驱动版本不匹配、连接串参数不对、或者编码混乱导致的中文乱码。这三类问题我挨个说。3.1 驱动jar版本与MySQL版本的匹配这是最多人踩的坑。你在网上下载一段JDBC连接代码用的是mysql-connector-java 5.1.x的驱动但本地装的是MySQL 8.0那么一运行就会报Communications link failure或者Client does not support authentication protocol requested by server。MySQL 8.0以上版本默认使用caching_sha2_password认证插件老驱动不认识这个协议直接拒绝连接。解决方法是使用mysql-connector-j 8.0.x版本的驱动同时连接串里的Driver类要改为com.mysql.cj.jdbc.Driver。如果你用的是Maven项目在pom.xml里加依赖时也要注意版本号8.0.33是我验证过的稳定版本。需要提醒的是如果驱动jar包是手动拷贝到WEB-INF/lib目录的一定要确认IDEA的Artifacts里把这个目录包含进去了否则运行时类找不到驱动会报ClassNotFoundException这一点在切换Tomcat部署方式后特别容易忽略。3.2 连接串参数为什么一定要带serverTimezone和useSSL连接串的正确写法如下String url jdbc:mysql://localhost:3306/grade_db?useSSLfalseserverTimezoneAsia/ShanghaicharacterEncodingutf8;useSSLfalse的意思是关闭SSL加密连接本地开发环境没必要做加密而且不关会报一堆证书警告看着心烦。serverTimezoneAsia/Shanghai是MySQL 8.0以后必须加的参数不加会报The server time zone value Öйú±ê׼ʱ¼ä is unrecognized这个乱码会让你误以为是系统编码问题其实是时区问题。characterEncodingutf8解决的是中文乱码问题。这里有个细节MySQL的utf8字符集实际是utf8mb3不支持emoji等四字节字符如果连数据库的字符集都设置成utf8mb4连接串里就写characterEncodingutf8JDBC会自动协商为utf8mb4。数据表创建时统一使用utf8mb4能省掉后续一大堆显示问题。3.3 PreparedStatement防SQL注入的底线很多新手学JDBC时用的是Statement然后通过字符串拼接SQL比如SELECT * FROM t_user WHERE username name AND password pwd 。这种写法最大的隐患是SQL注入——如果用户在用户名框里输入 or 11拼接出来的SQL就变成了WHERE username or 11条件恒真等于绕过了密码校验。就算你的程序不涉及支付交易课程设计答辩时老师也极大概率会问这个问题答不上来印象分会大打折扣。正确做法是用PreparedStatement预编译参数用占位符?传递String sql SELECT * FROM t_user WHERE username ? AND password ?; PreparedStatement ps conn.prepareStatement(sql); ps.setString(1, username); ps.setString(2, password); ResultSet rs ps.executeQuery();两种写法效果完全不同Statement每次执行都要编译SQL而PreparedStatement在执行前就完成了语法解析和编译参数部分用占位符即使传入的内容包含SQL关键字也不会被当作SQL执行。4. 登录会话与成绩CRUD核心功能的完整实现链路数据库连接层稳定之后系统的业务代码就有底气了。这一节我按数据流动的顺序来讲登录请求进来后怎么校验登录成功后如何保持状态受限页面如何拦截最后是成绩数据增删改查的完整链路。4.1 登录逻辑Session会话保持与密码安全登录请求的结构一般是这样前端表单把username和password提交到LoginServletServlet调用DAO层查询用户表查询结果存在说明账号密码正确就把用户信息放入session然后重定向到index.jsp查询结果为空就返回登录页并提示错误。这里有两个容易被忽视的细节。第一个是密码安全。课程设计项目一般不要求做加密但直接在数据库里存明文密码确实很难看。最低成本的优化是用MD5加盐处理盐值取用户名这样即使数据库泄露明文密码也不会直接暴露。实现很简单不引第三方库也能写public static String md5(String input) { try { MessageDigest md MessageDigest.getInstance(MD5); byte[] digest md.digest(input.getBytes()); StringBuilder sb new StringBuilder(); for (byte b : digest) { sb.append(String.format(%02x, b)); } return sb.toString(); } catch (NoSuchAlgorithmException e) { throw new RuntimeException(e); } }存密码时写入md5(明文密码 用户名)校验时用同样的规则算一次再比对即可。这个方案的定位是“防君子不防小人”但答辩时能说明白原理就已经比大部分同学强了。第二个是Session的作用域问题。一个常见的错误是在登录成功后使用session.setAttribute但在JSP页面里用${sessionScope.user}取值时发现是null检查半天发现是跳转方式不对。记住一个原则不在Session里塞请求级别的东西登录用户信息属于会话级别放Session没错但表单提交的查询参数属于请求级别应该用request传递。很多页面数据“丢了”根源就是不该放在Session里的数据占用了内存该放request的数据被塞进了session逻辑一复杂就分不清状态来源了。4.2 用Filter统一拦截未登录访问系统里有些页面比如成绩管理后台不应该被未登录用户直接访问。最原始的写法是在每个Servlet里都判断session里有没有用户代码重复不说漏一个页面就是安全漏洞。更规范的做法是写一个全局的过滤器继承javax.servlet.Filter接口在doFilter方法里统一做拦截判断。完整实现大概是这样WebFilter(/*) public class LoginFilter implements Filter { public void doFilter(ServletRequest req, ServletResponse resp, FilterChain chain) throws IOException, ServletException { HttpServletRequest request (HttpServletRequest) req; HttpServletResponse response (HttpServletResponse) resp; HttpSession session request.getSession(false); String uri request.getRequestURI(); // 放行登录接口和静态资源 if (uri.endsWith(login.jsp) || uri.endsWith(LoginServlet) || uri.contains(/css/) || uri.contains(/js/)) { chain.doFilter(req, resp); return; } if (session null || session.getAttribute(user) null) { response.sendRedirect(request.getContextPath() /login.jsp); return; } chain.doFilter(req, resp); } }这里有个排错的关键细节request.getSession(false)和getSession()是有区别的。getSession()会强制创建一个新的Session对象即使用户没登录过也会自动建一个getSession(false)只在已有Session时返回没有就返回null。如果在这里误用了getSession()会导致每来一个请求就创建一个Session过滤器判断永远不为null登录拦截形同虚设。4.3 成绩增删改查的流程设计与重定向陷阱成绩管理页面的CRUD操作核心逻辑都不复杂就是把SQL换成对应的INSERT、UPDATE、DELETE、SELECT。真正容易出问题的是表单提交之后的跳转方式。比如添加成绩成功后很多新手直接request.getRequestDispatcher(scoreList.jsp).forward(request, response)做转发结果用户按F5刷新页面时表单被重复提交数据库里出现两条一模一样的记录。正确的做法是Redirect After Post模式Servlet执行完插入操作后用response.sendRedirect(score?actionlist)重定向到查询页面。这样浏览器地址栏会变成查询列表的URL刷新操作执行的是查询而不是重复提交表单。这个模式在课程设计答辩中是加分项因为很多同学做了几年校园项目都没关注过重复提交问题。至于成绩列表的分页建议用最简单的LIMIT分页实现不要引入PageHelper或者MyBatisPlus这种框架毕竟整个项目是Servlet技术栈用原生SQL反而更直观int pageSize 10; int currentPage request.getParameter(page) null ? 1 : Integer.parseInt(request.getParameter(page)); int offset (currentPage - 1) * pageSize; String sql SELECT s.stu_no, s.name, c.course_name, sc.score FROM t_score sc JOIN t_student s ON sc.student_id s.id JOIN t_course c ON sc.course_id c.id ORDER BY sc.id DESC LIMIT ?, ?;注意LIMIT后面的两个参数第一个是偏移量offset第二个是每页条数。用PreparedStatement设置参数时偏移量是int类型页码是int类型直接用ps.setInt即可。很多新手会把这两个位置写反结果永远只显示第一页数据。5. Tomcat发布与常见报错排查从本机到服务器的最后一公里在IDEA里跑通只是第一步很多课设还要求把项目打包部署到独立运行的Tomcat上或者在答辩现场换一台电脑演示。这个时候会遇到一系列环境相关的问题我把自己踩过的坑和排查思路整理成一张问题清单。5.1 打包war包与部署路径的坑IDEA打包Web项目有两种方式一种是Build Artifacts生成war包一种是直接把整个web目录拷贝到Tomcat的webapps目录下。生产环境推荐war包好处是部署和回滚都方便Tomcat会自动解压。但这里有个常见的路径问题需要注意war包解压后的访问路径默认是war包的文件名比如你的包叫grade.war解压后访问路径就是http://localhost:8080/grade/而不是根路径。如果想让项目直接通过根路径访问可以把war包改名为ROOT.war或者在Tomcat的server.xml里配置Context的path属性。这两种方式我推荐改名ROOT.war最简单直接不需要动配置文件。配合前面的LoginFilter逻辑登录成功后重定向的路径也要相应调整如果代码里写死了/grade/index.jsp部署到根路径后就会404。建议所有重定向都用request.getContextPath()动态拼接这样换个部署环境也不用改代码。5.2 常见Bug排查清单把我在部署过程中遇到过的典型报错整理成一张对照表按出现频率排序报错现象根本原因处理方法HTTP Status 404访问路径与Servlet映射不匹配或部署上下文路径不对检查WebServlet注解值、项目Context Path、war包名称ClassNotFoundException: com.mysql.cj.jdbc.Driver驱动jar包未打包进WEB-INF/lib把mysql-connector-j jar包放进lib目录重新构建ArtifactsPort 8080 was already in use8080端口被其他程序占用netstat -ano查PID后结束进程或修改Tomcat端口Access denied for user rootlocalhost数据库密码错误或用户权限不足检查连接串中的用户名密码确认MySQL账号允许本地连接java.sql.SQLException: Unknown database数据库名拼写错误检查连接串中jdbc:mysql://localhost:3306/grade_db的名称页面中文乱码JSP、Servlet、数据库三级编码不一致JSP统一UTF-8Servlet设request/response编码数据库表utf8mb4这里最容易被忽略的就是Artifacts的问题。在IDEA里调试时代码能正常运行因为IDEA开发模式下使用的是项目编译输出目录但部署到Tomcat时Tomcat加载的是war包或webapps目录如果驱动jar没有打进lib目录就会出现ClassNotFoundException。排查时可以先解压war包看看WEB-INF/lib下面有没有驱动文件能省下很多猜疑时间。另外提醒一下数据源连接方式。如果你在项目里用的是DriverManager获取连接每执行一次SQL就新建一个连接高并发下数据库连接数会飙升几百个请求就把MySQL打挂了。但作为课程设计这个写法可以接受答辩时能完成功能和CRUD就达标了。如果想让项目更有亮点可以引入一个简单的数据库连接池比如Druid或者HikariCP只需要在pom里加依赖加上几行配置就能让数据层的健壮性上一个档次答辩时也更有讲头。6. 我踩过的那些坑给课程设计的一次排雷手记项目做完回看整个开发过程真正让我印象深刻的不是某个技术难点而是那些看起来不起眼却浪费了大量时间的小问题。这里挑几个最典型的分享出来希望能帮你绕开。第一个是IDEA里External Libraries和WEB-INF/lib的一致性。如果你在IDEA里通过Project Structure把驱动jar添加到了Libraries但没有把jar拷贝到WEB-INF/lib目录那么在IDEA里测试没问题一旦打包部署就崩溃。我习惯的做法是建一个libs目录把所有的外部jar放进去然后右键Add as Library同时在Project Structure的Artifacts里确认lib目录被包含在Output Layout中。这样部署时才不会丢文件。第二个是JSP页面统一用一套编码。很多同学的页面里有的写charsetUTF-8有的写charsetGBK还有的干脆不写结果中文显示一会正常一会乱码。我的经验是新建项目后第一时间把JSP文件头统一为% page contentTypetext/html;charsetUTF-8 languagejava %idea的File - Settings - Editor - File Encodings里把Global Encoding、Project Encoding、Properties Files都设为UTF-8。前端页面引用中文字符时再用一个filter统一设置request和response的编码这样整个链路从头到尾都是UTF-8基本不会再出乱码。第三个是关于报错日志的阅读习惯。很多新手看到异常堆栈的第一反应是往上翻找红色的字其实Java的异常信息越往下越接近根因。比如看到Caused by: java.sql.SQLException: Unknown database grade_db这个Caused by才是真正的病根。排查时应该从下往上读先看Caused by部分它直接告诉你数据库连接层面发生了什么。做这类系统我最深的体会是它真正锻炼人的地方不在于用了多少新技术而在于逼你把一条完整链路走通——从数据库设计到后端逻辑再到前端页面最后部署到Tomcat上跑起来。这个过程中任何一个环节断裂系统都跑不起来这比单独学某个知识点要有挑战得多。建议你先按表结构把SQL建好再按照登录到增删改查的顺序逐个实现。遇到问题不要慌按异常信息一层层剥大部分坑都能自己解决。本文还有配套的精品资源点击获取