簡(jiǎn)介這是一個(gè)基于JSP技術(shù)的視頻教學(xué)管理系統(tǒng)畢業(yè)設(shè)計(jì)源碼包適用于計(jì)算機(jī)相關(guān)專業(yè)學(xué)生完成課程設(shè)計(jì)或畢業(yè)設(shè)計(jì)也適合Java Web初學(xué)者通過(guò)完整項(xiàng)目提升實(shí)戰(zhàn)能力。系統(tǒng)采用B/S結(jié)構(gòu)后臺(tái)使用MySQL數(shù)據(jù)庫(kù)主要實(shí)現(xiàn)管理員和用戶兩級(jí)角色涵蓋視頻分類、視頻教程管理、視頻購(gòu)買、視頻評(píng)價(jià)、視頻共享、論壇交流、系統(tǒng)公告、個(gè)人中心等功能模塊構(gòu)成一個(gè)相對(duì)完整的在線教學(xué)平臺(tái)。壓縮包共1388個(gè)文件總大小約38.78MB其中包含大量JSP頁(yè)面、Java業(yè)務(wù)類、CSS樣式、JavaScript腳本、圖片資源以及SQL初始化腳本同時(shí)附有Eclipse工程配置文件如.classpath、project等可導(dǎo)入開發(fā)環(huán)境后直接運(yùn)行和調(diào)試。目前已有87人學(xué)習(xí)瀏覽。整套源碼可直接作為畢業(yè)設(shè)計(jì)作品提交也可用于二次開發(fā)通過(guò)學(xué)習(xí)該項(xiàng)目能夠掌握J(rèn)SP動(dòng)態(tài)網(wǎng)頁(yè)開發(fā)、MySQL數(shù)據(jù)操作、前后端交互以及Bootstrap、Layui等前端框架的實(shí)際應(yīng)用對(duì)提升Web開發(fā)能力有明顯幫助。1. 這個(gè) zip 是套什么項(xiàng)目很多第一次拿到視頻教學(xué)管理系統(tǒng)源碼包的人第一反應(yīng)是把它當(dāng)成一個(gè)只能跑通的畢業(yè)設(shè)計(jì)樣板。其實(shí)剝開來(lái)看它就是一套標(biāo)準(zhǔn)的 SSM 三層架構(gòu)應(yīng)用Spring 管業(yè)務(wù)對(duì)象SpringMVC 管請(qǐng)求路由和視圖渲染MyBatis 管數(shù)據(jù)庫(kù)交互。視頻教學(xué)這個(gè)業(yè)務(wù)形態(tài)決定了它腳下踩著幾個(gè)固定模塊用戶注冊(cè)登錄、課程分類、視頻上傳、在線播放、學(xué)習(xí)進(jìn)度記錄。這套系統(tǒng)解決的是“怎么把一個(gè)帶數(shù)據(jù)庫(kù)的 Java Web 項(xiàng)目在本地完整跑起來(lái)再按自己的需求二次開發(fā)”這件事。你要是剛學(xué)完 SSM 想找個(gè)完整項(xiàng)目練手或者要給校內(nèi)培訓(xùn)做一個(gè)簡(jiǎn)易點(diǎn)播平臺(tái)花一個(gè)下午把這套代碼讀通、跑通比看十篇零散教程都值。這篇筆記會(huì)把你拿到 zip 包之后會(huì)遇到的問(wèn)題全部過(guò)一遍工具版本選什么、數(shù)據(jù)庫(kù)腳本怎么導(dǎo)、上傳視頻時(shí)路徑為什么總是失效、播放器放在哪個(gè)目錄以及幾個(gè)最經(jīng)典的報(bào)錯(cuò)怎么解。我在自己電腦上重復(fù)這套流程不止十次有些問(wèn)題屬于隔幾天必犯一次的類型血淚經(jīng)驗(yàn)都寫在后面。2. 技術(shù)棧和功能拆解SSM 視頻教學(xué)系統(tǒng)的完整模塊2.1 SSM 架構(gòu)為什么放在這個(gè)項(xiàng)目里依然能打雖然 Spring Boot 已經(jīng)成了新項(xiàng)目的默認(rèn)選擇但這類視頻教學(xué)系統(tǒng)用 SSM 手工搭建反而更適合作為學(xué)習(xí)對(duì)象。原因是 Spring Boot 把自動(dòng)配置和約定大于配置做到極致新手很難理解 bean 是怎么被掃描進(jìn)去的、請(qǐng)求是怎么被 DispatcherServlet 轉(zhuǎn)發(fā)的而 SSM 里這些鏈路都是顯式的web.xml 里寫清楚了 Servlet 和監(jiān)聽器Spring 配置文件里列了掃描包、數(shù)據(jù)源、事務(wù)管理器MyBatis 的 Mapper 接口和 XML 一一對(duì)應(yīng)。你打開任何一個(gè) Service 實(shí)現(xiàn)類能直接看到事務(wù)注解長(zhǎng)什么樣也能在配置里找到事務(wù)管理器。實(shí)用層面這套系統(tǒng)要處理的核心資源是視頻文件。視頻文件不適合放數(shù)據(jù)庫(kù)它通常落盤在某個(gè)目錄再通過(guò) Web 容器的靜態(tài)資源映射對(duì)外提供訪問(wèn)。所以架構(gòu)里有三個(gè)環(huán)節(jié)不能省一個(gè)能接收 multipart 上傳的 Controller、一個(gè)獨(dú)立于程序之外的上傳目錄、一個(gè)把磁盤路徑映射成 URL 的靜態(tài)資源處理器。SpringMVC 的 ResourceHandler 在這里承擔(dān)主要任務(wù)后面章節(jié)提到的 404 問(wèn)題也大多出在這一層。常見做法是在 spring-mvc.xml 里加一段資源映射指向本地磁盤的某個(gè)目錄mvc:resources mapping/upload/** locationfile:D:/upload/ /也有人圖省事把視頻傳到項(xiàng)目根目錄下的 upload 文件夾不配虛擬路徑。那種做法在小規(guī)模 Demo 里沒(méi)問(wèn)題但一旦打成 war 包部署路徑會(huì)隨著容器解壓目錄變化而失效折騰一圈最后還是回到虛擬路徑映射方案。所以建議直接按上面的寫法來(lái)。2.2 功能模塊劃分用戶端和管理端各做什么把功能清單拆開看這套頁(yè)面大致分成前臺(tái)和后臺(tái)兩塊端角色核心功能前臺(tái)用戶端普通用戶注冊(cè)、登錄、個(gè)人資料、按分類瀏覽課程、視頻播放、學(xué)習(xí)進(jìn)度記錄后臺(tái)管理端管理員登錄、分類維護(hù)、視頻上傳與上下架、用戶管理、基礎(chǔ)數(shù)據(jù)統(tǒng)計(jì)這兩個(gè)角色對(duì)應(yīng)數(shù)據(jù)庫(kù)里的不同權(quán)限字段最常見的設(shè)計(jì)是在用戶表里加一個(gè) role 字段1 表示管理員0 表示普通用戶。SpringMVC 攔截器根據(jù)這個(gè)字段攔截后臺(tái)請(qǐng)求普通用戶訪問(wèn) admin 開頭的路徑直接跳回登錄頁(yè)。這套權(quán)限模型簡(jiǎn)單但對(duì)教學(xué)管理場(chǎng)景已經(jīng)夠用不需要引入復(fù)雜的權(quán)限框架。這里有個(gè)容易忽略的產(chǎn)品細(xì)節(jié)視頻教學(xué)系統(tǒng)不能只做視頻列表還得記錄用戶看到哪一集、學(xué)到哪一分鐘。數(shù)據(jù)表需要設(shè)計(jì)一張學(xué)習(xí)記錄表把用戶 id、視頻 id、已看時(shí)長(zhǎng)、最后更新時(shí)間存下來(lái)。后面代碼部分會(huì)寫一個(gè)進(jìn)度回傳接口這個(gè)功能是前端播放器配合后端接口實(shí)現(xiàn)的不需要在數(shù)據(jù)庫(kù)層面做復(fù)雜設(shè)計(jì)。2.3 拿到壓縮包后怎么快速驗(yàn)證完整性解壓之后第一步不是直接往開發(fā)工具里導(dǎo)而是先看一下目錄里有沒(méi)有這幾樣?xùn)|西src 源碼目錄、pom.xml、數(shù)據(jù)庫(kù)腳本sql 或 db 文件、導(dǎo)入說(shuō)明。如果缺 pom.xml而是 lib 目錄下有一堆散落的 jar說(shuō)明這套源碼是“不依賴 Maven”的傳遞方式導(dǎo)入方式完全不同得手動(dòng)把 lib 加入項(xiàng)目依賴。我一般會(huì)先用文本編輯器看一遍 pom.xml確認(rèn) Spring 版本、MyBatis 版本、MySQL 驅(qū)動(dòng)版本和 Java 編譯版本。這四個(gè)版本決定本機(jī)環(huán)境和部署容器能不能直接跑。比如 pom 里指定的編譯版本是 1.8那本機(jī)最好裝 JDK 1.8如果只裝了高版本 JDK不降級(jí)大概率會(huì)遇到UnsupportedClassVersionError。再快速掃一遍 src/main/resources 下的配置文件搞清楚三件事數(shù)據(jù)庫(kù)連接信息在哪、上傳目錄配置在哪、有沒(méi)有獨(dú)立的 properties 文件。常見的配置文件名是 jdbc.properties、db.properties、application.properties如果直接寫在 Spring XML 里就去 spring-dao.xml 或 applicationContext.xml 里找。這一步能讓你在后續(xù)配置數(shù)據(jù)庫(kù)時(shí)不用四處翻文件。3. 從 zip 到可運(yùn)行環(huán)境配置與數(shù)據(jù)庫(kù)初始化3.1 導(dǎo)入前先核對(duì)這四樣?xùn)|西跑通這套系統(tǒng)的先決條件是本機(jī)環(huán)境匹配。按我的經(jīng)驗(yàn)順序需要提前確認(rèn)四樣JDK 1.8和項(xiàng)目編譯版本保持一致Maven 3.6.x本地倉(cāng)庫(kù)用固定目錄Tomcat 8.5 或 9.0不要用 Tomcat 10Jakarta 命名空間和 SSM 老項(xiàng)目不兼容MySQL 5.7 或 8.0以及一個(gè)能執(zhí)行 SQL 腳本的客戶端工具我習(xí)慣把 Maven 和 Tomcat 都用壓縮包解壓版不用開發(fā)工具自帶的服務(wù)。這樣出了問(wèn)題好控制變量不會(huì)出現(xiàn)“IDEA 里能跑換到命令行就掛”的尷尬。Maven 的本地倉(cāng)庫(kù)地址要改到非系統(tǒng)盤避免下載大量依賴后把 C 盤塞滿也方便以后清理。3.2 導(dǎo)入開發(fā)工具并讓 Maven 把依賴?yán)R在 IDEA 里導(dǎo)入這個(gè)項(xiàng)目的正確方式是File - New - Project from Existing Sources - 選擇解壓后的目錄 - Import project from external model - Maven。不要直接拖文件夾或用 Open那樣容易被當(dāng)成普通工程導(dǎo)致依賴無(wú)法解析。如果你是社區(qū)版 IDEA裝一下 Smart Tomcat 插件可以省掉不少配置工作。Maven 導(dǎo)入后會(huì)開始下載依賴這一步在國(guó)內(nèi)網(wǎng)絡(luò)環(huán)境下是最大的不確定性。優(yōu)先在 settings.xml 里配置國(guó)內(nèi)倉(cāng)庫(kù)鏡像在 mirrors 節(jié)點(diǎn)加一段配置讓依賴從本地網(wǎng)絡(luò)節(jié)點(diǎn)拉取。依賴?yán)R之后右側(cè) Maven 面板不再出現(xiàn)紅字項(xiàng)目結(jié)構(gòu)里的外部庫(kù)也不再報(bào)找不到包。這里有個(gè)容易踩的細(xì)節(jié)如果 pom.xml 里寫了 maven-compiler-plugin 的 source 和 target 為 1.8在 Project Structure 里也要把 Project SDK 和 language level 都設(shè)為 1.8。否則依賴全齊也會(huì)在編譯階段報(bào)錯(cuò)或者出現(xiàn)“常量字符串過(guò)長(zhǎng)”之類的奇怪提示。3.3 導(dǎo)入數(shù)據(jù)庫(kù)腳本并修改數(shù)據(jù)庫(kù)連接數(shù)據(jù)庫(kù)初始化是最容易卡住的一步。先把 MySQL 服務(wù)啟動(dòng)用客戶端工具連接本地實(shí)例新建一個(gè)數(shù)據(jù)庫(kù)字符集選 utf8mb4排序規(guī)則選 utf8mb4_general_ci。如果腳本導(dǎo)入到默認(rèn)字符集的庫(kù)里后期中文基本都是亂碼這種問(wèn)題排查起來(lái)很痛苦。執(zhí)行 SQL 腳本的方式是在客戶端工具里選中剛才創(chuàng)建的庫(kù)然后執(zhí)行 sql 文件把建表語(yǔ)句和初始數(shù)據(jù)一起跑完。如果腳本按表結(jié)構(gòu)、初始數(shù)據(jù)分成多個(gè)文件順序不能亂先建表再導(dǎo)數(shù)據(jù)。腳本結(jié)尾一般會(huì)插入一個(gè)管理員賬號(hào)密碼字段通常是加密后的密文。不要直接在數(shù)據(jù)庫(kù)里把密碼改成明文要先去代碼里找對(duì)應(yīng)的加密工具類看它用的是 MD5 還是加鹽哈希保持一致才能登錄成功。改數(shù)據(jù)庫(kù)配置是最后一步。打開 jdbc.properties把地址、賬號(hào)、密碼改成你本機(jī)的參數(shù)。注意 MySQL 8.0 的驅(qū)動(dòng)類和 5.7 不一樣驅(qū)動(dòng)類要換成com.mysql.cj.jdbc.DriverURL 里要加useSSLfalseserverTimezoneAsia/Shanghai否則連接時(shí)會(huì)報(bào)時(shí)區(qū)異常。如果你本機(jī)是 MySQL 5.7按原配置走就行。3.4 配置 Tomcat 啟動(dòng)項(xiàng)目依賴和數(shù)據(jù)庫(kù)都就緒后最后一步是把項(xiàng)目掛到 Tomcat 上。常見做法是讓項(xiàng)目以 war exploded 形式部署意思是直接使用編譯后的目錄運(yùn)行避免每次改代碼都重新打 war 包。在 Deployment 標(biāo)簽頁(yè)把 artifact 加到 Tomcat 里Application context 填/這樣訪問(wèn)地址就是http://localhost:8080/index.html不用帶項(xiàng)目名。啟動(dòng)前記得確認(rèn)一件事Tomcat 的端口沒(méi)有 8080 被占用。如果被占了要么殺進(jìn)程要么改 server.xml 的 Connector 端口。啟動(dòng)后日志里看到FrameworkServlet init字樣說(shuō)明 SpringMVC 已經(jīng)起來(lái)了看到 MyBatis 的 mapper 掃描日志說(shuō)明數(shù)據(jù)庫(kù)連接正常。這時(shí)候打開瀏覽器輸入登錄頁(yè)地址能看到頁(yè)面說(shuō)明整套環(huán)境已經(jīng)打通。4. 核心業(yè)務(wù)流程與代碼落地上傳、播放與學(xué)習(xí)進(jìn)度4.1 視頻上傳的完整處理鏈路視頻上傳是整個(gè)系統(tǒng)的核心功能它把用戶提交的文件、數(shù)據(jù)庫(kù)記錄、磁盤存儲(chǔ)三部分串在一起。后臺(tái)管理頁(yè)面提交表單時(shí)編碼格式是 multipart/form-dataSpringMVC 靠 multipart 解析器來(lái)解析。配置文件里要確保解析器存在否則 Controller 方法里的 MultipartFile 參數(shù)會(huì)是 null。下面是一段視頻上傳的 Controller 摘錄帶文件類型和大小限制Controller RequestMapping(/admin/video) public class VideoController { // 從配置文件讀取上傳目錄例如 D:/upload/ 或 /data/upload/ Value(${video.upload.dir}) private String uploadDir; PostMapping(/upload) public String upload(RequestParam(file) MultipartFile file, Video video, HttpServletRequest request) { if (file.isEmpty()) { // 空文件直接返回不給它寫磁盤的機(jī)會(huì) return redirect:/admin/video/list?statusempty; } // 獲取原始文件名并提取擴(kuò)展名用于生成新文件名 String originalName file.getOriginalFilename(); String ext originalName.substring(originalName.lastIndexOf(.)); String fileName System.currentTimeMillis() _ UUID.randomUUID().toString().substring(0, 8) ext; try { // 確認(rèn)目標(biāo)目錄存在不存在則遞歸創(chuàng)建 File dir new File(uploadDir); if (!dir.exists()) { dir.mkdirs(); } // 保存文件到磁盤 file.transferTo(new File(uploadDir fileName)); // 數(shù)據(jù)庫(kù)只保存相對(duì)路徑不保存磁盤絕對(duì)路徑 video.setUrl(/upload/ fileName); videoService.addVideo(video); } catch (IOException e) { e.printStackTrace(); return redirect:/admin/video/list?statuserror; } return redirect:/admin/video/list?statussuccess; } }邏輯說(shuō)明這里最關(guān)鍵的細(xì)節(jié)是數(shù)據(jù)庫(kù)只存相對(duì)路徑/upload/加文件名不存盤符開頭的絕對(duì)路徑。一旦存了絕對(duì)路徑項(xiàng)目遷移到另一臺(tái)機(jī)器后所有視頻鏈接都會(huì)失效這是最常見的坑。調(diào)用transferTo之前先判斷目錄是否存在并 mkdir能避免部署到 Linux 服務(wù)器時(shí)因?yàn)槟夸洸淮嬖诙o默失敗。參數(shù)上注意兩點(diǎn)Value(${video.upload.dir})的值在 Windows 上寫成D:/upload/這種正斜杠寫法Linux 上寫成/data/upload/文件大小上限由 Spring 配置里的 max-file-size 控制默認(rèn) 1MB 滿足不了視頻場(chǎng)景要按需調(diào)大比如 2GB。4.2 播放器嵌入與學(xué)習(xí)進(jìn)度回傳視頻播放頁(yè)一般用 HTML5 原生 video 標(biāo)簽點(diǎn)擊播放時(shí)跳到 player 頁(yè)面并帶上視頻 id。video 標(biāo)簽的 src 指向 Controller 查詢出來(lái)的視頻地址或者直接用模板語(yǔ)法從后臺(tái)返回值拼接。HTML5 播放器配合一個(gè)自繪進(jìn)度條就能覆蓋常規(guī)教學(xué)場(chǎng)景不需要引第三方商業(yè)播放器。需要注意視頻文件較大時(shí)瀏覽器不會(huì)一次性下載完而是邊下邊播這要求服務(wù)器端支持 Range 請(qǐng)求。SpringMVC 的靜態(tài)資源處理器默認(rèn)支持 Range但如果你自己寫了視頻流輸出接口必須手動(dòng)處理請(qǐng)求頭里的 Range 字段否則播放器拖動(dòng)進(jìn)度條會(huì)失敗。進(jìn)度回傳通常設(shè)計(jì)成一個(gè)異步接口播放器每 5 秒或暫停時(shí)調(diào)用一次把用戶 id、視頻 id、當(dāng)前播放時(shí)間傳到后端后端執(zhí)行 insert 或 update。為了避免頻繁寫庫(kù)可以做一個(gè)簡(jiǎn)單的內(nèi)存緩存同一個(gè)用戶同一門課只在上次進(jìn)度和本次進(jìn)度差 30 秒以上時(shí)再入庫(kù)一次。// 前端播放器進(jìn)度上報(bào)節(jié)流 5 秒一次 video.addEventListener(timeupdate, function () { let current Math.floor(video.currentTime); if (current - lastReportTime 5) { fetch(/video/progress, { method: POST, headers: {Content-Type: application/x-www-form-urlencoded}, body: userId userId videoId videoId progress current }); lastReportTime current; } });這段邏輯說(shuō)明第一次進(jìn)入播放頁(yè)時(shí)后端會(huì)查詢歷史進(jìn)度并返回前端拿到后設(shè)置video.currentTime。原生 video 的 currentTime 賦值在一些瀏覽器上要等元數(shù)據(jù)加載完成才生效所以需要監(jiān)聽loadedmetadata事件后再跳轉(zhuǎn)進(jìn)度。暫停時(shí)補(bǔ)報(bào)一次同樣重要避免用戶看完關(guān)掉瀏覽器丟失最后一段記錄。4.3 后臺(tái)管理怎么組織后臺(tái)管理端圍繞視頻表做增刪改查。列表頁(yè)用分頁(yè)插件做分頁(yè)查詢條件在 Mapper XML 里用動(dòng)態(tài) SQL 拼接。信息展示需要帶條件的三表聯(lián)查比如視頻表連分類表、連用戶表MyBatis 的 ResultMap 用 association 標(biāo)簽把關(guān)聯(lián)對(duì)象映射進(jìn)來(lái)。老項(xiàng)目的 Mapper 往往是手寫 SQL 風(fēng)格與接口方法一一對(duì)應(yīng)。不要急著把它升級(jí)成通用 Mapper 或 MyBatis-Plus因?yàn)槔习姹镜?XML 映射和接口綁定本身沒(méi)問(wèn)題反而自動(dòng)生成的代碼在類型匹配上更容易出錯(cuò)。后臺(tái)功能的重點(diǎn)不是把視頻表本身增刪改而是加業(yè)務(wù)狀態(tài)字段控制上下架。上架的視頻前臺(tái)可見下架的視頻前臺(tái)不可見前臺(tái)查詢 SQL 里帶一個(gè)status 1條件不要在代碼里先查全部再過(guò)濾那樣分頁(yè)計(jì)數(shù)會(huì)出錯(cuò)。5. 視頻教學(xué)系統(tǒng)常見問(wèn)題與避坑5.1 一啟動(dòng)就端口被占用現(xiàn)象啟動(dòng) Tomcat 直接報(bào)Port 8080 was already in use有時(shí)候連著好幾行 ERROR。原因本地有其他進(jìn)程占了 8080 端口或者上一次沒(méi)正常關(guān)閉 Tomcat 留下殘留進(jìn)程。解決命令行執(zhí)行netstat -ano | findstr 8080找到 PID 之后殺掉或者直接改 Tomcat 的 server.xml把Connector port8080改成8081。改端口最省事但改完之后訪問(wèn) URL 也要跟著變。不要同時(shí)開著多個(gè) Tomcat 實(shí)例那是給自己找麻煩。5.2 導(dǎo)入 SQL 腳本時(shí)報(bào)錯(cuò)或建表失敗現(xiàn)象執(zhí)行 SQL 腳本到一半報(bào)語(yǔ)法錯(cuò)誤或者提示表已存在。原因三個(gè)方向。一是腳本包含 USE 語(yǔ)句執(zhí)行時(shí)把當(dāng)前操作庫(kù)切走后面的建表語(yǔ)句落到了別的庫(kù)二是 MySQL 版本差異老腳本里有TYPEInnoDB這類 MySQL 5.6 時(shí)代的寫法三是本機(jī)已經(jīng)存在同名表主鍵或唯一索引沖突。解決把腳本頭部的 USE 語(yǔ)句刪掉執(zhí)行前手動(dòng)選中你新建的庫(kù)遇到TYPEInnoDB直接改成ENGINEInnoDB執(zhí)行之前確認(rèn)庫(kù)里沒(méi)有同名表。正規(guī)腳本一般會(huì)在頭部留好注釋你從頭到尾順序執(zhí)行卡住就單獨(dú)跑報(bào)錯(cuò)的那一條。5.3 頁(yè)面正常但圖片視頻 404現(xiàn)象后臺(tái)和前臺(tái)頁(yè)面都能打開增刪改查正常但首頁(yè)封面上裂圖點(diǎn)擊視頻播放返回 404。原因上傳的文件實(shí)際存到磁盤目錄但 SpringMVC 沒(méi)有把那個(gè)目錄映射成對(duì)應(yīng)的靜態(tài)資源 URL。這是視頻教學(xué)系統(tǒng)最經(jīng)典的問(wèn)題沒(méi)有之一。解決在 spring-mvc.xml 里配置資源映射Windows 寫file:D:/upload/Linux 寫file:/data/upload/然后重啟。這里有一個(gè)隱藏陷阱如果項(xiàng)目里同時(shí)配置了安全攔截器還需要把/upload/**加進(jìn)放行白名單否則靜態(tài)資源會(huì)被攔截器攔住視頻依然訪問(wèn)不了。5.4 Maven 依賴下載失敗導(dǎo)致整個(gè)工程飄紅現(xiàn)象導(dǎo)入項(xiàng)目后開發(fā)工具右下角一直轉(zhuǎn)圈pom.xml 里 Spring 相關(guān)依賴標(biāo)紅代碼里的 import 語(yǔ)句全部報(bào)錯(cuò)。原因默認(rèn)中央倉(cāng)庫(kù)網(wǎng)絡(luò)延遲高依賴下載到一半超時(shí)本地倉(cāng)庫(kù)里留下一堆.lastUpdated文件。這些標(biāo)記文件會(huì)讓 Maven 認(rèn)為依賴已經(jīng)嘗試過(guò)后面直接跳過(guò)重新下載。解決修改 settings.xml 配置國(guó)內(nèi)鏡像源然后刪除本地倉(cāng)庫(kù)目錄下所有.lastUpdated文件重新加載工程。命令行先執(zhí)行一遍mvn clean compile -U-U參數(shù)強(qiáng)制檢查快照更新跑通了再回開發(fā)工具里刷新基本能把飄紅問(wèn)題治理干凈。5.5 日期時(shí)間字段報(bào)錯(cuò)和 JSON 格式異?，F(xiàn)象新增記錄時(shí)后臺(tái)拋 MyBatis TypeException或者返回 JSON 里時(shí)間字段變成2025-01-05T12:00:00這種帶 T 的格式。原因數(shù)據(jù)庫(kù)字段是 datetime實(shí)體類用的是 LocalDateTimeMyBatis 的默認(rèn) TypeHandler 沒(méi)配好字段映射不上返回 JSON 時(shí) Jackson 對(duì) LocalDateTime 默認(rèn)走 ISO 格式和你頁(yè)面要的yyyy-MM-dd HH:mm:ss不一致。解決確認(rèn) MyBatis 版本支持 Java 8 時(shí)間類型老項(xiàng)目需要補(bǔ)上 jsr310 支持包JSON 格式問(wèn)題在項(xiàng)目里加一個(gè) Jackson 配置類統(tǒng)一設(shè)置時(shí)間序列化格式。這個(gè)坑在新舊版本混用的項(xiàng)目里特別常見因?yàn)楹芏嗳酥簧?jí)了某個(gè)依賴其他配套沒(méi)跟上。6. 進(jìn)階給這套系統(tǒng)加上接口鑒權(quán)與視頻訪問(wèn)限制跑通之后你會(huì)發(fā)現(xiàn)這套系統(tǒng)離商用還有距離最大問(wèn)題是接口完全裸奔。任何知道請(qǐng)求格式的人都能直接調(diào)接口拿數(shù)據(jù)或上傳視頻。這里介紹一個(gè)不加額外框架的鑒權(quán)方案SpringMVC 攔截器配合 session 校驗(yàn)。實(shí)現(xiàn)思路是注冊(cè)一個(gè)攔截器public class LoginInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { // 白名單路徑直接放行 String uri request.getRequestURI(); if (uri.startsWith(/user/login) || uri.startsWith(/user/register) || uri.startsWith(/upload/) || uri.startsWith(/static/)) { return true; } // 檢查登錄狀態(tài)未登錄跳回登錄頁(yè) Object user request.getSession().getAttribute(loginUser); if (user null) { response.sendRedirect(/user/login); return false; } return true; } }注冊(cè)位置在 spring-mvc.xml 里啟用注解驅(qū)動(dòng)后用 interceptors 標(biāo)簽包含這個(gè) bean。加了攔截器以后所有頁(yè)面資源都要登錄才能訪問(wèn)視頻地址不能被直接復(fù)制分享。但有一個(gè)關(guān)鍵點(diǎn)/upload/這個(gè)靜態(tài)路徑必須放行否則 video 標(biāo)簽的 src 請(qǐng)求會(huì)被攔下來(lái)播放器白屏且沒(méi)有任何提示。進(jìn)階一點(diǎn)的做法是把視頻 URL 做成帶過(guò)期時(shí)間的簽名地址。放行時(shí)不用真實(shí)路徑而是生成一個(gè)包含過(guò)期時(shí)間戳和文件名的串后端校驗(yàn)通過(guò)后再轉(zhuǎn)發(fā)到真實(shí)文件。這個(gè)方案成本不高但能擋住 copy 鏈接到處傳的人對(duì)教學(xué)資源保護(hù)有實(shí)際價(jià)值。至于在線轉(zhuǎn)碼生產(chǎn)環(huán)境一般用 FFmpeg 批處理把上傳的源視頻轉(zhuǎn)成 H.264 MP4保證各瀏覽器都能播這一步不是這套項(xiàng)目的必選項(xiàng)但真要做在線點(diǎn)播體驗(yàn)值得排上日程。我的習(xí)慣是跑通之后第一件事就是改造靜態(tài)資源映射把絕對(duì)路徑換成配置項(xiàng)再補(bǔ)上權(quán)限攔截器。環(huán)境干凈了后面加功能才不會(huì)被路徑和權(quán)限的破事反復(fù)拖回去。希望這篇筆記能幫你在 SSM 視頻教學(xué)管理系統(tǒng)這個(gè)項(xiàng)目上少走幾步把時(shí)間花在真正該做的二次開發(fā)上。本文還有配套的精品資源點(diǎn)擊獲取