簡介這是一份基于Spring Boot與SSM框架的大創(chuàng)管理系統(tǒng)畢業(yè)論文定位為計(jì)算機(jī)專業(yè)學(xué)生及畢業(yè)設(shè)計(jì)開發(fā)者的參考資料核心解決大學(xué)生創(chuàng)新創(chuàng)業(yè)項(xiàng)目管理中申報、審核、評審等流程的規(guī)范化與信息化問題。論文結(jié)構(gòu)完整從摘要、研究背景、可行性分析、需求分析到數(shù)據(jù)庫設(shè)計(jì)、數(shù)據(jù)流圖、詳細(xì)設(shè)計(jì)與測試均有展開并系統(tǒng)描述了學(xué)生、指導(dǎo)老師、院系管理員三種角色的功能模塊其中學(xué)生項(xiàng)目申報、老師項(xiàng)目審核、管理員項(xiàng)目評審等核心業(yè)務(wù)均有涉及可幫助讀者快速理解一套B/S架構(gòu)管理系統(tǒng)的完整開發(fā)脈絡(luò)。壓縮包內(nèi)含1個doc文檔約2.57MB包含論文正文、目錄、系統(tǒng)截圖及參考文獻(xiàn)適合作為畢業(yè)設(shè)計(jì)論文模板或同類課題的系統(tǒng)設(shè)計(jì)參照。已有134人學(xué)習(xí)下載適合正在開展大創(chuàng)或類似管理類課題、需要快速把握論文框架與數(shù)據(jù)庫設(shè)計(jì)思路的讀者。1. 大創(chuàng)管理系統(tǒng)從項(xiàng)目申報到結(jié)項(xiàng)的全流程管理大創(chuàng)項(xiàng)目管理的痛點(diǎn)往往不是沒人干活而是流程散在各處申報書發(fā)到微信群中檢材料在郵箱里結(jié)項(xiàng)報告又變成一堆壓縮包老師審核時要逐個下載再手工登記。這套基于 Spring Boot 的大創(chuàng)管理系統(tǒng)把學(xué)生、指導(dǎo)老師、院系管理員三個角色裝進(jìn)同一個瀏覽器平臺從項(xiàng)目申報、中檢、結(jié)項(xiàng)到評審方案與專家評審全都在線完成。對正在做 SSM 或 Spring Boot 畢業(yè)設(shè)計(jì)的同學(xué)來說這份資源的價值在于它同時包含可運(yùn)行的工程源碼和完整的畢業(yè)論文文檔從可行性分析、數(shù)據(jù)庫設(shè)計(jì)到功能測試都能直接對照。對想給學(xué)院大創(chuàng)流程做信息化的人來說三角色權(quán)限劃分和評審方案管理也提供了很實(shí)在的參考。2. 技術(shù)架構(gòu)與數(shù)據(jù)設(shè)計(jì)SSM MySQL 的三層結(jié)構(gòu)2.1 技術(shù)選型為什么用 Spring Boot 而不直接寫 SSM傳統(tǒng) SSM 項(xiàng)目在搭建時最耗時間的就是 spring-mvc.xml、mybatis-config.xml 加上 web.xml 那一堆配置數(shù)據(jù)源、事務(wù)、掃描路徑寫錯一個啟動階段就要反復(fù)試錯。這套系統(tǒng)的設(shè)計(jì)思路是業(yè)務(wù)上仍按 Spring SpringMVC MyBatis 來組織但用 Spring Boot 做底座把多數(shù)樣板配置交給自動配置處理。也就是說你拿到工程后不需要從零拼配置改一個 application.yml 就能把數(shù)據(jù)庫、端口、日志全部帶起來。JDK 1.8 是 Spring Boot 項(xiàng)目里很常用的版本資源里這份工程的依賴也按這個基線來鎖。服務(wù)層用 Spring 管理 Bean控制層用 SpringMVC 接收請求數(shù)據(jù)訪問層用 MyBatis 寫 SQL三層職責(zé)清楚。B/S 架構(gòu)決定了所有功能最終都跑在瀏覽器里服務(wù)器只需部署一套應(yīng)用學(xué)生、指導(dǎo)老師、院系管理員按角色登錄后看到的是不同菜單不需要在每臺電腦上裝客戶端。server: port: 8080 servlet: context-path: / spring: datasource: url: jdbc:mysql://localhost:3306/dachuang?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai username: root password: 123456 driver-class-name: com.mysql.cj.jdbc.Driver servlet: multipart: max-file-size: 20MB max-request-size: 20MB mybatis: mapper-locations: classpath:mapper/*.xml type-aliases-package: com.dachuang.entity這段配置里port 控制 Web 服務(wù)端口datasource 下的四項(xiàng)是 MySQL 連接的關(guān)鍵連接地址指定了庫名 dachuangcharacterEncodingutf8 保證中文參數(shù)不亂碼serverTimezone 必須寫成當(dāng)前地區(qū)時區(qū)否則新版 JDBC 驅(qū)動在連接時會直接拋時區(qū)異常。multipart 配置預(yù)留了項(xiàng)目申報和優(yōu)秀項(xiàng)目模塊里上傳圖片、附件的容量20MB 對結(jié)項(xiàng)報告這類文檔基本夠用如果后續(xù)要傳視頻材料可以按需要調(diào)大。有人會問既然用了 Spring Boot為什么不干脆用 JPA 或 MyBatis-Plus這個項(xiàng)目保持原生 MyBatis 加 XML 映射一方面是因?yàn)檎撐暮痛疝q時需要講清楚 SQL 與實(shí)體映射關(guān)系另一方面是大創(chuàng)項(xiàng)目里很多字段都是文本類型例如評審方案的創(chuàng)新點(diǎn)、成員素質(zhì)、預(yù)期成果這些用 XML 寫動態(tài) SQL 比注解拼接更直觀。Spring Boot 的 starter 已經(jīng)幫我們自動裝配了 SpringMVC、事務(wù)管理、日志等基礎(chǔ)組件你只要保證啟動類上帶 MapperScan 注解把 Mapper 接口掃描進(jìn)去就行。2.2 三個角色與九大功能模塊的對應(yīng)關(guān)系系統(tǒng)的一個核心邏輯是角色驅(qū)動菜單。學(xué)生登錄后能看到的包括優(yōu)秀項(xiàng)目、項(xiàng)目信息、評審方案、大創(chuàng)資訊、項(xiàng)目申報管理、項(xiàng)目中檢管理、項(xiàng)目結(jié)項(xiàng)管理、項(xiàng)目評審管理、專家評審管理。指導(dǎo)老師比學(xué)生多了個人中心、優(yōu)秀項(xiàng)目管理、項(xiàng)目類型管理、項(xiàng)目信息管理這些模塊并在項(xiàng)目申報、中檢、結(jié)項(xiàng)、評審環(huán)節(jié)擁有審核入口。院系管理員的菜單覆蓋最全還額外負(fù)責(zé)評審方案管理和專家評審的統(tǒng)籌分配。功能模塊學(xué)生指導(dǎo)老師院系管理員大創(chuàng)資訊查看查看管理優(yōu)秀項(xiàng)目查看管理管理項(xiàng)目類型查看管理管理項(xiàng)目申報提交/查看審核審核/分配項(xiàng)目中檢提交材料審核審核項(xiàng)目結(jié)項(xiàng)提交材料審核審核評審方案查看管理管理專家評審查看結(jié)果參與評審分配專家這種設(shè)計(jì)本質(zhì)上是一種基于 RBAC 的權(quán)限模型。數(shù)據(jù)庫中不直接給用戶表加一堆是否管理員字段而是通過 role 字段區(qū)分身份登錄后把角色寫入 session前端菜單按角色渲染后端在 Controller 或攔截器里再做一次放行判斷。院系管理員和指導(dǎo)老師的菜單高度相似但操作對象不同管理員管的是全院項(xiàng)目老師只管自己名下學(xué)生申報的項(xiàng)目。因此業(yè)務(wù)代碼中所有列表查詢都要帶上范圍條件管理員按院系過濾老師按關(guān)聯(lián)的學(xué)生 id 過濾。從實(shí)現(xiàn)上講角色和狀態(tài)往往比按鈕級別的權(quán)限更好落地。多數(shù)學(xué)校的信息化系統(tǒng)中一個項(xiàng)目記錄會經(jīng)歷“草稿—已提交—老師通過—管理員通過—中檢提交—中檢通過—結(jié)項(xiàng)提交—結(jié)項(xiàng)通過”的狀態(tài)鏈。把狀態(tài)設(shè)計(jì)成一個 int 字段0 表示草稿1 表示已提交2 表示指導(dǎo)老師已審核3 表示院系管理員已審核這樣查詢進(jìn)度時一條 SELECT 就能完成不需要引入復(fù)雜的工作流引擎。2.3 數(shù)據(jù)庫核心表設(shè)計(jì)字段、類型與實(shí)體關(guān)系從論文中的 E-R 圖可以還原出這樣幾條核心實(shí)體用戶、大創(chuàng)資訊、評審方案、項(xiàng)目信息、項(xiàng)目申報、中檢記錄、結(jié)項(xiàng)記錄、專家評審結(jié)果。實(shí)際工程里為了減少關(guān)聯(lián)復(fù)雜度通常會把學(xué)生、指導(dǎo)老師、管理員統(tǒng)一放在 user 表里用 role 字段區(qū)分項(xiàng)目申報表單獨(dú)存學(xué)生和指導(dǎo)老師的 id。大創(chuàng)資訊表是常見的資訊發(fā)布結(jié)構(gòu)字段包括標(biāo)題、簡介、圖片、內(nèi)容、創(chuàng)建時間。這里重點(diǎn)拆一下評審方案表的字段來源標(biāo)題、圖片、創(chuàng)新點(diǎn)、前期準(zhǔn)備、實(shí)施方案、預(yù)期成果、經(jīng)費(fèi)預(yù)算、成員素質(zhì)、創(chuàng)建時間。這些字段在數(shù)據(jù)庫層幾乎都是 varchar 或 longtext因?yàn)樵u審老師要寫的是大段文字不適合把長度卡死。CREATE TABLE review_plan ( id bigint(20) NOT NULL AUTO_INCREMENT COMMENT 主鍵, addtime timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT 創(chuàng)建時間, title varchar(200) NOT NULL COMMENT 評審方案標(biāo)題, picture varchar(200) DEFAULT NULL COMMENT 封面圖, innovation longtext COMMENT 創(chuàng)新點(diǎn), preparation longtext COMMENT 前期準(zhǔn)備, implementation longtext COMMENT 實(shí)施方案, expected_result longtext COMMENT 預(yù)期成果, budget decimal(10,2) DEFAULT NULL COMMENT 經(jīng)費(fèi)預(yù)算, member_quality longtext COMMENT 成員素質(zhì), PRIMARY KEY (id) ) ENGINEInnoDB AUTO_INCREMENT1 DEFAULT CHARSETutf8mb4 COMMENT評審方案;這張表的字段順序與論文里的實(shí)體屬性圖一致addtime 用于在列表頁按時間倒序排列title 經(jīng)常作為查詢條件建議加普通索引。budget 用 decimal 而不是 float是為了避免在經(jīng)費(fèi)統(tǒng)計(jì)時出現(xiàn)精度誤差這是金額字段的通用寫法。longtext 類型在 MySQL 下最多能存 4GB用來放創(chuàng)新點(diǎn)、實(shí)施方案這類多行文本完全夠用。項(xiàng)目申報表、中檢表、結(jié)項(xiàng)表建議共用一套 id 和 project_id 關(guān)聯(lián)設(shè)計(jì)而不是各自獨(dú)立建無關(guān)聯(lián)的大寬表。比如 project_info 表保存項(xiàng)目名稱、項(xiàng)目類型、負(fù)責(zé)人、指導(dǎo)老師、所屬院系project_declaration 表保存申報書的詳細(xì)內(nèi)容midcheck 和 completion 表分別保存過程材料。這樣一次申報對應(yīng)一條 project_info后續(xù)中檢和結(jié)項(xiàng)都通過 project_id 找到這條記錄統(tǒng)計(jì)全校在研項(xiàng)目時也只需要 count project_info 表。3. 核心模塊拆解一個項(xiàng)目從申報到結(jié)項(xiàng)的完整鏈路3.1 登錄認(rèn)證與攔截器權(quán)限控制登錄模塊看起來簡單實(shí)際上是整個系統(tǒng)的安全邊界。常見做法是使用 Spring Boot 攔截器在 WebMvcConfigurer 里注冊一個 HandlerInterceptorpreHandle 方法中從 session 里取用戶信息取不到就重定向到登錄頁。這里要注意放行路徑的配置登錄接口、靜態(tài)資源圖片、CSS、JS 必須排除在攔截范圍之外否則用戶連登錄頁的背景圖都加載不出來。public class LoginInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { Object user request.getSession().getAttribute(loginUser); if (user null) { // 未登錄統(tǒng)一跳轉(zhuǎn)到登錄頁 response.sendRedirect(request.getContextPath() /login); return false; } // 登錄后把角色放進(jìn) request方便 Controller 里做功能開關(guān) request.setAttribute(role, ((User) user).getRole()); return true; } }加上 WebMvcConfigurer 后攔截器只對 /admin/、/student/、/teacher/** 這類業(yè)務(wù)路徑生效。這里有一個容易翻車的點(diǎn)如果你把 /** 全部攔截Spring Boot 默認(rèn)的 favicon 請求也會被攔瀏覽器會一直轉(zhuǎn)圈控制臺一片空白排查起來很玄學(xué)。我的習(xí)慣是把放行列表寫成靜態(tài)資源目錄加登錄接口能少踩很多坑。角色判斷不要只依賴前端隱藏按鈕后端在保存申報時還要校驗(yàn)當(dāng)前登錄用戶的角色否則用戶直接構(gòu)造 POST 請求就能繞過界面限制。3.2 項(xiàng)目申報模塊學(xué)生提交、指導(dǎo)老師審核項(xiàng)目申報是整條管理鏈路的起點(diǎn)。學(xué)生打開申報頁面選擇項(xiàng)目類型填寫項(xiàng)目名稱、成員、指導(dǎo)老師、申報書內(nèi)容提交后生成一條 status1 的數(shù)據(jù)。此時指導(dǎo)老師登錄個人中心看到待審核列表點(diǎn)擊通過后狀態(tài)變?yōu)?2進(jìn)入管理員審核環(huán)節(jié)。這個推進(jìn)過程用 Service 層的一個方法就能完成。Service public class ProjectDeclarationService { Autowired private ProjectDeclarationMapper declarationMapper; Transactional(rollbackFor Exception.class) public void submitDeclaration(ProjectDeclaration declaration) { // 首次提交狀態(tài)置 1寫入提交時間 if (declaration.getId() null) { declaration.setStatus(1); declaration.setSubmitTime(new Date()); declarationMapper.insert(declaration); } else { // 被退回后再次提交回到待審核狀態(tài) declaration.setStatus(1); declarationMapper.updateById(declaration); } } public void auditDeclaration(Long declarationId, Integer auditResult) { ProjectDeclaration record declarationMapper.selectById(declarationId); if (auditResult 2) { // 老師審核通過 record.setStatus(2); record.setAuditOpinion(同意立項(xiàng)); } else { // 審核不通過退給學(xué)生修改學(xué)生端能看到退回意見 record.setStatus(0); record.setAuditOpinion(請補(bǔ)充實(shí)施方案后再提交); } declarationMapper.updateById(record); } }submitDeclaration 中id 為空代表第一次申報id 不為空代表被退回后的重新提交狀態(tài)統(tǒng)一回到 1。auditDeclaration 是典型的審核邏輯結(jié)果值用 2 表示通過、0 表示退回而不是用布爾字段因?yàn)楹罄m(xù)管理員還會加一層審核int 狀態(tài)可以繼續(xù)向后擴(kuò)展。Transactional 保證寫入申報主表和更新狀態(tài)這兩個操作要么同時成功要么一起回滾防止出現(xiàn)項(xiàng)目記錄寫進(jìn)去了但狀態(tài)沒更新的臟數(shù)據(jù)。3.3 項(xiàng)目中檢與結(jié)項(xiàng)管理狀態(tài)流轉(zhuǎn)的實(shí)現(xiàn)申報通過后項(xiàng)目進(jìn)入執(zhí)行期學(xué)生需要在指定時間提交中檢材料包括進(jìn)度說明、階段性成果、經(jīng)費(fèi)使用情況。這里的核心是狀態(tài)流轉(zhuǎn)當(dāng)前狀態(tài)為 3已立項(xiàng)時允許提交中檢中檢通過后變?yōu)?4到結(jié)項(xiàng)階段學(xué)生上傳結(jié)題報告、成果附件老師審核后狀態(tài)變?yōu)?5管理員最終確認(rèn)后變?yōu)?6項(xiàng)目閉環(huán)。public static final int STATUS_PROJECT_STARTED 3; public static final int STATUS_MIDCHECK_PASSED 4; public static final int STATUS_COMPLETION_PASSED 5; public static final int STATUS_FINAL_APPROVED 6; public void updateProjectStatus(Long projectId, int currentStatus, int targetStatus) { ProjectInfo project projectInfoMapper.selectById(projectId); if (project.getStatus() ! currentStatus) { throw new IllegalStateException(當(dāng)前項(xiàng)目狀態(tài)不允許此操作); } project.setStatus(targetStatus); projectInfoMapper.updateById(project); }這段代碼寫得很克制但恰好把狀態(tài)機(jī)最常見的兩個問題避開了。第一個問題是越級操作比如項(xiàng)目還沒中檢就直接提交結(jié)項(xiàng)所以方法入?yún)Я?currentStatus 做前置校驗(yàn)與數(shù)據(jù)庫里的當(dāng)前狀態(tài)不一致就拋異常。第二個問題是并發(fā)提交兩個頁面同時點(diǎn)擊提交時最后一次 update 可能覆蓋前面的狀態(tài)因此工程落地時我一般會在 project_info 表加 version 字段做樂觀鎖update 語句帶上 where version #{oldVersion}而不是只做讀后寫。中檢表和結(jié)項(xiàng)表本質(zhì)上都是過程表存的是各個節(jié)點(diǎn)上傳的附件路徑和審核意見它們不需要復(fù)制項(xiàng)目的所有信息只存 project_id、材料路徑、意見、時間即可。列表頁顯示進(jìn)度時通過 join project_info 一次性查出項(xiàng)目標(biāo)題、負(fù)責(zé)人、當(dāng)前狀態(tài)比在 Java 里循環(huán)查詢要快得多這也是 MyBatis 寫多表關(guān)聯(lián)的常見價值點(diǎn)。3.4 評審方案與專家評審評分?jǐn)?shù)據(jù)的入庫邏輯評審模塊是這個系統(tǒng)的特色模塊。院系管理員先創(chuàng)建評審方案確定評審指標(biāo)比如創(chuàng)新點(diǎn)、前期準(zhǔn)備、實(shí)施方案、預(yù)期成果、經(jīng)費(fèi)預(yù)算、成員素質(zhì)然后指定專家賬號專家登錄后對待評審項(xiàng)目逐項(xiàng)打分。打分?jǐn)?shù)據(jù)不是直接更新項(xiàng)目表而是單獨(dú)落一張 expert_review 表保存方案 id、項(xiàng)目 id、專家 id、各項(xiàng)分?jǐn)?shù)和總分。insert idinsertExpertReview parameterTypemap INSERT INTO expert_review ( plan_id, project_id, expert_id, innovation_score, preparation_score, implementation_score, result_score, total_score, create_time ) VALUES ( #{planId}, #{projectId}, #{expertId}, #{innovationScore}, #{preparationScore}, #{implementationScore}, #{resultScore}, #{innovationScore} #{preparationScore} #{implementationScore} #{resultScore}, NOW() ) /insert這里用 MySQL 的表達(dá)式直接把四項(xiàng)指標(biāo)相加避免應(yīng)用層先算一遍再傳值。參數(shù) Map 傳值比實(shí)體傳值更靈活但可讀性差一些項(xiàng)目里如果指標(biāo)字段固定不變我更建議寫一個 ExpertReview 實(shí)體類用 Param 綁定業(yè)務(wù)含義清晰的參數(shù)名?？偡钟?jì)算放在 SQL 層還有一個好處就是即便應(yīng)用層漏傳了 totalScore數(shù)據(jù)庫也會自動生成不會留下 null。專家評審的結(jié)果讀出來后頁面展示的通常是統(tǒng)計(jì)圖表這個統(tǒng)計(jì)邏輯一般放在 Controller 層組裝返回給前端的是一個結(jié)構(gòu)清晰的指標(biāo)列表。這里要注意評審結(jié)果表是按專家 ID 存的同一位專家可能既評審項(xiàng)目 A 又評審項(xiàng)目 B所以列表查詢必須先按 project_id 分組再用 AVG 聚合否則 join 項(xiàng)目表時會出現(xiàn)行數(shù)翻倍的問題。多個項(xiàng)目踩到過這個“關(guān)聯(lián)查詢行數(shù)翻倍”解決方案就是 group by project_id 后再 join不要反過來先 join 再 group。4. 本地跑通環(huán)境準(zhǔn)備、配置與啟動4.1 開發(fā)環(huán)境與項(xiàng)目目錄結(jié)構(gòu)跑這個項(xiàng)目不需要太新的機(jī)器JDK 1.8、Maven 3.6、MySQL 5.7 或 8.0再加一個 IDEA 或 Eclipse 就能啟動。代碼是標(biāo)準(zhǔn)的 Spring Boot 工程結(jié)構(gòu)包名一般以項(xiàng)目縮寫為根下面是 config、controller、service、mapper、entity、common 幾個包。config 里放 WebMvc 配置和攔截器注冊controller 按學(xué)生端、老師端、管理員端分開mapper 里是接口和 XML 文件。src/main/java/com/dachuang ├── config # WebMvc 配置、攔截器注冊 ├── controller # 學(xué)生、指導(dǎo)老師、院系管理員端口 ├── service # 業(yè)務(wù)層接口與實(shí)現(xiàn) ├── mapper # MyBatis Mapper 接口 ├── entity # 實(shí)體類對應(yīng)數(shù)據(jù)庫表 └── common # 常量、工具類、統(tǒng)一返回結(jié)果resource 目錄下放著 application.yml、靜態(tài)頁面資源或 templates、mapper XML 目錄。拿到資源后先不要急著啟動第一步是把整個目錄導(dǎo)入 IDEA選擇 Maven 項(xiàng)目等待依賴下載完成。如果網(wǎng)絡(luò)不穩(wěn)定導(dǎo)致依賴下載失敗可以去本地 Maven 倉庫把 lastUpdated 后綴的文件清理掉再重新導(dǎo)入這比反復(fù)點(diǎn)刷新有用得多。4.2 MySQL 建庫建表與數(shù)據(jù)初始化源碼包里一般會附帶一個 dachuang.sql 或類似名稱的數(shù)據(jù)庫腳本里面包含建庫語句、建表語句和初始數(shù)據(jù)。先用命令行或 Navicat 執(zhí)行腳本再確認(rèn)三張基礎(chǔ)表的數(shù)據(jù)user 表里應(yīng)該初始化了學(xué)生、指導(dǎo)老師、院系管理員三個賬號review_plan 表可能有一條示例評審方案大創(chuàng)資訊表有一條可展示的資訊記錄。mysql -uroot -p CREATE DATABASE IF NOT EXISTS dachuang DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; USE dachuang; SOURCE dachuang.sql;這里強(qiáng)烈建議手動指定 utf8mb4尤其是 MySQL 8.0 環(huán)境。很多跑不起來的問題都出在數(shù)據(jù)庫默認(rèn)字符集是 latin1導(dǎo)致后續(xù)中文亂碼的排查非常痛苦。執(zhí)行完腳本后用 SHOW TABLES 看一眼表數(shù)量再用 SELECT * FROM user; 驗(yàn)證賬號數(shù)據(jù)是否存在確認(rèn)無誤后再去改配置文件。4.3 application.yml 配置與啟動步驟數(shù)據(jù)庫腳本導(dǎo)入成功后唯一必須改的就是 application.yml 里的連接信息。把 password 改成你本機(jī) MySQL 的密碼如果你本機(jī) MySQL 端口不是 3306url 里的端口也要一起改。如果導(dǎo)入的庫名不是 dachuang記得同步修改 url 中的庫名。改完后直接運(yùn)行啟動類控制臺出現(xiàn) Tomcat started on port 8080 就說明啟動成功。mvn clean package -DskipTests java -jar target/dachuang-system-1.0.0.jar也可以直接用 IDEA 運(yùn)行主類開發(fā)階段這種方式調(diào)試更順手。啟動成功后瀏覽器訪問 http://localhost:8080/login能打開登錄頁說明基礎(chǔ)環(huán)境沒有問題。登錄頁可以先用數(shù)據(jù)庫里初始化的管理員賬號試一遍確認(rèn)三條角色的菜單渲染都正常。如果頁面樣式缺失多半是靜態(tài)資源路徑問題后面避坑章節(jié)會專門講。4.4 頁面路徑與功能驗(yàn)證清單系統(tǒng)登錄后建議按下面這張清單把主要鏈路走一遍而不是隨機(jī)點(diǎn)點(diǎn)點(diǎn)。走通一次完整流程基本就能斷定代碼有沒有被改壞。驗(yàn)證步驟操作路徑預(yù)期結(jié)果學(xué)生注冊登錄注冊頁面注冊后可以正常登錄并進(jìn)入學(xué)生端項(xiàng)目申報學(xué)生端菜單提交后狀態(tài)變?yōu)榇龑徍死蠋煂徍酥笇?dǎo)老師端菜單審核后狀態(tài)推進(jìn)到下一環(huán)節(jié)管理員分配評審院系管理員菜單評審方案可以關(guān)聯(lián)指定專家專家打分評審賬號登錄打分保存后總分正確驗(yàn)證過程中重點(diǎn)看兩個目前項(xiàng)目里容易出問題的地方一是學(xué)生提交項(xiàng)目后指導(dǎo)老師列表里能否立刻看到二是專家評審打分后院系管理員的統(tǒng)計(jì)頁是否能匯總出平均分。這兩條鏈路分別對應(yīng)申報審核和評審入庫是系統(tǒng)最核心的業(yè)務(wù)閉環(huán)。5. 避坑指南啟動報錯、權(quán)限失效與數(shù)據(jù)庫時區(qū)的 5 個常見問題5.1 啟動直接報錯端口被占用現(xiàn)象控制臺打印 Port 8080 was already in use應(yīng)用啟動后立刻退出。原因上一次運(yùn)行未完全關(guān)閉或者本地其他服務(wù)占了 8080 端口。解決先找到占用進(jìn)程殺掉后再啟動。Linux 或 macOS 下用 lsof -i:8080 查看占用進(jìn)程Windows 下用 netstat -ano | findstr 8080 拿到 PID然后 taskkill /PID 對應(yīng)編號 /F。如果不想殺進(jìn)程也可以直接把 application.yml 里的 server.port 改成 8090改動一處即可不影響其他功能。5.2 數(shù)據(jù)庫連接失敗時區(qū)與驅(qū)動版本不匹配現(xiàn)象啟動時報 Communications link failure 或 The server time zone value is unrecognized。原因新版 MySQL Connector/J 要求明確指定時區(qū)舊版本驅(qū)動則不需要如果驅(qū)動版本和 MySQL 版本差距太大還會出現(xiàn)認(rèn)證插件不兼容的問題。解決在 datasource.url 后追加 serverTimezoneAsia/Shanghai并確保 driver-class-name 是 com.mysql.cj.jdbc.Driver。注意 Asia 和 Shanghai 之間不要拼錯拼錯會直接報 unrecognized。如果項(xiàng)目用的還是 5.x 老驅(qū)動建議升級到 8.x因?yàn)樾掳骝?qū)動對 MySQL 8.0 的 caching_sha2_password 認(rèn)證支持更好。5.3 登錄后頁面跳轉(zhuǎn)異常攔截器放行路徑配置錯了現(xiàn)象登錄成功后跳轉(zhuǎn)主頁卻一眨眼被彈回登錄頁或者靜態(tài) CSS、JS 全部 404。原因攔截器把登錄接口和靜態(tài)資源也攔了preHandle 里拿不到 session 中的 loginUser于是強(qiáng)制重定向。解決檢查 WebMvcConfigurer 里 addInterceptors 注冊的路徑登錄接口、注冊接口、/static/、/js/、/css/、/images/都要 addPathPatterns 放行。判斷攔截器是否生效可以在 preHandle 里臨時加一行日志打印請求 URI啟動后一次就能看清哪個路徑被誤攔截。5.4 中文亂碼三次傳遞出現(xiàn)編碼不一致現(xiàn)象頁面顯示正常但提交到數(shù)據(jù)庫的中文變成問號或者從數(shù)據(jù)庫讀出來亂碼。原因頁面編碼、連接參數(shù)、數(shù)據(jù)庫字符集三者沒統(tǒng)一。常見組合是頁面用了 UTF-8連接 URL 少了 characterEncodingutf8數(shù)據(jù)庫表卻是 latin1。解決頁面統(tǒng)一 UTF-8連接 URL 加上 useUnicodetruecharacterEncodingutf8建表時用 utf8mb4。項(xiàng)目里導(dǎo)出的 SQL 文件如果是舊的建議執(zhí)行前先檢查表定義把 CHARSETlatin1 改成 utf8mb4 再導(dǎo)入。修改后重啟服務(wù)、重新提交一次數(shù)據(jù)不要只在數(shù)據(jù)庫端做轉(zhuǎn)換那治標(biāo)不治本。5.5 圖片上傳后無法顯示靜態(tài)資源映射缺失現(xiàn)象項(xiàng)目申報時上傳的圖片保存成功但在頁面里 img 標(biāo)簽訪問時返回 404。原因Spring Boot 默認(rèn)只映射 classpath 下的靜態(tài)目錄你上傳到磁盤絕對路徑的圖片不在默認(rèn)映射范圍內(nèi)。解決寫一個 WebMvcConfigurer 的配置類把本地磁盤目錄映射到 /upload/** 訪問路徑。常見做法是 addResourceHandlers設(shè)置 file:D:/dachuang/upload/ 這樣的物理路徑。注意路徑末尾要加分隔符否則映射會失效。這種問題只靠前臺不好查打開瀏覽器開發(fā)者工具看圖片請求的響應(yīng)狀態(tài)碼404 基本就是映射沒配。6. 二次開發(fā)改造從新增字段到擴(kuò)展評審流程6.1 新增“項(xiàng)目經(jīng)費(fèi)”字段的完整流程如果想把經(jīng)費(fèi)預(yù)算從評審方案表挪到項(xiàng)目申報表改造的最小閉環(huán)是先在 project_declaration 表加字段 ALTER TABLE project_declaration ADD COLUMN budget decimal(10,2) DEFAULT NULL;再在實(shí)體類里加上對應(yīng)的 BigDecimal 屬性然后在 Mapper 的 XML 里新增一條 update 語句最后把前端表單里的輸入框 name 屬性改成和實(shí)體字段一致。這條鏈路看著簡單但漏掉任何一環(huán)都會出問題漏了 XML 字段更新時靜默失敗漏了前端 name提交后拿不到值。6.2 把單次評審改成多輪評審目前評審方案是一次打分定結(jié)果如果想改成初賽、復(fù)賽兩輪不需要改庫直接在 expert_review 表加一個 round 字段默認(rèn) 1。查詢時 where plan_id ? and round 2 就能區(qū)分輪次。統(tǒng)計(jì)平均分時也要按 round 分組否則初賽復(fù)賽分?jǐn)?shù)會混在一起。這個改動的好處是不動主表結(jié)構(gòu)只加一個帶默認(rèn)值的字段對已有數(shù)據(jù)零影響。從那以后我每次接手這類 Spring Boot 管理項(xiàng)目都會強(qiáng)制走一遍“先看表設(shè)計(jì)再看狀態(tài)流最后寫頁面對接”的順序而不是拿到代碼就跑。先花十分鐘弄清楚每個狀態(tài)數(shù)字代表什么、哪張表和哪張表是主外鍵關(guān)系后面改功能、修 BUG 都會順利很多。希望幫到你。本文還有配套的精品資源點(diǎn)擊獲取