簡(jiǎn)介一份基于Java的個(gè)人博客系統(tǒng)畢業(yè)設(shè)計(jì)全套資料包面向計(jì)算機(jī)相關(guān)專業(yè)畢業(yè)生與Java Web初學(xué)者可覆蓋選題、開發(fā)、文檔整理與答辯展示的完整需求尤其適合需要從零搭建完整項(xiàng)目的學(xué)習(xí)者。壓縮包大小178.52MB內(nèi)含項(xiàng)目報(bào)告、答辯PPT、源代碼、數(shù)據(jù)庫(kù)文件與部署教程視頻對(duì)應(yīng)需求分析、系統(tǒng)設(shè)計(jì)、模塊劃分、接口定義、數(shù)據(jù)表結(jié)構(gòu)及核心編碼實(shí)現(xiàn)等核心資料。技術(shù)棧涉及Servlet、JSP、JavaBean、MySQL等后端與數(shù)據(jù)庫(kù)技術(shù)以及HTML、CSS、JavaScript、Bootstrap等前端技術(shù)代碼分層清晰便于理解MVC架構(gòu)下的控制層、業(yè)務(wù)層與持久層。目前已有1347人瀏覽學(xué)習(xí)適合作為畢業(yè)設(shè)計(jì)參考和Java Web實(shí)戰(zhàn)練習(xí)。通過(guò)部署視頻可快速完成環(huán)境配置、數(shù)據(jù)庫(kù)導(dǎo)入與項(xiàng)目啟動(dòng)配合答辯PPT和項(xiàng)目報(bào)告能直觀呈現(xiàn)系統(tǒng)功能與設(shè)計(jì)思路幫助學(xué)習(xí)者少走彎路并提升工程實(shí)踐能力尤其對(duì)系統(tǒng)測(cè)試與部署環(huán)節(jié)可提供直接參照。1. 基于 Java 的個(gè)人博客系統(tǒng)畢業(yè)設(shè)計(jì)這份資源能幫你省掉哪一段路每年畢設(shè)季問(wèn)得最多的就是「有沒(méi)有一個(gè)能直接跑的 Java 項(xiàng)目」這套基于 Java 的個(gè)人博客系統(tǒng)畢業(yè)設(shè)計(jì)資源包——項(xiàng)目報(bào)告 答辯 PPT 源代碼 數(shù)據(jù)庫(kù) 部署視頻——就是沖著這個(gè)需求來(lái)的。它的價(jià)值不是讓你什么都不干而是把搭框架、建庫(kù)、配環(huán)境的幾周時(shí)間壓縮成幾天把精力留給真正要命的事看懂表結(jié)構(gòu)、改出自己講得明白的代碼、練到敢現(xiàn)場(chǎng)演示。適合 Java 方向?qū)W生、想快速交差的初級(jí)開發(fā)者以及用博客練 Spring Boot 的入門選手。下面我按「架構(gòu)立住 → 跑起來(lái) → 改得動(dòng) → 扛住答辯」的順序把這套資源吃透。2. 把博客畢設(shè)拆開看技術(shù)選型、表結(jié)構(gòu)與文檔框架先立住2.1 為什么是 Spring Boot MyBatis選型理由要能扛住答辯提問(wèn)拿到源碼第一步不是跑而是先搞清楚它為什么長(zhǎng)這樣。常見(jiàn)的 Java 個(gè)人博客模板有兩類老一點(diǎn)的是 SSMSpring Spring MVC MyBatis新一點(diǎn)的是 Spring Boot MyBatis 或 Spring Boot JPA?，F(xiàn)在的主流是 Spring Boot 2.x MyBatis理由很實(shí)際Spring Boot 內(nèi)嵌 Tomcat、自動(dòng)配置數(shù)據(jù)源、打 jar 直接跑省去 SSM 那一大堆 XML 配置MyBatis 的 SQL 是自己寫的映射關(guān)系直觀答辯時(shí)隨便問(wèn)一句「你的查詢?cè)趺磳憽鼓隳墚?dāng)場(chǎng)說(shuō)出 SQL 而不是解釋一個(gè)黑匣子。為什么不用 JPA畢設(shè)規(guī)模下 JPA 的自動(dòng)建表和懶加載反而是負(fù)擔(dān)尤其是多表關(guān)聯(lián)時(shí) Hibernate 的 N1 查詢問(wèn)題講不清楚容易翻車。MyBatis 加一個(gè) MyBatis-Plus 的 BaseMapper單表增刪改查幾乎不用寫 SQL代碼量砍一半。模板引擎這邊老項(xiàng)目用 JSP 的不少但現(xiàn)在答辯老師普遍反感 JSP 的部署方式——改一個(gè)頁(yè)面要重新編譯。我一般建議認(rèn)準(zhǔn) Thymeleaf后端渲染、天然支持 Spring Boot、改頁(yè)面只要改模板文件刷新瀏覽器就能看到效果。前后端分離的 Vue REST 方案在工程上是更現(xiàn)代的但對(duì)畢設(shè)來(lái)說(shuō)要額外處理跨域、Token、前端打包演示環(huán)境一多踩坑成本翻倍。2.2 五張核心表文章、分類、標(biāo)簽、評(píng)論、用戶的關(guān)系一次理清數(shù)據(jù)庫(kù)是整個(gè)項(xiàng)目里最值得花時(shí)間搞懂的部分。一個(gè)標(biāo)準(zhǔn)的 Java 個(gè)人博客系統(tǒng)表結(jié)構(gòu)逃不出這五張用戶表、文章表、分類表、標(biāo)簽表、評(píng)論表加上一張文章和標(biāo)簽的多對(duì)多關(guān)聯(lián)表。先建庫(kù)再建表。下面是完整可執(zhí)行的 MySQL 腳本我按通常的模板寫法給你拆開。-- 用戶表 CREATE TABLE t_user ( id INT NOT NULL AUTO_INCREMENT COMMENT 用戶ID, username VARCHAR(50) NOT NULL COMMENT 登錄名, password VARCHAR(100) NOT NULL COMMENT 密碼推薦BCrypt密文, nickname VARCHAR(50) DEFAULT NULL COMMENT 顯示昵稱, role TINYINT NOT NULL DEFAULT 1 COMMENT 權(quán)限1管理員 0普通用戶, create_time DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT 創(chuàng)建時(shí)間, PRIMARY KEY (id), UNIQUE KEY uk_username (username) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT用戶表;-- 文章表 CREATE TABLE t_article ( id INT NOT NULL AUTO_INCREMENT COMMENT 文章ID, title VARCHAR(200) NOT NULL COMMENT 標(biāo)題, summary VARCHAR(500) DEFAULT NULL COMMENT 摘要, content LONGTEXT NOT NULL COMMENT 正文存HTML或Markdown, category_id INT DEFAULT NULL COMMENT 所屬分類ID, user_id INT NOT NULL COMMENT 作者ID, view_count INT NOT NULL DEFAULT 0 COMMENT 瀏覽量, status TINYINT NOT NULL DEFAULT 0 COMMENT 0草稿 1已發(fā)布, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, update_time DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, PRIMARY KEY (id), KEY idx_category (category_id), KEY idx_user (user_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT文章表;-- 分類表 / 標(biāo)簽表 / 評(píng)論表 CREATE TABLE t_category ( id INT NOT NULL AUTO_INCREMENT, name VARCHAR(50) NOT NULL, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), UNIQUE KEY uk_name (name) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT分類表; CREATE TABLE t_tag ( id INT NOT NULL AUTO_INCREMENT, name VARCHAR(50) NOT NULL, PRIMARY KEY (id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT標(biāo)簽表; CREATE TABLE t_comment ( id INT NOT NULL AUTO_INCREMENT, article_id INT NOT NULL COMMENT 文章ID, user_id INT DEFAULT NULL COMMENT 評(píng)論人ID游客為NULL, content VARCHAR(1000) NOT NULL, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), KEY idx_article (article_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT評(píng)論表;-- 文章-標(biāo)簽關(guān)聯(lián)表 CREATE TABLE t_article_tag ( article_id INT NOT NULL, tag_id INT NOT NULL, PRIMARY KEY (article_id, tag_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT文章標(biāo)簽關(guān)聯(lián)表;幾個(gè)參數(shù)你答辯時(shí)最好能主動(dòng)講出來(lái)。第一engineInnoDB支持事務(wù)和行級(jí)鎖博客這種讀寫混合的小項(xiàng)目足夠第二charsetutf8mb4而不是utf8因?yàn)楸砬榉?hào)也要入庫(kù)utf8 存不下 emoji 會(huì)直接報(bào)錯(cuò)第三create_time用DEFAULT CURRENT_TIMESTAMP插入時(shí)不用手動(dòng)塞時(shí)間第四外鍵我建議不建物理外鍵只建普通索引因?yàn)槲锢硗怄I在刪除分類或用戶時(shí)會(huì)連鎖報(bào)錯(cuò)畢設(shè)階段用邏輯關(guān)聯(lián)在代碼層控制就夠了。第五t_article_tag這種關(guān)聯(lián)表的主鍵用的是聯(lián)合主鍵防止同一篇文章打同一個(gè)標(biāo)簽兩遍。2.3 項(xiàng)目報(bào)告和答辯 PPT三塊內(nèi)容決定你是 60 分還是 90 分源碼再漂亮報(bào)告和 PPT 寫不明白照樣被卡。我的經(jīng)驗(yàn)是無(wú)論模板里原本寫了什么你至少要在這三塊上投入時(shí)間。第一塊是需求分析和用例圖別寫「本系統(tǒng)實(shí)現(xiàn)了用戶管理」這種廢話要寫「管理員可以發(fā)布、編輯、刪除文章游客可以按分類和標(biāo)簽瀏覽文章并發(fā)表評(píng)論」每個(gè)角色配兩三個(gè)典型流程。第二塊是系統(tǒng)設(shè)計(jì)把架構(gòu)圖畫成三層控制層Controller、業(yè)務(wù)層Service、數(shù)據(jù)訪問(wèn)層Mapper再把 2.2 里的 ER 圖貼上去標(biāo)注主鍵、外鍵和一對(duì)多關(guān)系。第三塊是測(cè)試結(jié)果除了功能測(cè)試用例表強(qiáng)烈建議放兩三個(gè)接口測(cè)試截圖——用 Postman 調(diào) /article/list、/admin/article/save 這些接口把返回 JSON 貼進(jìn) PPT比十頁(yè)功能截圖都有說(shuō)服力。文檔這塊有個(gè)常見(jiàn)翻車點(diǎn)直接從別的畢設(shè)復(fù)制需求分析導(dǎo)致「系統(tǒng)角色」還留著根本沒(méi)實(shí)現(xiàn)的后臺(tái)評(píng)論審核功能。答辯老師對(duì)項(xiàng)目里沒(méi)有的東西問(wèn)得最狠。我建議對(duì)著自己的功能清單一項(xiàng)項(xiàng)核報(bào)告里出現(xiàn)的每個(gè)功能代碼里必須能找到對(duì)應(yīng)入口代碼里有的功能報(bào)告里必須有截圖。能做到這個(gè)閉環(huán)答辯基本就穩(wěn)了。3. 從源碼到跑起來(lái)部署視頻沒(méi)拍全的關(guān)鍵步驟與參數(shù)3.1 環(huán)境準(zhǔn)備JDK、Maven、MySQL 的版本匹配關(guān)系部署視頻通常會(huì)快進(jìn)這段但環(huán)境不匹配是「跑不起來(lái)」的第一大原因這不是玄學(xué)是版本兼容問(wèn)題。先把三個(gè)版本對(duì)清楚再動(dòng)手。java -version mvn -version mysql --version三條命令分別查 JDK、Maven 和 MySQL 的版本。常見(jiàn)的 Java 個(gè)人博客模板對(duì)應(yīng)的是 JDK 1.8 Maven 3.6 MySQL 5.7 或 8.0。如果你電腦上裝的是 JDK 17直接跑 Spring Boot 2.x 老模板啟動(dòng)時(shí)大概率報(bào)UnsupportedClassVersionError或者 CGLIB 相關(guān)錯(cuò)誤因?yàn)樾掳?JDK 移除了部分反射權(quán)限。兩個(gè)處理辦法一是裝一個(gè) JDK 1.8 并在 IDEA 的 Project Structure 里切過(guò)去二是把 pom.xml 里的 Spring Boot 版本升到 2.7 以上同時(shí)檢查 MyBatis 和 Thymeleaf 的兼容性。我一般傾向第一種成本最低也最貼近模板原作者的運(yùn)行環(huán)境。MySQL 這塊注意一個(gè)小細(xì)節(jié)5.7 和 8.0 的驅(qū)動(dòng)類名不一樣。5.7 用com.mysql.jdbc.Driver8.0 用com.mysql.cj.jdbc.Driver而且 8.0 的連接 URL 必須帶時(shí)區(qū)參數(shù)不然報(bào)Communications link failure。下面配置章節(jié)我會(huì)把標(biāo)準(zhǔn)寫法給出來(lái)。如果你用 IDEA直接把源碼目錄當(dāng) Maven 項(xiàng)目導(dǎo)入等依賴下載完成src/main/java下的啟動(dòng)類會(huì)有一個(gè)綠色的運(yùn)行按鈕點(diǎn)了就能起——但先別急數(shù)據(jù)庫(kù)還沒(méi)導(dǎo)。3.2 導(dǎo)入數(shù)據(jù)庫(kù)先建庫(kù)再導(dǎo)數(shù)據(jù)別跳過(guò) charset資源包里通常會(huì)有一個(gè).sql文件可能是blog.sql或database.sql。導(dǎo)入前先做一件事打開看看文件開頭有沒(méi)有CREATE DATABASE語(yǔ)句。有的話直接一條命令全導(dǎo)沒(méi)有的話先建庫(kù)再導(dǎo)。mysql -u root -p -e CREATE DATABASE IF NOT EXISTS blog DEFAULT CHARSET utf8mb4 COLLATE utf8mb4_general_ci; mysql -u root -p blog blog.sql第一行創(chuàng)建名為 blog 的數(shù)據(jù)庫(kù)DEFAULT CHARSET 和 COLLATE 必須顯式指定因?yàn)橛行?MySQL 服務(wù)器的默認(rèn)字符集是 latin1表即使寫了 utf8mb4建庫(kù)這一步兜底錯(cuò)了后面查中文會(huì)亂碼。第二行把 SQL 文件導(dǎo)入到 blog 庫(kù)。成功后執(zhí)行mysql -u root -p -e USE blog; SHOW TABLES;能看到 t_user、t_article 這些表就對(duì)了。還有一坑有些模板的 SQL 文件里已經(jīng)寫了USE blog;但你本地庫(kù)名不叫 blog 叫 blog_system導(dǎo)入時(shí)就會(huì)把數(shù)據(jù)寫進(jìn)它指定的庫(kù)你的配置文件卻連著一個(gè)空庫(kù)。遇到這種情況要么建一個(gè)和文件里同名的庫(kù)要么把 SQL 文件里的USE語(yǔ)句注釋掉再導(dǎo)入。導(dǎo)入完了順手查一下 t_user 表有沒(méi)有初始賬號(hào)數(shù)據(jù)沒(méi)有的話自己插入一條管理員賬號(hào)密碼先用最簡(jiǎn)單的 123456登錄跑通后再改。3.3 application.yml 的五個(gè)必調(diào)參數(shù)改錯(cuò)一個(gè)就起不來(lái)源碼里在src/main/resources下找到application.yml或application.properties。Spring Boot 2.x 模板基本都用 yml 格式層次比 properties 清楚。下面是按標(biāo)準(zhǔn)寫法給出的最小可用配置server: port: 8080 spring: datasource: url: jdbc:mysql://localhost:3306/blog?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai username: root password: 你自己的密碼 driver-class-name: com.mysql.cj.jdbc.Driver thymeleaf: cache: false mybatis-plus: mapper-locations: classpath:mapper/*.xml configuration: log-impl: org.apache.ibatis.logging.stdout.StdOutImpl五個(gè)重點(diǎn)逐一說(shuō)明。第一server.port改 8080 以外要保證沒(méi)被占用。第二URL 里serverTimezoneAsia/Shanghai是 MySQL 8.0 的必填項(xiàng)缺了直接連接失敗。第三characterEncodingutf8配合數(shù)據(jù)庫(kù)的 utf8mb4 保證中文不亂碼URL 里的useUnicodetrue也順手留著。第四spring.thymeleaf.cache: false是開發(fā)期福利改 HTML 模板不重啟就能看到效果如果設(shè)成 true你改了首頁(yè)死活沒(méi)變化就是這個(gè)在作怪。第五log-impl配成 StdOutImpl 后每次 SQL 執(zhí)行都會(huì)打印到控制臺(tái)調(diào)試和答辯排錯(cuò)都靠它。密碼字段提醒一句本地開發(fā)可以明文但不要把這個(gè)配置提交到公開的 GitHub 倉(cāng)庫(kù)源代碼管理里把配置文件的敏感信息替換成環(huán)境變量是基本素質(zhì)。3.4 本地啟動(dòng)和打包mvn 兩種方式的區(qū)別環(huán)境配好、庫(kù)導(dǎo)好、配置改好就可以啟動(dòng)了。IDEA 里直接點(diǎn)運(yùn)行最省事但更推薦命令行方式因?yàn)槟阋院笠獙懖渴鹞臋n里面所有命令必須是命令行可執(zhí)行的。mvn spring-boot:run這是開發(fā)模式前臺(tái)運(yùn)行按 CtrlC 結(jié)束日志實(shí)時(shí)滾。適合本地調(diào)代碼。mvn clean package -DskipTests java -jar target/blog-0.0.1-SNAPSHOT.jar這是生產(chǎn)模式先跳過(guò)測(cè)試打包成 jar再java -jar跑起來(lái)。打包完你會(huì)發(fā)現(xiàn) target 目錄下多了個(gè)幾十 MB 的 jar里面帶著內(nèi)嵌 Tomcat扔到任何裝了 JDK 的機(jī)器上都能起這才是部署視頻里常說(shuō)的「可執(zhí)行文件」。啟動(dòng)日志里看到Tomcat started on port(s): 8080就成功了瀏覽器訪問(wèn)http://localhost:8080如果能打開首頁(yè)整個(gè)鏈路就算跑通。接著做兩件事登錄后臺(tái)然后發(fā)一篇測(cè)試文章確認(rèn)數(shù)據(jù)庫(kù)的增刪改查都是好的。到這一步你已經(jīng)完成了這段畢設(shè)最「虛」但最容易卡住的環(huán)節(jié)。4. 源碼骨架怎么讀、怎么改核心模塊的套路和必調(diào)參數(shù)4.1 登錄與權(quán)限攔截器是最適合畢設(shè)的輕量方案把項(xiàng)目跑起來(lái)后就該打開源碼認(rèn)真讀了。我不建議一開始就從 controller 逐行看而是先順著一個(gè)請(qǐng)求走完你的登錄請(qǐng)求是怎么進(jìn)到后臺(tái)的大多數(shù)個(gè)人博客模板用的是攔截器方案而不是 Spring Security因?yàn)楹笳叩倪^(guò)濾器鏈、UserDetailsService、權(quán)限配置對(duì)畢設(shè)來(lái)說(shuō)太重講不清楚還容易出配置問(wèn)題。攔截器的實(shí)現(xiàn)就是一個(gè)類加一段注冊(cè)代碼。Component public class LoginInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { Object loginUser request.getSession().getAttribute(loginUser); if (loginUser null) { response.sendRedirect(/admin/login); return false; } return true; } }Configuration public class WebConfig implements WebMvcConfigurer { Resource private LoginInterceptor loginInterceptor; Override public void addInterceptors(InterceptorRegistry registry) { registry.addInterceptor(loginInterceptor) .addPathPatterns(/admin/**) .excludePathPatterns(/admin/login, /admin/doLogin, /css/**, /js/**, /images/**); } }這段邏輯的關(guān)鍵在excludePathPatterns登錄接口和靜態(tài)資源必須放行否則樣式全丟、登錄接口也進(jìn)不去。真實(shí)模板中這幾個(gè)放行路徑經(jīng)常寫漏寫錯(cuò)表現(xiàn)為「登錄成功了但后臺(tái)頁(yè)面沒(méi)有樣式」八成是/css/**這類沒(méi)放行或者 JSP 老模板把靜態(tài)資源放在 webapp 下導(dǎo)致路徑對(duì)不上。讀取請(qǐng)求處理流程時(shí)順帶把登錄密碼的校驗(yàn)方式看一眼。好的模板會(huì)存 BCrypt 密文答辯時(shí)可以主動(dòng)提一句「密碼不是明文存儲(chǔ)用的 BCrypt 加鹽哈?！?。如果你的模板是明文存密碼我建議改掉在 Service 里用BCryptPasswordEncoder的matches方法做校驗(yàn)改動(dòng)量不大但這是答辯老師最喜歡的細(xì)節(jié)之一。4.2 文章增刪改查MyBatis-Plus 讓代碼少寫一半文章模塊是個(gè)人博客系統(tǒng)的核心你要能講清楚「新增一篇文章從頁(yè)面到數(shù)據(jù)庫(kù)走過(guò)了什么」。常見(jiàn)模板的 Mapper 層寫法是 MyBatis-Plus 風(fēng)格接口長(zhǎng)這樣public interface ArticleMapper extends BaseMapperArticle { }你沒(méi)看錯(cuò)空接口就夠了。BaseMapperT內(nèi)置了insert、deleteById、updateById、selectById、selectList等十幾個(gè)通用方法單表 CRUD 零 SQL。真正需要寫條件查詢的地方用的是LambdaQueryWrapper比如后臺(tái)分頁(yè)查文章列表Override public PageArticle pageArticles(int pageNum, int pageSize, String keyword, Long categoryId) { LambdaQueryWrapperArticle wrapper new LambdaQueryWrapper(); wrapper.like(StringUtils.hasText(keyword), Article::getTitle, keyword) .eq(categoryId ! null, Article::getCategoryId, categoryId) .orderByDesc(Article::getCreateTime); return articleMapper.selectPage(new Page(pageNum, pageSize), wrapper); }參數(shù)說(shuō)明like和eq的第一個(gè)參數(shù)是布爾條件為 true 時(shí)該條件才生效這樣搜索框沒(méi)填關(guān)鍵詞時(shí)就自動(dòng)跳過(guò)模糊查詢不需要手動(dòng)寫三個(gè) if。Article::getTitle是方法引用MyBatis-Plus 靠它解析成數(shù)據(jù)庫(kù)字段名避免了硬編碼字符串導(dǎo)致改字段名后 SQL 崩掉。selectPage的返回值Page里帶著records當(dāng)前頁(yè)數(shù)據(jù)、total總條數(shù)、current當(dāng)前頁(yè)碼、size每頁(yè)條數(shù)前端遍歷records分頁(yè)組件讀這四個(gè)屬性就夠。答辯時(shí)老師常追問(wèn)「分頁(yè)怎么實(shí)現(xiàn)的」你要能答出兩層應(yīng)用層用 Page 對(duì)象傳頁(yè)碼和每頁(yè)大小MyBatis-Plus 底層自動(dòng)拼接LIMITMySQL或ROWNUMOracle語(yǔ)句數(shù)據(jù)庫(kù)層返回當(dāng)頁(yè)數(shù)據(jù)而不是全表。如果你的模板不是 MyBatis-Plus 而是純 MyBatis 的 XML 寫法也沒(méi)問(wèn)題去src/main/resources/mapper/下打開 ArticleMapper.xml你會(huì)看到selectPageByCondition這類手寫 SQL那里才是你真正要讀的地方。4.3 前端 Thymeleaf三個(gè)必改頁(yè)面和它們的屬性套路前端模板頁(yè)在src/main/resources/templates/下常見(jiàn)結(jié)構(gòu)是index.html前臺(tái)首頁(yè)、article.html文章詳情、admin/后臺(tái)管理。Thymeleaf 的語(yǔ)法核心就是th:屬性看懂了下面這段首頁(yè)列表其他頁(yè)面都是變體ul li th:eacharticle, stat : ${page.records} a th:href{/article/{id}(id${article.id})} th:text${article.title}文章標(biāo)題/a span th:text${#dates.format(article.createTime, yyyy-MM-dd)}發(fā)布日期/span em th:text共 ${article.viewCount} 次瀏覽瀏覽量/em /li /ulth:each是循環(huán)page.records對(duì)應(yīng) Controller 放進(jìn) Model 的分頁(yè)數(shù)據(jù)stat是循環(huán)計(jì)數(shù)器可以取stat.index拿序號(hào)。th:href的{/article/{id}(id${article.id})}是帶參數(shù)的 URL 寫法比字符串拼接安全自動(dòng)做 URL 編碼。th:text輸出純文本如果文章正文存的是 HTML詳情頁(yè)要用th:utext輸出否則標(biāo)簽會(huì)被轉(zhuǎn)義成文字顯示。這是畢設(shè)里出現(xiàn)頻率最高的 bug正文全部變成了帶p標(biāo)簽的源碼就是因?yàn)橛昧藅h:text。改前端時(shí)兩條血淚經(jīng)驗(yàn)第一頁(yè)面里的靜態(tài)資源路徑一律用th:href{/css/style.css}別在 HTML 里手寫/css/style.css否則項(xiàng)目部署到子路徑時(shí)全部 404第二后臺(tái)表單提交改成 POST 后Controller 要加PostMapping并處理重定向表單驗(yàn)證出錯(cuò)時(shí)用BindingResult把錯(cuò)誤信息回顯到頁(yè)面。你把這些點(diǎn)改過(guò)一遍源碼就算是真正讀懂了。5. 部署與答辯避坑高頻翻車現(xiàn)象、原因與排查方法5.1 數(shù)據(jù)庫(kù)連不上時(shí)區(qū)、編碼、未建庫(kù)三類報(bào)錯(cuò)現(xiàn)象一啟動(dòng)日志報(bào)Communications link failure或The server time zone value ?D1ú±ê×?ê±?? is unrecognized。原因MySQL 8.0 要求連接串顯式指定時(shí)區(qū)而配置里沒(méi)帶serverTimezone。解決在application.yml的 URL 末尾加上serverTimezoneAsia/Shanghai重啟。現(xiàn)象二控制臺(tái)報(bào)Unknown database blog。原因SQL 文件沒(méi)導(dǎo)入或者導(dǎo)入時(shí)庫(kù)名和連接串不一致。解決按 3.2 的命令重新建庫(kù)導(dǎo)入然后確認(rèn)配置文件里的庫(kù)名和實(shí)際庫(kù)名一字不差。注意大小寫MySQL 在 Linux 下表名庫(kù)名是區(qū)分大小寫的。現(xiàn)象三中文亂碼頁(yè)面上全是???。原因建庫(kù)時(shí)沒(méi)指定utf8mb4或者 JDBC URL 少了characterEncodingutf8。解決把庫(kù)、表、連接串三級(jí)全部統(tǒng)一成utf8mb4 / utf8改完重新啟動(dòng)并刷新頁(yè)面。這三個(gè)問(wèn)題占了「數(shù)據(jù)庫(kù)連不上」九成以上任何一個(gè)都可以在答辯現(xiàn)場(chǎng)直接讓你翻車提前用上面的命令自查一遍。5.2 端口被占用和項(xiàng)目起不來(lái)現(xiàn)象啟動(dòng)日志有Port 8080 was already in use。原因之前運(yùn)行的后臺(tái)程序沒(méi)退干凈或者本地有其他服務(wù)占了 8080。排查命令# Windows 查看占用 8080 的進(jìn)程 netstat -ano | findstr 8080 taskkill /PID 你的進(jìn)程號(hào) /F # macOS / Linux lsof -i :8080 kill -9 你的進(jìn)程號(hào)殺掉進(jìn)程后重啟即可。另一個(gè)起不來(lái)的場(chǎng)景是java -jar啟動(dòng)后訪問(wèn) 404原因多半是模板引擎頁(yè)面路徑不對(duì)——Thymeleaf 默認(rèn)去templates/下找 HTML如果你的頁(yè)面放到了static/下Controller 返回的視圖名永遠(yuǎn)找不到控制臺(tái)還會(huì)打一行Circular view path [index]的警告。解決是確認(rèn)視圖名和templates/下的文件名完全一致區(qū)分大小寫。5.3 打包后資源丟失和靜態(tài) 404現(xiàn)象IDEA 里運(yùn)行一切正常按 3.4 打包成 jar 后再訪問(wèn)發(fā)現(xiàn) CSS、JS 全部 404。原因打包時(shí)資源文件沒(méi)被包含進(jìn) jar或者代碼里用了硬編碼路徑。解決打開pom.xml確認(rèn)build段里有resources配置把src/main/resources納入打包然后把頁(yè)面里的/css/xx.css全部改成th:href動(dòng)態(tài)寫法重新mvn clean package。這個(gè)坑幾乎人人都踩提前踩完部署演示時(shí)就多一分從容。還有個(gè)冷門但常發(fā)生的SQL 文件沒(méi)被包進(jìn) jar。如果你的初始化 SQL 放在resources/sql/下而 pom 沒(méi)包含**/*.sql部署到新機(jī)器上就會(huì)「有代碼沒(méi)數(shù)據(jù)」。解決是在resources配置里加一條include**/*.sql/include或者干脆把 SQL 文件和 jar 放在一起手動(dòng)導(dǎo)入。5.4 答辯演示前的四個(gè)準(zhǔn)備動(dòng)作演示翻車往往不是技術(shù)問(wèn)題是流程問(wèn)題。第一準(zhǔn)備一個(gè)專用演示賬號(hào)并確認(rèn)密碼正確不要現(xiàn)場(chǎng)輸密碼手一抖就完蛋。第二預(yù)置演示數(shù)據(jù)至少 5 篇文章、3 個(gè)分類、4 個(gè)標(biāo)簽、2 條評(píng)論別打開后臺(tái)發(fā)現(xiàn)是空庫(kù)。第三把log-impl的 SQL 日志留著演示時(shí)故意操作一次新增文章讓控制臺(tái)滾出INSERT INTO語(yǔ)句這是證明「你懂底層」的現(xiàn)場(chǎng)證據(jù)。第四斷網(wǎng)檢查——如果頁(yè)面里引用了外部 CDN 的圖標(biāo)或字體答辯教室沒(méi)網(wǎng)時(shí)頁(yè)面會(huì)很難看提前把靜態(tài)資源本地化。這四條做完心態(tài)上已經(jīng)贏了七成。5.5 初始賬號(hào)找不到模板最容易被忽略的坑現(xiàn)象數(shù)據(jù)庫(kù)導(dǎo)入成功但登錄頁(yè)面輸什么密碼都報(bào)錯(cuò)。原因SQL 文件里的初始用戶表數(shù)據(jù)有但密碼是加密串你輸?shù)?123456 明文自然匹配不上。解決找到項(xiàng)目里處理登錄的 Service看它用的是 BCrypt、MD5 還是別的算法如果是 BCrypt去在線生成器把 123456 加密后 UPDATE 進(jìn)用戶表如果是 MD5同樣生成密文后更新。這條我建議無(wú)論如何都提前做好因?yàn)樗恰缚雌饋?lái)全對(duì)但就是進(jìn)不去」的典型黑匣子問(wèn)題也是我見(jiàn)過(guò)導(dǎo)致答辯現(xiàn)場(chǎng)直接斷片的頭號(hào)原因。6. 讓畢設(shè)從「能跑」到「能加分」三個(gè)進(jìn)階方向與一個(gè)驗(yàn)證方法基礎(chǔ)功能全通后你有余力就可以往加分項(xiàng)上走優(yōu)先級(jí)按投入產(chǎn)出比排。第一個(gè)是 Markdown 富文本編輯把文章 content 字段存 Markdown 源文展示時(shí)用 commonmark-java 庫(kù)渲染成 HTML改動(dòng)只涉及編輯頁(yè)和詳情頁(yè)兩個(gè)地方答辯卻能講出「編輯器層和數(shù)據(jù)展示層分離」的設(shè)計(jì)思想。第二個(gè)是全文搜索別自己用LIKE %keyword%硬扛數(shù)據(jù)量大了性能斷崖直接給文章表加 MySQL 全文索引用MATCH(title, content) AGAINST(關(guān)鍵詞)查詢一句話就能講清楚「數(shù)據(jù)庫(kù)級(jí)的全文檢索方案」。第三個(gè)是圖片上傳。給后臺(tái)加一個(gè)圖片上傳接口存儲(chǔ)到本地目錄再把訪問(wèn)路徑映射成虛擬 URL。這個(gè)功能幾乎每個(gè)答辯老師都會(huì)問(wèn)「你的圖片存哪」你能答出「服務(wù)器目錄 虛擬映射 數(shù)據(jù)庫(kù)存路徑」三層比答「存數(shù)據(jù)庫(kù)」高一截。驗(yàn)證方法用一條命令就能完成。啟動(dòng)服務(wù)后用 curl 連打三個(gè)接口驗(yàn)證核心鏈路curl -X POST http://localhost:8080/admin/doLogin -d usernameadminpassword123456 curl http://localhost:8080/article/list?pageNum1pageSize5 curl -X POST http://localhost:8080/admin/article/save -d title測(cè)試content內(nèi)容categoryId1第一條看登錄是否返回成功第二條看列表是否返回 JSON第三條寫一條測(cè)試數(shù)據(jù)后去數(shù)據(jù)庫(kù)里查SELECT * FROM t_article ORDER BY id DESC LIMIT 1;確認(rèn)落庫(kù)成功。這三步做完你的畢設(shè)從代碼、數(shù)據(jù)到部署就是一條完整的、經(jīng)得起驗(yàn)證的鏈路。我個(gè)人的習(xí)慣是每次改完代碼都跑一遍這三條命令確認(rèn)沒(méi)有「改一處崩三處」。希望幫到你。本文還有配套的精品資源點(diǎn)擊獲取