簡(jiǎn)介在Web開(kāi)發(fā)學(xué)習(xí)路徑中理解底層原理往往比直接使用框架更為關(guān)鍵。JSP作為Servlet的模板化擴(kuò)展本質(zhì)是在服務(wù)端動(dòng)態(tài)生成HTML配合Servlet處理請(qǐng)求分發(fā)、JDBC操作數(shù)據(jù)庫(kù)形成了一套完整且透明的請(qǐng)求-響應(yīng)鏈路。這種經(jīng)典組合能清晰展示HTTP會(huì)話(huà)管理、用戶(hù)鑒權(quán)、SQL查詢(xún)與數(shù)據(jù)渲染的每個(gè)環(huán)節(jié)非常適合課程設(shè)計(jì)、畢業(yè)設(shè)計(jì)及初學(xué)者練手。從數(shù)據(jù)庫(kù)表結(jié)構(gòu)設(shè)計(jì)、連接池配置到登錄過(guò)濾器的實(shí)現(xiàn)再到成績(jī)統(tǒng)計(jì)的聚合查詢(xún)與防重復(fù)提交的冪等處理每一步都承載著Web工程的核心實(shí)踐。無(wú)論是構(gòu)建學(xué)生信息管理系統(tǒng)還是其他業(yè)務(wù)后臺(tái)掌握J(rèn)SPServletMySQL這套技術(shù)棧都能為后續(xù)學(xué)習(xí)Spring Boot等高級(jí)框架打下堅(jiān)實(shí)基礎(chǔ)。本文以一個(gè)學(xué)生成績(jī)綜合管理系統(tǒng)為藍(lán)本完整拆解了從需求分析到故障排查的全過(guò)程幫助你快速搭建一個(gè)穩(wěn)定可演示的Java Web項(xiàng)目。 做課程設(shè)計(jì)或者畢業(yè)設(shè)計(jì)的同學(xué)大概率繞不開(kāi)“學(xué)生成績(jī)管理系統(tǒng)”這類(lèi)題目尤其是當(dāng)題目里明明白白寫(xiě)著 JavaJSP MySQL 的時(shí)候。我身邊不少人一看到 JSP 就皺眉覺(jué)得這技術(shù)“老掉牙”了但說(shuō)句實(shí)在話(huà)對(duì)于學(xué)習(xí)階段的項(xiàng)目、答辯演示、以及理解 Web 開(kāi)發(fā)的核心鏈路來(lái)說(shuō)JSP Servlet MySQL 這套組合反而是最透明的每一步請(qǐng)求怎么走、數(shù)據(jù)怎么查、頁(yè)面怎么渲染你都能看得一清二楚沒(méi)有任何黑盒。這個(gè)項(xiàng)目雖然掛著“教學(xué)系統(tǒng)”的名字但它其實(shí)覆蓋了 Web 項(xiàng)目開(kāi)發(fā)從零到一的全部關(guān)鍵點(diǎn)——數(shù)據(jù)庫(kù)設(shè)計(jì)、JDBC 操作、Servlet 控制層、JSP 展示層、登錄鑒權(quán)、增刪改查、統(tǒng)計(jì)報(bào)表一個(gè)都不少。學(xué)生成績(jī)綜合管理系統(tǒng)最適合用來(lái)打通 Web 開(kāi)發(fā)任督二脈也適合那些需要快速交付一個(gè)穩(wěn)定可演示系統(tǒng)的同學(xué)。這篇文章我就以這個(gè)項(xiàng)目為藍(lán)本把我實(shí)際開(kāi)發(fā)過(guò)程中踩過(guò)的坑、優(yōu)化過(guò)的細(xì)節(jié)、以及那些學(xué)校文檔里不會(huì)寫(xiě)的東西全部拆開(kāi)來(lái)講。無(wú)論你是要用它當(dāng)課程設(shè)計(jì)還是想自己動(dòng)手做一個(gè)完整項(xiàng)目練手都能直接照著做。1. 項(xiàng)目整體設(shè)計(jì)與需求拆解1.1 技術(shù)選型背后的邏輯為什么 JSP 仍然是練手的最佳選擇先回答一個(gè)大家都會(huì)問(wèn)的問(wèn)題現(xiàn)在企業(yè)里都用 Spring Boot Vue 了為什么還要用 JSP我的看法是學(xué)習(xí)階段的重點(diǎn)不是“用最新的框架”而是“理解原理”。JSP 的本質(zhì)是 Servlet它在服務(wù)端把 Java 代碼和 HTML 模板揉在一起然后編譯成 Servlet 執(zhí)行。用 JSP 做項(xiàng)目你被迫去理解 HTTP 請(qǐng)求是怎么到達(dá)服務(wù)器的、Session 是怎么維持登錄狀態(tài)的、JDBC 是怎么把數(shù)據(jù)庫(kù)記錄變成 Java 對(duì)象的。這些底層概念換了 Spring Boot 也一樣重要只是框架幫你藏起來(lái)了。這個(gè)項(xiàng)目我采用的是經(jīng)典的 JSP Servlet JavaBean 三層結(jié)構(gòu)JSP 層負(fù)責(zé)頁(yè)面展示和表單收集比如登錄頁(yè)、學(xué)生列表頁(yè)、成績(jī)錄入頁(yè)Servlet 層負(fù)責(zé)接收請(qǐng)求、調(diào)用業(yè)務(wù)邏輯、跳轉(zhuǎn)頁(yè)面相當(dāng)于路由器JavaBean / DAO 層負(fù)責(zé)封裝數(shù)據(jù)和操作數(shù)據(jù)庫(kù)JDBC 的代碼都寫(xiě)在這一層。MySQL 作為數(shù)據(jù)庫(kù)是這套組合里最沒(méi)有爭(zhēng)議的選擇。MySQL 社區(qū)版免費(fèi)、安裝方便、SQL 語(yǔ)法標(biāo)準(zhǔn)而且市面上教程極多遇到任何問(wèn)題基本一搜就有答案。對(duì)于一個(gè)成績(jī)管理系統(tǒng)它的數(shù)據(jù)量級(jí)在幾千到幾萬(wàn)條記錄MySQL 的性能綽綽有余。1.2 功能模塊劃分一個(gè)“綜合管理系統(tǒng)”到底要管什么“綜合”兩個(gè)字是這個(gè)項(xiàng)目的題眼。它不只是簡(jiǎn)單的成績(jī)錄入而是把學(xué)生、教師、課程、成績(jī)、用戶(hù)權(quán)限全部串起來(lái)。我按照角色的視角把功能拆成四塊模塊主要功能涉及角色系統(tǒng)登錄用戶(hù)名密碼驗(yàn)證、Session 管理、退出登錄管理員/教師/學(xué)生學(xué)生管理學(xué)號(hào)、姓名、班級(jí)、院系的新增/修改/刪除/查詢(xún)管理員課程管理課程編號(hào)、課程名、學(xué)分、授課教師的新增/修改/刪除管理員/教師成績(jī)管理成績(jī)錄入、修改、審核、按課程/班級(jí)/個(gè)人查詢(xún)教師/管理員統(tǒng)計(jì)報(bào)表平均分、最高分、最低分、及格率、分?jǐn)?shù)段分布全部角色不同角色的權(quán)限差異很關(guān)鍵。學(xué)生登錄后只能看到自己的成績(jī)不能看到別人的教師登錄后能錄入和修改自己授課課程的成績(jī)但不能改其他課程管理員擁有全部權(quán)限。這個(gè)權(quán)限控制如果用 Spring Security 做配置一大堆反而看不明白用 Session Filter 手動(dòng)實(shí)現(xiàn)你能清楚知道每一個(gè)受保護(hù)頁(yè)面的訪(fǎng)問(wèn)是經(jīng)過(guò)怎樣的校驗(yàn)這種“笨辦法”對(duì)學(xué)習(xí)反而更友好。1.3 頁(yè)面流程設(shè)計(jì)從登錄到報(bào)表的完整鏈路我建議你先把整個(gè)系統(tǒng)的頁(yè)面跳轉(zhuǎn)圖畫(huà)出來(lái)再動(dòng)手寫(xiě)代碼。這個(gè)系統(tǒng)的核心鏈路是打開(kāi)登錄頁(yè) index.jsp → 提交表單到 LoginServlet → 查詢(xún)用戶(hù)表驗(yàn)證身份 → 查詢(xún)角色類(lèi)型 → 跳轉(zhuǎn)對(duì)應(yīng)主頁(yè)admin.jsp / teacher.jsp / student.jsp→ 在主頁(yè)點(diǎn)“成績(jī)管理”進(jìn)入 ScoreListServlet → JSP 列表頁(yè)展示 → 點(diǎn)“錄入”進(jìn)入 ScoreAddServlet → 錄入成功返回列表頁(yè)。這個(gè)鏈路每一步都有對(duì)應(yīng)的文件寫(xiě)完以后你會(huì)對(duì)“請(qǐng)求-處理-響應(yīng)”這套模型有非常具象的理解。我見(jiàn)過(guò)太多人上來(lái)就寫(xiě)代碼結(jié)果寫(xiě)到一半發(fā)現(xiàn)缺了一張表、少了一個(gè) Servlet再回頭改數(shù)據(jù)庫(kù)非常痛苦。先把流程圖畫(huà)清楚后面寫(xiě)代碼只需要照著填。2. 數(shù)據(jù)庫(kù)設(shè)計(jì)與核心細(xì)節(jié)2.1 五張核心表結(jié)構(gòu)設(shè)計(jì)數(shù)據(jù)庫(kù)設(shè)計(jì)是這個(gè)項(xiàng)目的重中之重。很多人建表很隨意導(dǎo)致后面寫(xiě) SQL 的時(shí)候各種別扭。我的建議是最少建五張表t_user用戶(hù)表、t_student學(xué)生表、t_teacher教師表、t_course課程表、t_score成績(jī)表。先看建表 SQL這是我從實(shí)際項(xiàng)目中抽取的簡(jiǎn)化版本字段講求實(shí)用CREATE DATABASE IF NOT EXISTS student_score_db DEFAULT CHARACTER SET utf8mb4; USE student_score_db; -- 用戶(hù)表存登錄賬號(hào)密碼和角色 CREATE TABLE t_user ( id INT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(50) NOT NULL UNIQUE, password VARCHAR(100) NOT NULL, role VARCHAR(20) NOT NULL COMMENT ADMIN/TEACHER/STUDENT, ref_id INT COMMENT 關(guān)聯(lián)學(xué)生表或教師表的主鍵學(xué)生和教師登錄用 ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; -- 學(xué)生表 CREATE TABLE t_student ( id INT PRIMARY KEY AUTO_INCREMENT, student_no VARCHAR(20) NOT NULL UNIQUE COMMENT 學(xué)號(hào), name VARCHAR(50) NOT NULL, gender VARCHAR(10), class_name VARCHAR(50), major VARCHAR(50), enroll_year VARCHAR(10) COMMENT 入學(xué)年份 ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; -- 教師表 CREATE TABLE t_teacher ( id INT PRIMARY KEY AUTO_INCREMENT, teacher_no VARCHAR(20) NOT NULL UNIQUE COMMENT 工號(hào), name VARCHAR(50) NOT NULL, title VARCHAR(30) COMMENT 職稱(chēng), department VARCHAR(50) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; -- 課程表 CREATE TABLE t_course ( id INT PRIMARY KEY AUTO_INCREMENT, course_no VARCHAR(20) NOT NULL UNIQUE, course_name VARCHAR(100) NOT NULL, credit DECIMAL(3,1) DEFAULT 2.0 COMMENT 學(xué)分, teacher_id INT COMMENT 授課教師ID ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; -- 成績(jī)表 CREATE TABLE t_score ( id INT PRIMARY KEY AUTO_INCREMENT, student_id INT NOT NULL, course_id INT NOT NULL, score DECIMAL(5,2) COMMENT 成績(jī), semester VARCHAR(20) COMMENT 學(xué)期如 2025-2026-1, exam_type VARCHAR(20) DEFAULT 期終 COMMENT 考試類(lèi)型, update_time DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, UNIQUE KEY uk_student_course (student_id, course_id, semester, exam_type) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;這里幾個(gè)設(shè)計(jì)意圖說(shuō)一下。t_user 表單獨(dú)拆出來(lái)而不是在學(xué)生表和教師表里直接加 username 和 password是為了讓登錄邏輯統(tǒng)一不管什么角色都從 t_user 查查到了再根據(jù) role 去對(duì)應(yīng)表拿詳細(xì)信息。ref_id 字段記錄關(guān)聯(lián)的學(xué)生或教師主鍵這樣登錄后可以方便地拿到個(gè)人信息。t_score 表中我加了一個(gè)聯(lián)合唯一鍵uk_student_course (student_id, course_id, semester, exam_type)這非常關(guān)鍵。它的作用是防止同一個(gè)學(xué)生在同一學(xué)期同一門(mén)課被重復(fù)錄入成績(jī)。如果沒(méi)有這個(gè)約束程序里忘記判斷數(shù)據(jù)庫(kù)就可能出現(xiàn)兩條一模一樣的成績(jī)記錄統(tǒng)計(jì)平均分的時(shí)候直接翻車(chē)。2.2 外鍵、索引與存儲(chǔ)引擎的選擇關(guān)于外鍵我的建議是在表結(jié)構(gòu)上不加物理外鍵而是使用邏輯關(guān)聯(lián)。這個(gè)項(xiàng)目里 t_score.student_id 邏輯上引用 t_student.idt_score.course_id 引用 t_course.id但我不建FOREIGN KEY約束。原因很簡(jiǎn)單物理外鍵在刪除數(shù)據(jù)時(shí)會(huì)有各種限制比如你想刪除一個(gè)學(xué)生如果他在成績(jī)表里有記錄外鍵會(huì)阻止刪除或者需要先刪成績(jī)這在課程設(shè)計(jì)答辯演示時(shí)非常不靈活。我自己在開(kāi)發(fā)中更多的做法是在應(yīng)用層保證數(shù)據(jù)一致性刪除前先查一下有沒(méi)有關(guān)聯(lián)數(shù)據(jù)。物理外鍵適合數(shù)據(jù)完整性要求極高、刪除操作極少的生產(chǎn)系統(tǒng)但不適合這種交互頻繁的教學(xué)項(xiàng)目。索引方面除了唯一索引我給 t_score 表的 course_id 加了普通索引因?yàn)椤鞍凑n程統(tǒng)計(jì)成績(jī)”是最常見(jiàn)的查詢(xún)ALTER TABLE t_score ADD INDEX idx_course (course_id);2.3 字符集與時(shí)區(qū)連接 MySQL 最容易踩的坑建庫(kù)的時(shí)候定了 utf8mb4連接的時(shí)候也得對(duì)應(yīng)上。utf8mb4 和 utf8 的區(qū)別是前者支持 Emoji 表情和生僻字現(xiàn)在建庫(kù)無(wú)腦用 utf8mb4 就行。JDBC 連接串里要明確指定參數(shù)jdbc:mysql://localhost:3306/student_score_db?useUnicodetruecharacterEncodingutf8mb4serverTimezoneAsia/ShanghaiuseUnicodetruecharacterEncodingutf8mb4是告訴驅(qū)動(dòng)用 UTF-8 編碼傳輸數(shù)據(jù)serverTimezoneAsia/Shanghai是針對(duì) MySQL 8.x 的時(shí)區(qū)設(shè)置。如果不加 serverTimezone經(jīng)常會(huì)報(bào)The server time zone value ?D1ú±ê×?ê±?? is unrecognized這種亂碼報(bào)錯(cuò)。這個(gè)我后面在常見(jiàn)問(wèn)題里再詳細(xì)展開(kāi)。3. 核心代碼實(shí)現(xiàn)與實(shí)操3.1 項(xiàng)目目錄結(jié)構(gòu)Java Web 項(xiàng)目的經(jīng)典布局用 IDEA 2019 及以上版本創(chuàng)建一個(gè) Web 項(xiàng)目項(xiàng)目的目錄結(jié)構(gòu)長(zhǎng)這樣StudentScoreSystem/ ├── src/ │ └── com/score/ │ ├── dao/ │ │ ├── UserDao.java │ │ ├── StudentDao.java │ │ ├── TeacherDao.java │ │ ├── CourseDao.java │ │ └── ScoreDao.java │ ├── entity/ │ │ ├── User.java │ │ ├── Student.java │ │ ├── Teacher.java │ │ ├── Course.java │ │ └── Score.java │ ├── servlet/ │ │ ├── LoginServlet.java │ │ ├── LogoutServlet.java │ │ ├── StudentServlet.java │ │ ├── CourseServlet.java │ │ ├── ScoreQueryServlet.java │ │ └── ScoreAddServlet.java │ └── util/ │ └── DBUtil.java ├── web/ │ ├── index.jsp │ ├── admin/ │ │ ├── admin_home.jsp │ │ ├── student_list.jsp │ │ └── course_list.jsp │ ├── teacher/ │ │ └── teacher_home.jsp │ ├── student/ │ │ └── student_home.jsp │ └── WEB-INF/ │ ├── web.xml │ └── lib/ │ └── mysql-connector-java-8.0.30.jarentity 包里的類(lèi)就是 JavaBean字段和數(shù)據(jù)庫(kù)表一一對(duì)應(yīng)dao 包里的類(lèi)負(fù)責(zé) JDBC 操作servlet 包接收請(qǐng)求調(diào)用 dao再把結(jié)果塞進(jìn) request 或 session最后 forward 或 redirect 到 JSP 頁(yè)面。分包清晰的好處是后期改了表結(jié)構(gòu)你只需要改 entity 和 daocontrol 層和視圖層基本不用動(dòng)。3.2 JDBC 連接工具類(lèi) DBUtil寫(xiě)一次到處用JDBC 連接的代碼很固定我把它封裝成一個(gè)工具類(lèi)。這里注意一點(diǎn)連接信息用配置文件管理不要硬編碼在 Java 代碼里。我在 src 目錄下放一個(gè) db.propertiesjdbc.drivercom.mysql.cj.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/student_score_db?useUnicodetruecharacterEncodingutf8mb4serverTimezoneAsia/Shanghai jdbc.usernameroot jdbc.password123456然后 DBUtil 讀取這個(gè)配置文件package com.score.util; import java.io.InputStream; import java.sql.Connection; import java.sql.DriverManager; import java.sql.ResultSet; import java.sql.SQLException; import java.sql.Statement; import java.util.Properties; public class DBUtil { private static String driver; private static String url; private static String username; private static String password; static { try { InputStream in DBUtil.class.getClassLoader().getResourceAsStream(db.properties); Properties props new Properties(); props.load(in); driver props.getProperty(jdbc.driver); url props.getProperty(jdbc.url); username props.getProperty(jdbc.username); password props.getProperty(jdbc.password); Class.forName(driver); } catch (Exception e) { e.printStackTrace(); } } public static Connection getConnection() throws SQLException { return DriverManager.getConnection(url, username, password); } public static void close(ResultSet rs, Statement stmt, Connection conn) { try { if (rs ! null) rs.close(); } catch (SQLException e) { e.printStackTrace(); } try { if (stmt ! null) stmt.close(); } catch (SQLException e) { e.printStackTrace(); } try { if (conn ! null) conn.close(); } catch (SQLException e) { e.printStackTrace(); } } }Class.forName(driver)這行代碼如果你用的是 MySQL 8.x 驅(qū)動(dòng)com.mysql.cj.jdbc.Driver必須要寫(xiě)MySQL 5.x 的驅(qū)動(dòng)是 com.mysql.jdbc.Driver不要混。很多同學(xué)報(bào)ClassNotFoundException就是驅(qū)動(dòng)類(lèi)路徑寫(xiě)錯(cuò)或者 jar 包沒(méi)放到 WEB-INF/lib 下。注意關(guān)資源的順序是 ResultSet → Statement → Connection先開(kāi)后關(guān)。我見(jiàn)過(guò)有人只關(guān)了 Connection不關(guān) Statement 和 ResultSet短時(shí)間看不出問(wèn)題但連接池一緊張就會(huì)報(bào)連接泄漏。3.3 登錄鑒權(quán)與 Session 管理別把密碼明文存數(shù)據(jù)庫(kù)登錄功能是整個(gè)系統(tǒng)的門(mén)面也是過(guò)濾器邏輯的核心。先看 LoginServlet 的核心邏輯package com.score.servlet; import com.score.dao.UserDao; import com.score.entity.User; import javax.servlet.ServletException; import javax.servlet.annotation.WebServlet; import javax.servlet.http.*; import java.io.IOException; WebServlet(/login) public class LoginServlet extends HttpServlet { protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { request.setCharacterEncoding(UTF-8); String username request.getParameter(username); String password request.getParameter(password); UserDao userDao new UserDao(); User user userDao.findByUsernameAndPassword(username, password); if (user ! null) { HttpSession session request.getSession(); session.setAttribute(loginUser, user); session.setMaxInactiveInterval(30 * 60); // 30分鐘無(wú)操作自動(dòng)過(guò)期 if (ADMIN.equals(user.getRole())) { response.sendRedirect(request.getContextPath() /admin/admin_home.jsp); } else if (TEACHER.equals(user.getRole())) { response.sendRedirect(request.getContextPath() /teacher/teacher_home.jsp); } else { response.sendRedirect(request.getContextPath() /student/student_home.jsp); } } else { request.setAttribute(msg, 用戶(hù)名或密碼錯(cuò)誤); request.getRequestDispatcher(/index.jsp).forward(request, response); } } }密碼存儲(chǔ)這里我多說(shuō)兩句。課程設(shè)計(jì)里很多人直接明文存密碼圖省事但我覺(jué)得做項(xiàng)目還是要有基本的安全意識(shí)。正確做法是存 MD5 或 SHA-256 的哈希值甚至加鹽。舉一個(gè)簡(jiǎn)單實(shí)現(xiàn)用戶(hù)注冊(cè)時(shí)用DigestUtils.md5Hex(password salt)存進(jìn)去登錄校驗(yàn)時(shí)把輸入密碼做同樣的哈希再比對(duì)。JDK 自帶 MessageDigest不需要引額外依賴(lài)import java.security.MessageDigest; import java.security.NoSuchAlgorithmException; public class MD5Util { public static String md5(String source) { try { MessageDigest md MessageDigest.getInstance(MD5); byte[] bytes md.digest(source.getBytes(UTF-8)); StringBuilder sb new StringBuilder(); for (byte b : bytes) { String hex Integer.toHexString(b 0xff); if (hex.length() 1) sb.append(0); sb.append(hex); } return sb.toString(); } catch (Exception e) { throw new RuntimeException(e); } } }登錄之后怎么保護(hù)頁(yè)面用 Filter 是最標(biāo)準(zhǔn)的做法。LoginFilter 攔截所有 /admin/、/teacher/、/student/* 的請(qǐng)求檢查 session 里有沒(méi)有 loginUser沒(méi)有就跳回登錄頁(yè)package com.score.filter; import javax.servlet.*; import javax.servlet.annotation.WebFilter; import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletResponse; import javax.servlet.http.HttpSession; import java.io.IOException; WebFilter(/admin/*) public class AdminFilter 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); if (session null || session.getAttribute(loginUser) null) { response.sendRedirect(request.getContextPath() /index.jsp); return; } // 這里還可以繼續(xù)判斷角色不是 ADMIN 就 403 chain.doFilter(req, resp); } }這里有個(gè)小細(xì)節(jié)request.getSession(false)而不是getSession()。傳 false 表示如果當(dāng)前沒(méi)有 Session 就返回 null而不是創(chuàng)建一個(gè)新的。如果你傳 true攻擊者隨便訪(fǎng)問(wèn)一個(gè)受保護(hù)頁(yè)面就能讓服務(wù)器創(chuàng)建 Session浪費(fèi)內(nèi)存也不是好習(xí)慣。3.4 成績(jī)錄入與統(tǒng)計(jì)報(bào)表SQL 是系統(tǒng)的靈魂成績(jī)查詢(xún)是整個(gè)系統(tǒng)最花心思的部分。基本需求是按課程查詢(xún)成績(jī)單顯示學(xué)號(hào)、姓名、班級(jí)、成績(jī)。這個(gè)時(shí)候必須用 JOIN 而不是單表查詢(xún)?？催@條核心 SQLSELECT s.student_no, s.name, s.class_name, c.course_name, sc.score, sc.semester FROM t_score sc JOIN t_student s ON sc.student_id s.id JOIN t_course c ON sc.course_id c.id WHERE c.id ? ORDER BY sc.score DESC;這條 SQL 查出來(lái)的結(jié)果能直接映射到 JSP 表格里。在 ScoreQueryServlet 中執(zhí)行查詢(xún)遍歷 ResultSet 放到 List再 setAttribute 到 request 轉(zhuǎn)發(fā)給 JSPListMapString, Object list new ArrayList(); while (rs.next()) { MapString, Object row new HashMap(); row.put(student_no, rs.getString(student_no)); row.put(name, rs.getString(name)); row.put(class_name, rs.getString(class_name)); row.put(course_name, rs.getString(course_name)); row.put(score, rs.getBigDecimal(score)); row.put(semester, rs.getString(semester)); list.add(row); } request.setAttribute(scoreList, list);統(tǒng)計(jì)報(bào)表是課程設(shè)計(jì)的加分項(xiàng)。我用一條 GROUP BY SQL 算出分?jǐn)?shù)段分布SELECT SUM(CASE WHEN score 90 THEN 1 ELSE 0 END) AS excellent, SUM(CASE WHEN score 80 AND score 90 THEN 1 ELSE 0 END) AS good, SUM(CASE WHEN score 70 AND score 80 THEN 1 ELSE 0 END) AS medium, SUM(CASE WHEN score 60 AND score 70 THEN 1 ELSE 0 END) AS pass, SUM(CASE WHEN score 60 THEN 1 ELSE 0 END) AS fail, COUNT(*) AS total, ROUND(AVG(score), 2) AS avg_score, MAX(score) AS max_score, MIN(score) AS min_score FROM t_score WHERE course_id ?;CASE WHEN 配合 SUM 的寫(xiě)法是統(tǒng)計(jì)報(bào)表的經(jīng)典思路一行 SQL 就能算出所有分段數(shù)據(jù)不用在 Java 里循環(huán)判斷。ROUND 保留兩位小數(shù)讓平均分更美觀(guān)。這條 SQL 一寫(xiě)出來(lái)直接在答辯時(shí)演示老師一定認(rèn)可。3.5 成績(jī)錄入的冪等處理防止重復(fù)提交錄入成績(jī)時(shí)教師可能手快提交兩次或者同一學(xué)生被重復(fù)導(dǎo)入。前面我們?cè)诒斫Y(jié)構(gòu)上加了聯(lián)合唯一鍵 uk_student_course這里再用INSERT ... ON DUPLICATE KEY UPDATE來(lái)兜底INSERT INTO t_score (student_id, course_id, score, semester, exam_type) VALUES (?, ?, ?, ?, ?) ON DUPLICATE KEY UPDATE score VALUES(score);這句 SQL 的意思是如果唯一鍵student_id course_id semester exam_type已經(jīng)存在就更新成績(jī)不存在就插入。這樣極大簡(jiǎn)化了代碼邏輯不用先查一遍判斷是否已存在再?zèng)Q定 insert 還是 update。這個(gè)技巧在真實(shí)項(xiàng)目中非常常用值得記下來(lái)。4. 常見(jiàn)問(wèn)題與排查技巧實(shí)錄4.1 JSP 頁(yè)面中文亂碼十個(gè)人九個(gè)會(huì)遇到亂碼問(wèn)題的根源是編碼不統(tǒng)一。排查思路是順著“請(qǐng)求 → 響應(yīng) → 數(shù)據(jù)庫(kù)”三層逐一檢查。第一層JSP 頁(yè)面編碼。每個(gè) JSP 頂部要寫(xiě)% page contentTypetext/html;charsetUTF-8 languagejava %第二層Servlet 接收請(qǐng)求的編碼。在 doPost 方法第一行寫(xiě)request.setCharacterEncoding(UTF-8);第三層數(shù)據(jù)庫(kù)連接串前面已經(jīng)提到要帶characterEncodingutf8mb4。只要這三層統(tǒng)一成 UTF-8中文亂碼基本不會(huì)出現(xiàn)。如果你發(fā)現(xiàn) JSP 頁(yè)面顯示正常但插入數(shù)據(jù)庫(kù)后是問(wèn)號(hào)那一定是第三步?jīng)]配置好如果頁(yè)面本身出現(xiàn)亂碼那第一步或者第二步的優(yōu)先級(jí)搞反了。4.2 數(shù)據(jù)庫(kù)連接失敗時(shí)區(qū)、驅(qū)動(dòng)、jar 包三連坑數(shù)據(jù)庫(kù)連接失敗是最常見(jiàn)的啟動(dòng)錯(cuò)誤我把它整理成了一個(gè)排查清單錯(cuò)誤現(xiàn)象可能原因解決方法ClassNotFoundException驅(qū)動(dòng) jar 沒(méi)放進(jìn) WEB-INF/lib把 mysql-connector-java-x.x.xx.jar 放到 lib 目錄Access denied for user用戶(hù)名密碼錯(cuò)核對(duì) db.propertiesThe server time zone ... unrecognized連接串缺 serverTimezone加上 serverTimezoneAsia/ShanghaiCommunications link failureMySQL 沒(méi)啟動(dòng)或端口不對(duì)檢查 MySQL 服務(wù)狀態(tài)和 3306 端口檢查端口是否被占用可以用命令netstat -ano | findstr 3306Windows或者lsof -i:3306macOS/Linux。經(jīng)常有同學(xué) MySQL 服務(wù)沒(méi)啟動(dòng)就在啟動(dòng) Tomcat然后報(bào)一堆 Connection refused 的錯(cuò)先看服務(wù)再看代碼。4.3 IDEA 中 Web 項(xiàng)目部署報(bào) 404 或 500IDEA 里跑 Web 項(xiàng)目最煩的坑有兩個(gè)。第一個(gè)是 404。明明代碼沒(méi)錯(cuò)訪(fǎng)問(wèn)的是/admin/admin_home.jsp卻報(bào) 404。八成是 Artifact 配置不對(duì)——IDEA 的 Artifact 決定了哪些文件會(huì)被打進(jìn)部署包里。檢查 Project Structure → Artifacts確保Web Resource Directory指向項(xiàng)目的 web 目錄Output Layout里能看到 WEB-INF 和 JSP 文件。修改后一定要 Rebuild 再重啟 Tomcat。第二個(gè)是 500 的JasperException或者ClassNotFoundException。這種情況幾乎都是依賴(lài)缺失或者編譯輸出目錄不對(duì)。確認(rèn)Project Structure → Modules → Dependencies里是否有 MySQL 驅(qū)動(dòng) jar并且 Scope 選擇 Compile。JSP 是在 Tomcat 運(yùn)行時(shí)動(dòng)態(tài)編譯成 Servlet 的它需要能在 classpath 里找到你的 DAO 和 Entity 類(lèi)。4.4 成績(jī)查詢(xún)性能問(wèn)題幾千條數(shù)據(jù)也卡雖然系統(tǒng)數(shù)據(jù)量不大但我也遇到過(guò)查詢(xún)變慢的情況原因是 JSP 里嵌套了太多邏輯。舉個(gè)例子原本在 score_list.jsp 里為了顯示學(xué)生姓名每行都調(diào)用一次 StudentDao 查數(shù)據(jù)庫(kù)這就是經(jīng)典的 N1 查詢(xún)問(wèn)題——列表有 50 條成績(jī)就要額外執(zhí)行 50 次學(xué)生查詢(xún)。解決辦法是用 SQL 的 JOIN 一次性把關(guān)聯(lián)數(shù)據(jù)查出來(lái)而不是在 JSP 里反復(fù)查詢(xún)。這也是我前面堅(jiān)持用 JOIN SQL 的原因。JSP 里只負(fù)責(zé)遍歷展示絕不在標(biāo)簽內(nèi)寫(xiě) JDBC 代碼。你的 JSP 里如果出現(xiàn)了%加 Java 代碼做數(shù)據(jù)庫(kù)操作的痕跡就要注意了——這正是風(fēng)格老派且難維護(hù)的根源。4.5 JSP 導(dǎo)入類(lèi)失敗或語(yǔ)法高亮不正常有時(shí)候 IDEA 里 JSP 文件一片紅色導(dǎo)入的類(lèi)報(bào)錯(cuò)。這通常是項(xiàng)目沒(méi)有正確關(guān)聯(lián) Tomcat 和 JDK。檢查 Project Structure 里是否添加了項(xiàng)目的 SDK并且 Tomcat 的 library 是否引入。IDEA 設(shè)置里 JSP 語(yǔ)法高亮也可以手動(dòng)開(kāi)啟Settings → Editor → File Types → 確認(rèn).jsp文件被識(shí)別為 JSP/JSPX。5. 實(shí)操過(guò)程中的一些體會(huì)整個(gè)項(xiàng)目做完我自己最大的感受是這種“老技術(shù)?！钡南到y(tǒng)反而能幫你把基礎(chǔ)打得非常牢。寫(xiě) JSP Servlet 的過(guò)程你會(huì)被迫去思考 HTTP 協(xié)議的無(wú)狀態(tài)性、Session 的過(guò)期機(jī)制、JDBC 的資源管理、SQL 的 JOIN 和聚合函數(shù)——這些都是換了任何框架都繞不開(kāi)的知識(shí)點(diǎn)。我在做這個(gè)項(xiàng)目的時(shí)候最初也犯過(guò)“一張大表搞定所有字段”的錯(cuò)誤把學(xué)生、課程、成績(jī)?nèi)咳M(jìn)一張表結(jié)果查詢(xún)寫(xiě)起來(lái)非常痛苦。后來(lái)拆成五張表邏輯一下就清楚了。這也算是一個(gè)經(jīng)驗(yàn)數(shù)據(jù)庫(kù)設(shè)計(jì)一定先想清楚實(shí)體關(guān)系學(xué)生和課程是多對(duì)多中間要有一張關(guān)聯(lián)表而成績(jī)本身就可以作為關(guān)聯(lián)表的屬性存在。最后再分享一個(gè)小技巧在答辯或演示之前提前往數(shù)據(jù)庫(kù)里插入一批像樣的測(cè)試數(shù)據(jù)比如 20 個(gè)學(xué)生、5 門(mén)課、每條成績(jī)都有合理的分?jǐn)?shù)分布這樣統(tǒng)計(jì)報(bào)表的折線(xiàn)圖、柱狀圖如果做了可視化看起來(lái)才會(huì)漂亮。如果數(shù)據(jù)全是 100 分或者全是隨機(jī)數(shù)老師一眼就覺(jué)得是隨便填的。這個(gè)項(xiàng)目最大的價(jià)值不是那個(gè)“成績(jī)管理系統(tǒng)”本身而是它訓(xùn)練了你從需求分析、數(shù)據(jù)庫(kù)設(shè)計(jì)、編碼實(shí)現(xiàn)到故障排查的完整思維鏈條。本文還有配套的精品資源點(diǎn)擊獲取