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