簡(jiǎn)介這是一份基于SSMSpringSpringMVCMyBatis框架打造的健身俱樂(lè)部管理系統(tǒng)完整畢業(yè)設(shè)計(jì)項(xiàng)目適合計(jì)算機(jī)相關(guān)專(zhuān)業(yè)學(xué)生用于課程設(shè)計(jì)、畢業(yè)設(shè)計(jì)或項(xiàng)目實(shí)戰(zhàn)練手。系統(tǒng)涵蓋會(huì)員管理、課程預(yù)約、教練管理、收支記錄、新聞公告等典型業(yè)務(wù)模塊前端頁(yè)面配合大量CSS、JS與HTML文件后端由Java源碼與JSP頁(yè)面構(gòu)成附帶SQL數(shù)據(jù)庫(kù)文件可直接導(dǎo)入運(yùn)行并二次開(kāi)發(fā)。整個(gè)壓縮包共1036個(gè)文件包含259個(gè)CSS、179個(gè)JS、59個(gè)Java、34個(gè)JSP以及SQL腳本等資源總體約18.55MB代碼經(jīng)測(cè)試運(yùn)行正常結(jié)構(gòu)清晰便于快速理解SSM整合流程與業(yè)務(wù)邏輯。目前已有176人學(xué)習(xí)使用是一份經(jīng)過(guò)導(dǎo)師認(rèn)可、高分通過(guò)的項(xiàng)目資料下載后即可獲得完整源碼、數(shù)據(jù)庫(kù)文件及配套資源對(duì)完成畢設(shè)或提升框架實(shí)踐能力均有較高參考價(jià)值。1. 這個(gè) SSM 健身俱樂(lè)部系統(tǒng)壓縮包到底值不值得打開(kāi)解壓一個(gè)“基于SSM健身俱樂(lè)部管理系統(tǒng)源碼數(shù)據(jù)庫(kù)文件畢業(yè)設(shè)計(jì).zip”大部分人第一反應(yīng)是雙擊導(dǎo)入數(shù)據(jù)庫(kù)然后祈禱頁(yè)面能開(kāi)出來(lái)。這類(lèi)基于 SSM 的健身俱樂(lè)部管理系統(tǒng)在畢業(yè)設(shè)計(jì)里出現(xiàn)頻率相當(dāng)高核心價(jià)值不是代碼有多漂亮而是把會(huì)員辦卡、課程預(yù)約、教練排課、消費(fèi)記錄這些業(yè)務(wù)完整落在 MySQL 表里再用 JSP 頁(yè)面把流程串起來(lái)。和 Spring Boot 版比它少了很多自動(dòng)配置反而更適合拆開(kāi)講清楚請(qǐng)求怎么進(jìn) Controller、SQL 怎么映射、事務(wù)在哪一層生效。適合三類(lèi)人學(xué)期末需要一個(gè)能演示系統(tǒng)的學(xué)生、剛學(xué)完 SSM 想找一個(gè)不過(guò)度復(fù)雜全棧項(xiàng)目的開(kāi)發(fā)者、準(zhǔn)備面試前想梳理 Java Web 分層架構(gòu)的從業(yè)者。反直覺(jué)的地方在于這套系統(tǒng)最終能不能跑起來(lái)很大程度不取決于代碼而取決于數(shù)據(jù)庫(kù)文件能不能在五分鐘內(nèi)導(dǎo)進(jìn)你的 MySQL。2. 系統(tǒng)骨架SSM 三層與健身業(yè)務(wù)的模塊拆解2.1 SSM 三層在健身系統(tǒng)里怎么分工Spring 管的是 Service 層對(duì)象的創(chuàng)建和事務(wù)邊界SpringMVC 管的是瀏覽器請(qǐng)求到 Controller 再到 JSP 的流轉(zhuǎn)MyBatis 管的是 Mapper 接口和 SQL 之間的映射。三者各管一段出了問(wèn)題能很快定位到具體層頁(yè)面打不開(kāi)先看 SpringMVC 配置加了接口但查詢沒(méi)生效先看 MyBatis XML業(yè)務(wù)邏輯調(diào)不動(dòng)先看 Service 是否被 Spring 容器掃描到。這套健身俱樂(lè)部的業(yè)務(wù)模塊從頁(yè)面就能猜個(gè)大概管理員登錄、會(huì)員管理、卡類(lèi)型管理、教練管理、課程排課、預(yù)約上課、消費(fèi)記錄和統(tǒng)計(jì)報(bào)表。對(duì)應(yīng)到代碼里Controller 類(lèi)基本是按業(yè)務(wù)模塊拆的Service 接口和實(shí)現(xiàn)類(lèi)也跟著模塊走M(jìn)apper 則直接對(duì)應(yīng)數(shù)據(jù)庫(kù)表。如果你打開(kāi)源碼發(fā)現(xiàn) Controller 很薄、Service 很厚這是正常的分層反過(guò)來(lái)如果 Controller 里塞了一堆 SQL 拼接那這套代碼的維護(hù)性就要打個(gè)問(wèn)號(hào)。為什么這類(lèi)項(xiàng)目還在用 SSM 而不是 Spring Boot值得多說(shuō)一句。很多答辯老師會(huì)追問(wèn)“你這個(gè)事務(wù)注解為什么有效”“攔截器是誰(shuí)加載的”SSM 里這些東西都是顯式配置的能順著配置文件一步一步講出來(lái)。而 Spring Boot 把這些全自動(dòng)包好一旦登錄攔截不生效或者靜態(tài)資源 404新手往往連從哪查都不知道。所以對(duì)這個(gè)標(biāo)題的場(chǎng)景SSM 不是一個(gè)過(guò)時(shí)選擇而是一個(gè)適合講原理的框架組合。2.2 數(shù)據(jù)庫(kù)建了哪些表、表關(guān)系怎么掛打開(kāi)數(shù)據(jù)庫(kù)文件表數(shù)量一般在八張左右。常見(jiàn)的表有 admin 管理員表、member 會(huì)員表、card_type 卡類(lèi)型表、coach 教練表、course 課程表、reservation 預(yù)約表、charge_record 消費(fèi)記錄表、health_record 健康檔案表。表與表之間多數(shù)是邏輯外鍵也就是只保存關(guān)聯(lián)字段的 id不建物理外鍵約束。表名主要作用關(guān)鍵字段admin后臺(tái)管理員登錄username、passwordcard_type會(huì)員卡類(lèi)型與價(jià)格name、duration、pricemember會(huì)員基礎(chǔ)信息member_no、name、phone、card_type_idcoach教練信息name、phone、specializecourse課程與排課信息name、coach_id、start_time、capacityreservation會(huì)員預(yù)約記錄member_id、course_id、statuscharge_record消費(fèi)流水member_id、amount、typehealth_record會(huì)員健康數(shù)據(jù)member_id、height、weight、bmi以 member 表為例這類(lèi)系統(tǒng)里通常有會(huì)員編號(hào)、姓名、手機(jī)號(hào)、關(guān)聯(lián)的卡類(lèi)型 id、余額和狀態(tài)字段。建表語(yǔ)句大致是下面這個(gè)樣子具體字段名以你解壓出來(lái)的 SQL 文件為準(zhǔn)CREATE TABLE member ( id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT, member_no VARCHAR(32) NOT NULL COMMENT 會(huì)員編號(hào), name VARCHAR(64) NOT NULL COMMENT 姓名, phone VARCHAR(20) DEFAULT NULL COMMENT 手機(jī)號(hào), card_type_id INT DEFAULT NULL COMMENT 關(guān)聯(lián) card_type.id, balance DECIMAL(10,2) DEFAULT 0.00 COMMENT 余額, status TINYINT DEFAULT 1 COMMENT 1正常 0停用, create_time DATETIME DEFAULT NULL COMMENT 注冊(cè)時(shí)間, PRIMARY KEY (id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;這里card_type_id就是邏輯外鍵它指向 card_type 表的id。查詢會(huì)員列表時(shí)通過(guò) JOIN 把卡類(lèi)型名稱(chēng)帶出來(lái)而不需要數(shù)據(jù)庫(kù)層面強(qiáng)制約束。balance用 DECIMAL 而不是 FLOAT是為了避免金額精度問(wèn)題。create_time用于列表排序也方便后面做“本月新增會(huì)員”這類(lèi)統(tǒng)計(jì)。2.3 外鍵到底要不要建為什么數(shù)據(jù)庫(kù)文件里往往不建剛接觸數(shù)據(jù)庫(kù)的人看到表關(guān)聯(lián)第一反應(yīng)是加 FOREIGN KEY但這類(lèi)畢業(yè)設(shè)計(jì)數(shù)據(jù)庫(kù)文件里通常都不建物理外鍵。原因很直接后臺(tái)管理需要頻繁刪除測(cè)試數(shù)據(jù)物理外鍵會(huì)擋住刪除操作。比如要清掉一個(gè)誤錄入的會(huì)員如果預(yù)約表里有他的記錄物理外鍵會(huì)直接報(bào)錯(cuò)導(dǎo)致刪不掉。邏輯外鍵則沒(méi)有這個(gè)限制刪除前在 Service 里手動(dòng)判斷關(guān)聯(lián)數(shù)據(jù)即可。這個(gè)設(shè)計(jì)對(duì)答辯也很友好。被問(wèn)到“如何保證數(shù)據(jù)一致性”時(shí)你能回答“在 Service 層通過(guò)事務(wù)和業(yè)務(wù)校驗(yàn)來(lái)控制”比單純說(shuō)“數(shù)據(jù)庫(kù)有外鍵”更有說(shuō)服力。如果你接手后想加物理外鍵我的建議是只在reservation表的member_id、course_id上加其他表保持現(xiàn)狀因?yàn)轭A(yù)約是關(guān)聯(lián)最緊密的業(yè)務(wù)加物理外鍵能防止明顯臟數(shù)據(jù)。拿到數(shù)據(jù)庫(kù)文件后第一步不是寫(xiě)代碼而是把表關(guān)系畫(huà)出來(lái)。畫(huà)清楚之后你自然知道會(huì)員模塊會(huì)查哪幾張表、預(yù)約模塊會(huì)寫(xiě)哪幾張表再看源碼時(shí)就不會(huì)一頭扎進(jìn)細(xì)節(jié)里。3. 從 zip 到能跑環(huán)境匹配、數(shù)據(jù)庫(kù)導(dǎo)入與啟動(dòng)3.1 環(huán)境預(yù)檢JDK、Maven、Tomcat、MySQL 的匹配關(guān)系這類(lèi) SSM 項(xiàng)目最怕的環(huán)境組合是“新版 JDK 老版本 Spring”。源碼里 pom.xml 的編譯級(jí)別如果是 1.8而你本機(jī)只裝了 JDK 17編譯階段通常會(huì)報(bào)錯(cuò)或者項(xiàng)目能編譯但 Tomcat 啟動(dòng)時(shí)反射調(diào)用失敗。我一般先做一次環(huán)境預(yù)檢再碰代碼環(huán)境項(xiàng)建議版本注意點(diǎn)JDK1.8老項(xiàng)目兼容性最好1.8 是 SSM 最穩(wěn)的底座Maven3.6 及以上用來(lái)拉依賴和打包Tomcat8.5 或 9.0與 JDK 8 配套避免用 Tomcat 10MySQL5.7 或 8.0注意數(shù)據(jù)庫(kù)驅(qū)動(dòng)類(lèi)名差異IDEA 版本任意較新版本即可不需要強(qiáng)行用舊版Tomcat 10 要特別注意它把javax.*換成了jakarta.*老 SSM 項(xiàng)目的源碼里全是javax.servlet直接扔進(jìn) Tomcat 10 會(huì)報(bào)類(lèi)找不到。如果機(jī)器上只有一個(gè) Tomcat 10別硬調(diào)換 8.5 最省事。MySQL 這邊5.7 用com.mysql.jdbc.Driver8.0 推薦com.mysql.cj.jdbc.Driver這個(gè)差異會(huì)在后文配置里展開(kāi)。3.2 源碼導(dǎo)入與 Maven 依賴補(bǔ)齊先別改版本號(hào)打開(kāi) IDEA選 Open 定位到解壓目錄找到 pom.xml 以 Maven 項(xiàng)目導(dǎo)入。導(dǎo)入后第一件事不是寫(xiě)代碼而是先讓 Maven 把依賴?yán)?。打開(kāi) pom.xml定位到 dependencies 區(qū)域確認(rèn)以下幾個(gè)核心坐標(biāo)都在版本號(hào)以源碼里原有的為準(zhǔn)第一次運(yùn)行不要?jiǎng)觗ependencies !-- Spring MVC 與 Spring 核心 -- dependency groupIdorg.springframework/groupId artifactIdspring-webmvc/artifactId version${spring.version}/version /dependency !-- MyBatis 與 Spring 整合包 -- dependency groupIdorg.mybatis/groupId artifactIdmybatis/artifactId version${mybatis.version}/version /dependency dependency groupIdorg.mybatis/groupId artifactIdmybatis-spring/artifactId version${mybatis.spring.version}/version /dependency !-- MySQL 驅(qū)動(dòng) -- dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId version${mysql.version}/version /dependency /dependencies${spring.version}這類(lèi)占位符在源碼里通常已經(jīng)被作者填成了具體版本號(hào)第一次拉取時(shí)直接沿用。如果某個(gè)依賴?yán)∈?yōu)先檢查本地 Maven 倉(cāng)庫(kù)路徑是否配置正確而不是急著換版本號(hào)。依賴?yán)笤陧?xiàng)目根目錄執(zhí)行一次構(gòu)建mvn clean package -DskipTests這個(gè)命令做了兩件事clean清掉上次構(gòu)建的 target 目錄package把項(xiàng)目打成一個(gè) war 包。-DskipTests跳過(guò)單元測(cè)試避免因?yàn)槟硞€(gè)測(cè)試類(lèi)環(huán)境不兼容導(dǎo)致構(gòu)建中斷。如果這一步不報(bào)錯(cuò)說(shuō)明源碼工程本身是完整的問(wèn)題大概率出在后面的數(shù)據(jù)庫(kù)環(huán)節(jié)。3.3 數(shù)據(jù)庫(kù)文件導(dǎo)入與 jdbc 配置字符集和時(shí)區(qū)一次到位打開(kāi)數(shù)據(jù)庫(kù)文件先看 SQL 文件頭部確認(rèn)有沒(méi)有CREATE DATABASE。大多數(shù)畢業(yè)設(shè)計(jì) SQL 文件只包含建表和插入數(shù)據(jù)語(yǔ)句需要你手動(dòng)建庫(kù)。命令行導(dǎo)入比圖形化工具更穩(wěn)它能繞開(kāi)圖形工具對(duì)字符集的猜測(cè)mysql -uroot -p -e CREATE DATABASE IF NOT EXISTS gym DEFAULT CHARACTER SET utf8mb4; mysql --default-character-setutf8mb4 -uroot -p gym 數(shù)據(jù)庫(kù)文件.sql第一行先建庫(kù)明確指定utf8mb4第二行把 SQL 文件導(dǎo)入這個(gè)庫(kù)。--default-character-setutf8mb4讓客戶端以 utf8mb4 編碼發(fā)送語(yǔ)句避免中文字符在導(dǎo)入時(shí)變亂碼。如果直接用 Navicat 拖拽導(dǎo)入遇到報(bào)錯(cuò) 1366 或者 1067原因基本都是字符集不匹配命令行方式能解決大部分問(wèn)題。數(shù)據(jù)庫(kù)導(dǎo)好之后找到源碼里的 jdbc 配置文件一般是jdbc.properties或db.properties把連接地址、賬號(hào)、密碼改成你本機(jī)的jdbc.drivercom.mysql.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/gym?useUnicodetruecharacterEncodingutf8useSSLfalseserverTimezoneAsia/Shanghai jdbc.usernameroot jdbc.password你的數(shù)據(jù)庫(kù)密碼useUnicodetruecharacterEncodingutf8保證 Java 程序和 MySQL 之間傳輸中文不亂碼serverTimezoneAsia/Shanghai解決 MySQL 8.0 時(shí)區(qū)報(bào)錯(cuò)useSSLfalse避免本機(jī)連接時(shí)輸出大量 SSL 告警日志。如果數(shù)據(jù)庫(kù)是 MySQL 8.0把 driver 換成com.mysql.cj.jdbc.Driver其他不變。3.4 在 IDEA 里把 Tomcat 跑起來(lái)訪問(wèn)路徑與首次登錄配置 Tomcat 時(shí)我習(xí)慣先把源碼自帶的 war exploded 部署方式調(diào)整好。操作路徑是Run - Edit Configurations - 左上角加號(hào) - Tomcat Server - Local在 Deployment 欄添加該項(xiàng)目Application context 填/gym。這里的/gym就是訪問(wèn)路徑的前綴和數(shù)據(jù)庫(kù)名沒(méi)有必然關(guān)系但你最好讓它們保持一致避免自己都記混。啟動(dòng) Tomcat控制臺(tái)出現(xiàn)Connected to server且沒(méi)有異常堆棧瀏覽器訪問(wèn)http://localhost:8080/gym能看到登錄頁(yè)說(shuō)明 SpringMVC 和視圖解析已經(jīng)工作。接下來(lái)登錄后臺(tái)打開(kāi) admin 表看初始賬號(hào)和密碼。密碼字段可能是明文也可能是 MD5 加密后的字符串。如果登錄時(shí)提示密碼錯(cuò)誤先用 SQL 把密碼改成明文測(cè)試確認(rèn)賬號(hào)能通之后再考慮加密問(wèn)題UPDATE admin SET password 123456 WHERE username admin;改完刷新頁(yè)面重新登錄。這一步能過(guò)濾掉很多不必要的“系統(tǒng)壞了”的錯(cuò)覺(jué)——實(shí)際上只是密碼字段格式問(wèn)題。4. 核心邏輯實(shí)現(xiàn)分頁(yè)查詢、預(yù)約防沖突與登錄攔截4.1 會(huì)員分頁(yè)查詢MyBatis 動(dòng)態(tài) SQL 和 LIMIT 參數(shù)會(huì)員列表是健身系統(tǒng)的標(biāo)配功能數(shù)據(jù)量少的時(shí)候一次性查出來(lái)沒(méi)問(wèn)題但后臺(tái)管理通常要做搜索和分頁(yè)。源碼里常見(jiàn)的實(shí)現(xiàn)是 Mapper 接口配 XML分頁(yè)參數(shù)直接傳給 SQL不額外引入 PageHelper 依賴。這樣二開(kāi)時(shí)少一個(gè)插件需要理解答辯時(shí)也更容易解釋清楚。先看 Mapper 接口定義兩個(gè)方法一個(gè)查當(dāng)前頁(yè)數(shù)據(jù)一個(gè)查總數(shù)public interface MemberMapper { ListMember selectPage(Param(keyword) String keyword, Param(offset) int offset, Param(limit) int limit); int count(Param(keyword) String keyword); }注意Param(offset)和Param(limit)這兩個(gè)參數(shù)的作用是告訴 MyBatisXML 里的#{offset}和#{limit}對(duì)應(yīng)哪個(gè) Java 參數(shù)。不寫(xiě)Param時(shí)如果方法只有一個(gè)參數(shù)MyBatis 可以用#{value}或#{任意名}但多參數(shù)時(shí)必須顯式命名否則啟動(dòng)就會(huì)報(bào) BindingException。對(duì)應(yīng)的 XML 是這個(gè)模塊的重點(diǎn)select idselectPage resultTypecom.gym.entity.Member SELECT id, member_no, name, phone, card_type_id, balance, create_time FROM member where if testkeyword ! null and keyword ! member_no LIKE CONCAT(%, #{keyword}, %) OR name LIKE CONCAT(%, #{keyword}, %) OR phone LIKE CONCAT(%, #{keyword}, %) /if /where ORDER BY create_time DESC LIMIT #{offset}, #{limit} /selectwhere標(biāo)簽會(huì)自動(dòng)處理掉多余的前綴比如當(dāng) keyword 為空時(shí)整個(gè)條件塊不生成SQL 就變成普通查全表。LIKE CONCAT(%, #{keyword}, %)比直接寫(xiě)LIKE %${keyword}%安全后者使用${}做字符串拼接存在 SQL 注入風(fēng)險(xiǎn)#{}是預(yù)編譯參數(shù)這個(gè)習(xí)慣要在二開(kāi)時(shí)保持。LIMIT #{offset}, #{limit}是 MySQL 的分頁(yè)寫(xiě)法offset 是起始下標(biāo)limit 是每頁(yè)條數(shù)在 Service 層計(jì)算偏移量時(shí)一般用(當(dāng)前頁(yè)-1) * 每頁(yè)條數(shù)。查詢總數(shù)的方法也要同步實(shí)現(xiàn)前端分頁(yè)組件需要總條數(shù)來(lái)計(jì)算總頁(yè)數(shù)。如果發(fā)現(xiàn)頁(yè)面底部翻頁(yè)數(shù)據(jù)不對(duì)優(yōu)先排查count方法的查詢條件是否和selectPage一致。這是很常見(jiàn)的翻車(chē)點(diǎn)列表頁(yè)只查了第 1 頁(yè)但總數(shù)統(tǒng)計(jì)的是全表翻到第 2 頁(yè)就“沒(méi)有數(shù)據(jù)”。4.2 預(yù)約不超賣(mài)、不重復(fù)Service 層事務(wù)里的三次判斷預(yù)約課程是健身系統(tǒng)里最容易出邏輯問(wèn)題的模塊。同一節(jié)課容量假如是 20 人兩個(gè)會(huì)員同時(shí)點(diǎn)了預(yù)約數(shù)據(jù)庫(kù)層面如果不做判斷可能就插進(jìn)去 21 條記錄。畢業(yè)設(shè)計(jì)源碼里一般會(huì)在這個(gè)方法上標(biāo)注Transactional然后在事務(wù)里做容量校驗(yàn)、重復(fù)校驗(yàn)、插入預(yù)約順序不能亂。Service Transactional public class ReservationService { Autowired private CourseMapper courseMapper; Autowired private ReservationMapper reservationMapper; public String reserve(Integer memberId, Integer courseId) { Course course courseMapper.selectById(courseId); if (course null || course.getCapacity() 0) { return 課程不存在或已下架; } Integer joined reservationMapper.countByCourseId(courseId); if (joined course.getCapacity()) { return 該節(jié)課已約滿; } int exists reservationMapper.countByMemberAndCourse(memberId, courseId); if (exists 0) { return 請(qǐng)勿重復(fù)預(yù)約; } reservationMapper.insert(new Reservation(memberId, courseId, new Date(), 已預(yù)約)); return 預(yù)約成功; } }方法上的Transactional讓這三個(gè)操作在同一個(gè)數(shù)據(jù)庫(kù)事務(wù)里執(zhí)行中間任何一個(gè)環(huán)節(jié)拋出運(yùn)行時(shí)異常前面插入的數(shù)據(jù)全部回滾。countByCourseId判斷已預(yù)約人數(shù)countByMemberAndCourse判斷當(dāng)前會(huì)員是否已經(jīng)約過(guò)這節(jié)課兩個(gè)判斷順序不能反先查課程容量再查個(gè)人重復(fù)能讓用戶最早知道“約滿了”而不是“不能重復(fù)約”。這個(gè)實(shí)現(xiàn)有一個(gè)邊界在高并發(fā)場(chǎng)景下兩個(gè)請(qǐng)求同時(shí)讀到 joined 為 19 時(shí)仍然可能都通過(guò)校驗(yàn)。畢業(yè)設(shè)計(jì)演示時(shí)基本不會(huì)遇到這種并發(fā)但如果被問(wèn)到了你可以說(shuō)明這是基于數(shù)據(jù)庫(kù)行鎖的一種簡(jiǎn)化方案真實(shí)線上會(huì)在課程表加樂(lè)觀鎖版本號(hào)或者使用唯一索引約束。能回答到這里答辯這一關(guān)通常就過(guò)了。4.3 登錄攔截器與靜態(tài)資源放行后臺(tái)頁(yè)面不能直接訪問(wèn)源碼里一般通過(guò) SpringMVC 攔截器實(shí)現(xiàn)。登錄后把管理員信息放進(jìn) session攔截器檢查 session 里有沒(méi)有指定 key沒(méi)有就跳回登錄頁(yè)。核心代碼大致這樣public class LoginInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { if (request.getSession().getAttribute(loginAdmin) null) { response.sendRedirect(request.getContextPath() /login); return false; } return true; } }request.getSession().getAttribute(loginAdmin)里的loginAdmin是登錄成功后存入 session 的 key。response.sendRedirect不能寫(xiě)死/login要拼上request.getContextPath()否則部署到服務(wù)器的非根路徑時(shí)跳轉(zhuǎn)會(huì) 404。return false表示請(qǐng)求被攔截不再往下執(zhí)行return true放行。攔截器需要在 spring-mvc 的配置文件里注冊(cè)并且一定要放行登錄頁(yè)和靜態(tài)資源。常見(jiàn)的錯(cuò)誤是只配置了攔截路徑?jīng)]加排除路徑結(jié)果登錄頁(yè)本身被攔截形成死循環(huán)或者頁(yè)面能打開(kāi)但 CSS、JS 全丟mvc:resources mapping/static/** location/static// mvc:default-servlet-handler/ mvc:interceptors mvc:interceptor mvc:mapping path/**/ mvc:exclude-mapping path/login/ mvc:exclude-mapping path/static/**/ bean classcom.gym.interceptor.LoginInterceptor/ /mvc:interceptor /mvc:interceptorsmvc:mapping path/**/表示攔截所有請(qǐng)求exclude-mapping把/login和/static/**排除在外。登錄接口如果走的是/login就不會(huì)被攔靜態(tài)資源放在 static 目錄下也正常加載。注意 session 的 key 字符串必須與登錄 Controller 里寫(xiě)入時(shí)完全一致大小寫(xiě)都不能差否則會(huì)出現(xiàn)“登錄成功但馬上被踢回登錄頁(yè)”的詭異現(xiàn)象。5. 避坑排查從導(dǎo)入數(shù)據(jù)庫(kù)到部署上線的 5 類(lèi)故障5.1 數(shù)據(jù)庫(kù)導(dǎo)入報(bào) 1366 / 1067要么亂碼要么斷在半路現(xiàn)象用 Navicat 或直接復(fù)制 SQL 內(nèi)容執(zhí)行導(dǎo)入到一半報(bào)錯(cuò)錯(cuò)誤碼 1366 或 1067表格里出現(xiàn)大量問(wèn)號(hào)。原因SQL 文件里的中文字符和客戶端連接字符集不一致數(shù)據(jù)庫(kù)表本身也可能是 UTF8但客戶端以 latin1 發(fā)送了語(yǔ)句。解決用命令行導(dǎo)入并顯式指定字符集。先看 SQL 文件頭部有沒(méi)有CHARSET聲明如果表是utf8mb4就用--default-character-setutf8mb4如果表是utf8則換成 utf8。重新導(dǎo)入前先刪掉剛才建的分庫(kù)避免半成品表殘留影響后續(xù)。5.2 Tomcat 啟動(dòng)報(bào)缺 ContextLoaderListener現(xiàn)象Tomcat 啟動(dòng)后拋出ClassNotFoundException: org.springframework.web.context.ContextLoaderListener或者是NoClassDefFoundError。原因spring-web 等相關(guān) jar 沒(méi)有進(jìn)入 WEB-INF/lib。在 IDEA 里直接運(yùn)行 Tomcat 時(shí)Artifacts 輸出沒(méi)有包含 Maven 依賴或者項(xiàng)目本身沒(méi)有以 war 方式打包。解決先確認(rèn) pom.xml 的packagingwar/packaging沒(méi)寫(xiě)錯(cuò)然后重新執(zhí)行一遍mvn clean package再檢查 IDEA 的 Artifacts 配置看 Output Layout 里是否包含lib目錄。最簡(jiǎn)單可靠的驗(yàn)證方式是啟動(dòng)前直接刪除項(xiàng)目 target 目錄重建很多時(shí)候是舊文件緩存導(dǎo)致。5.3 全站中文亂碼四個(gè)地方的編碼必須一致現(xiàn)象頁(yè)面部分中文正常、部分亂碼數(shù)據(jù)庫(kù)里的記錄也可能是亂碼。原因編碼問(wèn)題至少要檢查四個(gè)地方JSP 頁(yè)面聲明的編碼、Tomcat 的 URI 編碼、數(shù)據(jù)庫(kù)連接串里的 characterEncoding、MySQL 表自身的字符集。四處不一致就會(huì)在某一環(huán)出亂碼。解決JSP 第一行寫(xiě)% page contentTypetext/html; charsetUTF-8 %Tomcat 的 server.xml 里給 Connector 加上URIEncodingUTF-8連接串保留characterEncodingutf8表結(jié)構(gòu)統(tǒng)一用 utf8mb4。改完重啟 Tomcat并重新導(dǎo)入一份干凈數(shù)據(jù)再驗(yàn)證。5.4 驗(yàn)證碼不顯示、CSS 全丟靜態(tài)資源被攔截現(xiàn)象登錄頁(yè)能打開(kāi)但驗(yàn)證碼圖片無(wú)法顯示點(diǎn)登錄后頁(yè)面沒(méi)有任何樣式整體像沒(méi)有排版。原因DispatcherServlet 映射了/把所有請(qǐng)求都當(dāng)成 Controller 來(lái)處理靜態(tài)資源和驗(yàn)證碼圖片請(qǐng)求被攔截返回了錯(cuò)誤內(nèi)容。解決在 spring-mvc.xml 里加mvc:default-servlet-handler/和靜態(tài)資源映射并把/static/**加到登錄攔截器的排除列表里。改完清瀏覽器緩存強(qiáng)制刷新再看。注意mvc:default-servlet-handler/要放在攔截器配置之前。5.5 換到外置 Tomcat 或服務(wù)器后 404 或沒(méi)樣式現(xiàn)象本地 IDEA 里一切正常把 war 包丟到外置 Tomcat 的 webapps 目錄后頁(yè)面能打開(kāi)但樣式圖片全丟或者點(diǎn)擊菜單跳 404。原因頁(yè)面里用了寫(xiě)死的路徑比如href/static/css/style.css本地 Debug 時(shí)上下文根正好是/或/gym之一換到外置 Tomcat 后war 包名決定上下文根寫(xiě)死的路徑就找不到了。解決所有靜態(tài)資源引用統(tǒng)一改成基于上下文根的動(dòng)態(tài)拼接JSP 里用${pageContext.request.contextPath}拼路徑。部署時(shí)也盡量避免用 ROOT.war保持和你本地相同的上下文根名能少踩很多坑。6. 驗(yàn)收與進(jìn)階拿到源碼后先驗(yàn)證什么、再加什么6.1 5 分鐘驗(yàn)收流程換環(huán)境重跑一遍拿到這套系統(tǒng)后我先不急著讀業(yè)務(wù)代碼而是做一次“換環(huán)境驗(yàn)證”把數(shù)據(jù)庫(kù)文件導(dǎo)入另一個(gè) MySQL 實(shí)例把源碼放到另一個(gè)目錄用全新的本地倉(cāng)庫(kù)重新拉依賴并啟動(dòng)。能完整跑通說(shuō)明這套源碼的邊界條件比較干凈如果中途報(bào)錯(cuò)那報(bào)錯(cuò)位置就是你需要優(yōu)先理解的代碼區(qū)域。第二步驗(yàn)證表關(guān)系能閉環(huán)。在數(shù)據(jù)庫(kù)里手動(dòng)查一條預(yù)約記錄反查會(huì)員和課程確認(rèn)三張表能通過(guò) id 串起來(lái)。再在后臺(tái)新增一個(gè)會(huì)員、預(yù)約一節(jié)課、查看消費(fèi)記錄看頁(yè)面里哪些數(shù)據(jù)是實(shí)時(shí)讀庫(kù)的哪些是寫(xiě)死在 JSP 里的。這個(gè)動(dòng)作能幫你快速判斷這套系統(tǒng)的完成度而不是被頁(yè)面效果欺騙。第三步重啟 Tomcat 后看登錄態(tài)還在不在。如果 session 還在說(shuō)明登錄邏輯正常如果直接被踢回登錄頁(yè)也可能是 session 配置的問(wèn)題順便也能排除一些安全邊界。6.2 低成本二開(kāi)示例給系統(tǒng)加一個(gè)到店統(tǒng)計(jì)定時(shí)任務(wù)源碼跑通后想加一個(gè)有亮點(diǎn)的功能我建議從“統(tǒng)計(jì)報(bào)表”入手因?yàn)閿?shù)據(jù)庫(kù)里已經(jīng)有預(yù)約和消費(fèi)記錄不需要新表。用 Spring 自帶定時(shí)任務(wù)在 Service 里加一個(gè)方法統(tǒng)計(jì)當(dāng)天已開(kāi)始的課程數(shù)和總預(yù)約人數(shù)。配置類(lèi)開(kāi)啟EnableScheduling方法上標(biāo)注Scheduled(cron 0 0 9 * * ?)每天早上九點(diǎn)跑一次把結(jié)果寫(xiě)入一張統(tǒng)計(jì)表或日志文件。這個(gè)功能成本低但能體現(xiàn)你對(duì) Spring 容器、MyBatis 查詢、業(yè)務(wù)聚合的理解。加之前先確認(rèn)源碼里的 Spring 版本支持注解定時(shí)任務(wù)SSM 項(xiàng)目一般用 4.3 以上版本問(wèn)題不大。最后說(shuō)個(gè)習(xí)慣我從不在拿到源碼的第一天改業(yè)務(wù)邏輯都是先把數(shù)據(jù)庫(kù)導(dǎo)入、把系統(tǒng)完整跑一遍、再畫(huà)一張表關(guān)系圖。這三步走完代碼在你眼里就是透明的剩下的坑都有排查方向。希望幫到你。本文還有配套的精品資源點(diǎn)擊獲取