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