數(shù)學(xué)競賽類網(wǎng)站這套題目在畢業(yè)設(shè)計(jì)里真的算常青樹了。每年都有大量學(xué)生做類似選題但大多數(shù)版本都停留在“能跑就行”的狀態(tài)代碼結(jié)構(gòu)、業(yè)務(wù)邏輯、部署方式都存在不少隱患。這篇文章我結(jié)合自己帶過的項(xiàng)目經(jīng)驗(yàn)把基于JavaSSMFlask混合架構(gòu)的數(shù)學(xué)競賽網(wǎng)站從設(shè)計(jì)思路、核心代碼、部署調(diào)試到排坑過程完整拆開講一遍適合正在做畢設(shè)、課設(shè)或者想自己搭一個(gè)數(shù)學(xué)練習(xí)與競賽平臺的開發(fā)者參考。1. 項(xiàng)目整體設(shè)計(jì)與技術(shù)選型思路1.1 為什么用JavaSSMFlask這種混合架構(gòu)拿到“數(shù)學(xué)競賽網(wǎng)站”這個(gè)題目第一步要做的不是急著寫代碼而是先把技術(shù)架構(gòu)定下來。目前市面上的方案大致分三類純JavaSSM或SpringBoot、純PythonDjango或Flask、前后端分離VueSpringBoot。而標(biāo)題里這個(gè)組合——JavaSSMFlask看起來有點(diǎn)“混搭”實(shí)際卻是很多高校畢業(yè)設(shè)計(jì)里非常實(shí)用的方案背后其實(shí)有很現(xiàn)實(shí)的考慮。SSMSpringSpringMVCMyBatis是Java后端里非常經(jīng)典的組合它穩(wěn)、資料多、面試也常問。用SSM來做網(wǎng)站的主體業(yè)務(wù)比如用戶登錄、試題管理、競賽發(fā)布、成績記錄這些核心模塊是非常穩(wěn)妥的。而Flask作為Python端的輕量框架非常適合做兩件事一是實(shí)現(xiàn)一些需要快速開發(fā)的輔助接口比如智能組卷、成績統(tǒng)計(jì)分析、爬蟲抓取競賽資訊等二是為Java端提供一個(gè)可調(diào)用的Python服務(wù)方便展示“多種技術(shù)棧協(xié)作”的能力這在畢業(yè)設(shè)計(jì)的答辯中是一個(gè)很加分的亮點(diǎn)。當(dāng)然也有很多人會問為什么不直接用SpringBoot代替SSM說實(shí)話如果是從零開始自己做項(xiàng)目SpringBoot確實(shí)更省事。但很多高校的課程體系和畢設(shè)大綱還停留在SSM階段題目要求里明確寫了“基于SSM”所以標(biāo)題里保留SSM是有原因的。再說了SSM雖然配置繁瑣但恰恰是這種繁瑣能逼著你把Spring的IOC、AOP、MyBatis的映射機(jī)制這些東西真正弄明白而不是像用SpringBoot那樣把一切都自動屏蔽掉。1.2 前端與數(shù)據(jù)交互的設(shè)計(jì)考量前端部分大多數(shù)數(shù)學(xué)競賽網(wǎng)站用的都是服務(wù)端渲染加少量Ajax的方式。用Thymeleaf或者JSP來渲染頁面配合jQuery和Bootstrap做交互。這種方案的好處是開發(fā)速度快、對SEO友好、調(diào)試也直觀特別適合課設(shè)畢設(shè)這種時(shí)間緊、任務(wù)重的場景。數(shù)據(jù)交互方面Java端和Flask端的通信我推薦兩種方式方式一Java端通過HTTP Client比如RestTemplate或OkHttp調(diào)用Flask的RESTful接口這種方式邏輯清晰兩端完全解耦。方式二共用同一個(gè)MySQL數(shù)據(jù)庫Java負(fù)責(zé)寫Flask負(fù)責(zé)讀然后通過Redis做緩存同步。這種方式少了一層HTTP調(diào)用性能更好一點(diǎn)但要注意數(shù)據(jù)一致性問題。我自己在做類似項(xiàng)目時(shí)更喜歡方式一。原因很簡單Java和Flask各自維護(hù)獨(dú)立的業(yè)務(wù)邊界接口文檔寫清楚聯(lián)調(diào)的時(shí)候不容易出“這個(gè)字段誰改的”這種扯皮問題。而且答辯時(shí)展示兩端獨(dú)立部署、通過接口通信比“共用一個(gè)庫”聽起來更有技術(shù)含量。1.3 核心功能模塊拆解一個(gè)完整的數(shù)學(xué)競賽網(wǎng)站至少要包含以下模塊這也是評閱老師重點(diǎn)看的部分。我列一個(gè)表格方便對照模塊名稱核心功能技術(shù)要點(diǎn)用戶模塊注冊、登錄、個(gè)人信息維護(hù)Session管理、密碼加密、驗(yàn)證碼試題模塊試題錄入、分類、檢索、在線答題批量導(dǎo)入、分頁查詢、題目類型區(qū)分競賽模塊發(fā)布競賽、在線報(bào)名、模擬競賽時(shí)間控制、競賽狀態(tài)機(jī)、防作弊成績模塊自動判分、成績排名、統(tǒng)計(jì)分析判定規(guī)則、成績可視化資訊模塊競賽公告、數(shù)學(xué)文章展示富文本發(fā)布、分類展示管理后臺用戶管理、試題審核、數(shù)據(jù)統(tǒng)計(jì)權(quán)限控制、圖表展示這六大模塊基本覆蓋了“數(shù)學(xué)競賽網(wǎng)站”“數(shù)學(xué)練習(xí)網(wǎng)站”“數(shù)學(xué)學(xué)習(xí)資源”這些熱詞的全部需求。后面我會重點(diǎn)挑幾個(gè)容易出問題的模塊詳細(xì)講代碼實(shí)現(xiàn)和踩坑過程。2. 核心業(yè)務(wù)模塊詳解與代碼實(shí)現(xiàn)2.1 用戶登錄與權(quán)限控制的正確姿勢用戶模塊看起來簡單但登錄態(tài)管理和權(quán)限控制是做網(wǎng)站最容易出安全隱患的地方。很多同學(xué)的代碼里登錄就是查一下用戶名密碼對不對然后把用戶ID存在session里就完事了。這種做法在課設(shè)答辯中勉強(qiáng)能過但實(shí)際上漏洞挺多的。我建議的做法是分三層第一層表單提交時(shí)用JS做一次基礎(chǔ)校驗(yàn)比如用戶名非空、密碼長度限制這層是為了用戶體驗(yàn)。第二層后端Controller里再做一次嚴(yán)格的參數(shù)校驗(yàn)防SQL注入和XSS攻擊。比如MyBatis里一定要用#{}而不是${}因?yàn)?{}是字符串拼接很容易被注入。第三層密碼不能明文存數(shù)據(jù)庫。至少要用MD5加鹽或者直接用BCrypt。我通常用Spring自帶的BCryptPasswordEncoder每次校驗(yàn)時(shí)把用戶輸入的密碼和數(shù)據(jù)庫里的哈希值做比對。// 用戶登錄的Service層核心邏輯 public User login(String username, String password) { User user userMapper.findByUsername(username); if (user null) { throw new BusinessException(用戶名不存在); } // BCrypt校驗(yàn)password是用戶輸入的明文user.getPassword()是庫里的哈希值 if (!bcryptPasswordEncoder.matches(password, user.getPassword())) { throw new BusinessException(密碼錯(cuò)誤); } // 更新最后登錄時(shí)間 userMapper.updateLastLoginTime(user.getId()); return user; }權(quán)限控制方面用一個(gè)攔截器就夠了。定義一個(gè)LoginInterceptor重寫preHandle方法檢查session里有沒有user信息。沒有就重定向到登錄頁。然后Admin相關(guān)的請求再檢查這個(gè)用戶的角色字段是不是“admin”。注意角色判斷不能只在前端隱藏按鈕后端接口必須也校驗(yàn)否則別人直接構(gòu)造請求就能刪數(shù)據(jù)了。2.2 試題管理從批量錄入到智能組卷試題管理是數(shù)學(xué)競賽網(wǎng)站的核心也是工作量最大的部分。一道題要有題干、選項(xiàng)如果是選擇題、正確答案、解析、難度等級、知識點(diǎn)標(biāo)簽。在數(shù)據(jù)庫設(shè)計(jì)中我建議把題目基礎(chǔ)信息放一張表題目和知識點(diǎn)的關(guān)聯(lián)關(guān)系放另一張表采用多對多的設(shè)計(jì)。這樣后面做篩選、分組、統(tǒng)計(jì)都非常方便。批量錄入這塊很多同學(xué)是一個(gè)個(gè)在后臺手輸太累了。比較實(shí)用的做法是支持Excel導(dǎo)入。我用的是Apache POI前端上傳xlsx文件后端解析每一行校驗(yàn)字段完整性后逐條插入數(shù)據(jù)庫。// 使用POI讀取Excel的簡化代碼 Workbook workbook WorkbookFactory.create(inputStream); Sheet sheet workbook.getSheetAt(0); for (Row row : sheet) { if (row.getRowNum() 0) { continue; // 跳過表頭 } Question question new Question(); question.setContent(row.getCell(0).getStringCellValue()); question.setType(row.getCell(1).getStringCellValue()); question.setAnswer(row.getCell(2).getStringCellValue()); question.setDifficulty(row.getCell(3).getNumericCellValue()); questionService.addQuestion(question); }這里有個(gè)坑POI讀取單元格時(shí)數(shù)字類型的cell要用getNumericCellValue字符串類型要用getStringCellValue如果不提前判斷getCellType()很容易拋異常。我在這上面吃過虧后來都寫了統(tǒng)一的解析工具類把所有cell值都先轉(zhuǎn)成字符串再處理。智能組卷是一個(gè)加分功能。簡單版本的做法是根據(jù)用戶選擇的知識點(diǎn)、難度分布和題量先從數(shù)據(jù)庫里把符合條件的題目全部查出來然后按比例隨機(jī)抽取。稍微智能一點(diǎn)可以給每道題設(shè)置一個(gè)權(quán)重值比如最近被抽中次數(shù)多的題目權(quán)重降低實(shí)現(xiàn)“不重復(fù)刷題”的學(xué)習(xí)體驗(yàn)。這個(gè)邏輯用SQL加Java配合很容易實(shí)現(xiàn)。2.3 競賽流程設(shè)計(jì)報(bào)名、開賽、交卷、判分?jǐn)?shù)學(xué)競賽網(wǎng)站里的“競賽”功能核心難點(diǎn)在于時(shí)間控制和狀態(tài)流轉(zhuǎn)。一場競賽的狀態(tài)我一般設(shè)計(jì)為四個(gè)未開始、進(jìn)行中、已結(jié)束、已發(fā)布成績。整個(gè)流程是這樣的管理員創(chuàng)建競賽設(shè)置開始時(shí)間、結(jié)束時(shí)間、參賽限制。用戶瀏覽競賽列表在“未開始”狀態(tài)下可以報(bào)名。到了開始時(shí)間競賽狀態(tài)自動變?yōu)椤斑M(jìn)行中”用戶可以進(jìn)入答題頁面。用戶交卷或時(shí)間截止自動交卷進(jìn)入判分環(huán)節(jié)。所有參賽者成績統(tǒng)計(jì)完成后管理員發(fā)布成績用戶可以看到排名。狀態(tài)判斷有個(gè)細(xì)節(jié)不能只靠前端按鈕控制顯示后端每次請求競賽詳情時(shí)都要根據(jù)當(dāng)前時(shí)間動態(tài)判斷狀態(tài)。因?yàn)橛脩敉耆梢岳@過前端直接調(diào)接口獲取題目。所以我的做法是在Service層寫一個(gè)getCompetitionStatus(Competition competition)方法每次請求都實(shí)時(shí)計(jì)算保證業(yè)務(wù)邏輯安全。交卷判分這塊如果題目全是選擇題和判斷題那判分就很簡單——遍歷用戶的答案跟正確答案比對就行。但數(shù)學(xué)競賽往往有填空題和解答題。填空題要注意答案格式的統(tǒng)一比如“3/4”和“0.75”本質(zhì)等價(jià)但字符串比對認(rèn)為是不同的。我的處理辦法是填空題設(shè)置多個(gè)可接受的答案或者用正則做歸一化比較。解答題則需要人工閱卷我的做法是系統(tǒng)先自動判選擇和填空把得分記錄下來然后管理員在后臺對解答題進(jìn)行評分最終分?jǐn)?shù)等于兩部分之和。2.4 Flask端輔助功能成績分析與資訊接口Flask在整個(gè)項(xiàng)目里的角色是一個(gè)Python輔助服務(wù)。我主要讓它干三件事成績數(shù)據(jù)分析、競賽資訊采集、模擬成績預(yù)測。成績分析這塊Flask通過HTTP接口接收J(rèn)ava端傳過來的成績數(shù)據(jù)JSON格式然后用Pandas做統(tǒng)計(jì)計(jì)算比如平均分、最高分、分?jǐn)?shù)段分布再配合Matplotlib生成一張圖片返回給Java端Java端直接在前端頁面上展示。這樣圖表繪制完全不用Java代碼省了很多麻煩。from flask import Flask, request, jsonify import pandas as pd import matplotlib.pyplot as plt import io import base64 app Flask(__name__) app.route(/api/analyze, methods[POST]) def analyze(): data request.get_json() # Java端傳過來的成績列表 df pd.DataFrame(data) avg_score df[score].mean() max_score df[score].max() # 生成分?jǐn)?shù)分布圖轉(zhuǎn)base64返回 plt.hist(df[score], bins10) buf io.BytesIO() plt.savefig(buf, formatpng) buf.seek(0) img_base64 base64.b64encode(buf.read()).decode(utf-8) return jsonify({ avg: avg_score, max: max_score, img: img_base64, total: len(df) }) if __name__ __main__: app.run(host0.0.0.0, port5001)Java端用RestTemplate調(diào)用這個(gè)接口的代碼也很簡單構(gòu)造一個(gè)MultiValueMap或JSON對象POST過去拿到返回的JSON解析后把圖片的base64字符串直接放進(jìn)前端的img標(biāo)簽里。實(shí)測下來這個(gè)鏈路很穩(wěn)定數(shù)據(jù)量不大的情況下響應(yīng)速度也很快。3. 數(shù)據(jù)庫設(shè)計(jì)與關(guān)鍵配置文件解讀3.1 表結(jié)構(gòu)設(shè)計(jì)哪些表是必須的怎么建最合理數(shù)據(jù)庫設(shè)計(jì)是整個(gè)項(xiàng)目的地基。很多人的表結(jié)構(gòu)是隨用隨建到后期發(fā)現(xiàn)缺字段就加字段類型不統(tǒng)一關(guān)聯(lián)查詢巨慢。我這里直接給出一個(gè)比較完整的設(shè)計(jì)方案建表的SQL你可以直接參考。核心表有七張用戶表、角色表、題目表、知識點(diǎn)表、題目知識點(diǎn)關(guān)聯(lián)表、競賽表、競賽成績表。如果要做新聞資訊再加一張文章表。用戶表字段id, username, password, salt, email, avatar, role, status, create_time題目表字段id, content, options, answer, analysis, type, difficulty, subject, create_time競賽表字段id, title, description, start_time, end_time, duration, question_ids, status, create_time這里特別說一下question_ids字段。競賽和題目是多對多的關(guān)系理論上應(yīng)該建一張關(guān)聯(lián)表但競賽場景比較特殊——管理員組卷后該場競賽的題目集合就固定了直接用逗號分隔的ID字符串存起來取題的時(shí)候split(,)一下就行。好處是查詢快、理解簡單壞處是不太好做統(tǒng)計(jì)比如“哪道題被哪些競賽用過”?？错?xiàng)目復(fù)雜度自行取舍課設(shè)層面我建議直接用字符串存夠用且省事。競賽成績表字段id, competition_id, user_id, score, total_score, answer_detail, submit_time, rank, statusanswer_detail是個(gè)JSON字符串存的是用戶每道題的作答詳情比如[{question_id: 1, user_answer: C, is_correct: true}]。這樣做的好處是成績復(fù)核、人工批改的時(shí)候都能還原當(dāng)時(shí)用戶的作答情況不用再去聯(lián)查原始表。3.2 SSM框架配置Spring、SpringMVC、MyBatis的整合細(xì)節(jié)SSM的配置主要有三個(gè)文件spring-context.xml、spring-mvc.xml、mybatis-config.xml或直接通過application.properties。這里我不貼完整配置重點(diǎn)說幾個(gè)容易被忽視但影響巨大的細(xì)節(jié)。第一Spring容器和SpringMVC容器要分清。spring-context.xml負(fù)責(zé)掃描Service、Daospring-mvc.xml只掃描Controller。如果掃描范圍重疊會出現(xiàn)事務(wù)失效的問題。具體表現(xiàn)就是Service層沒加Transactional都正常加了反而報(bào)錯(cuò)或者不生效。第二MyBatis的駝峰命名映射一定要開啟。數(shù)據(jù)庫字段都是下劃線風(fēng)格比如create_timeJava實(shí)體類都是駝峰風(fēng)格createTime如果不開啟map-underscore-to-camel-case: true你查出來的結(jié)果全是null這個(gè)問題能卡死人。第三數(shù)據(jù)庫連接池用Druid別用默認(rèn)的。Druid自帶監(jiān)控頁面在答辯的時(shí)候打開監(jiān)控頁展示SQL執(zhí)行次數(shù)和耗時(shí)是很直觀的加分項(xiàng)。配置上注意設(shè)置initialSize和maxActive別全部用默認(rèn)值。!-- Druid數(shù)據(jù)源配置關(guān)鍵參數(shù) -- bean iddataSource classcom.alibaba.druid.pool.DruidDataSource property namedriverClassName valuecom.mysql.jdbc.Driver/ property nameurl valuejdbc:mysql://localhost:3306/math_contest?useSSLfalseamp;characterEncodingutf8/ property nameusername valueroot/ property namepassword valueroot/ property nameinitialSize value5/ property namemaxActive value20/ property nameminIdle value5/ property namemaxWait value60000/ /beanJDBC連接串里的characterEncodingutf8非常重要不加大概率會中文亂碼。你查出來的題目內(nèi)容全是問號排查一圈發(fā)現(xiàn)是連接串沒加編碼參數(shù)這種低級錯(cuò)誤太常見了。3.3 Flask端配置和跨域問題處理Flask端如果要被Java端調(diào)用要注意兩個(gè)問題一個(gè)是端口別跟Java的Tomcat沖突Java一般在8080Flask我習(xí)慣用5001另一個(gè)就是跨域問題。雖然Java后端調(diào)用Flask屬于服務(wù)端到服務(wù)端的HTTP通信不存在瀏覽器跨域限制但如果哪天你的前端頁面直接調(diào)Flask接口就會遇到跨域。提前把跨域配置寫上去避免后面臨時(shí)抱佛腳。from flask_cors import CORS CORS(app, resources{r/api/*: {origins: *}})還有一點(diǎn)Flask端的接口返回值統(tǒng)一用JSON格式并且在業(yè)務(wù)異常時(shí)也要返回JSON不要讓Flask默認(rèn)返回HTML錯(cuò)誤頁。給Flask寫一個(gè)全局異常處理器捕獲所有異常后統(tǒng)一返回{code: 500, msg: 服務(wù)器內(nèi)部錯(cuò)誤}。4. 項(xiàng)目部署與調(diào)試過程中的經(jīng)驗(yàn)教訓(xùn)4.1 本地環(huán)境搭建JDK、Maven、Tomcat、MySQL一步步來環(huán)境搭建是很多新手第一個(gè)攔路虎。我見過太多人在裝環(huán)境這一步卡了三天。實(shí)際上按順序操作沒那么復(fù)雜。JDK裝1.8就行畢設(shè)項(xiàng)目不需要太高版本太高版本反而可能跟老項(xiàng)目的編譯配置不兼容。環(huán)境變量配JAVA_HOME和PATH裝完在命令行輸入java -version驗(yàn)證。Maven解壓后配置MAVEN_HOME關(guān)鍵是要換阿里云鏡像倉庫否則下載依賴能等到天荒地老。Tomcat解壓版就行用IDE自帶的也沒問題。MySQL安裝時(shí)要注意設(shè)置root密碼后默認(rèn)的認(rèn)證方式如果是caching_sha2_password老版本的JDBC驅(qū)動連接會報(bào)錯(cuò)。解決辦法是在MySQL命令行里執(zhí)行ALTER USER rootlocalhost IDENTIFIED WITH mysql_native_password BY 你的密碼; FLUSH PRIVILEGES;這一步不做的話你會在Tomcat啟動時(shí)報(bào)Public Key Retrieval is not allowed錯(cuò)誤或者干脆連不上數(shù)據(jù)庫。4.2 數(shù)據(jù)庫初始化腳本的編寫規(guī)范項(xiàng)目交付時(shí)數(shù)據(jù)庫腳本是必須的。很多人直接Navicat可視化建庫建表最后導(dǎo)出一份SQL交差。這沒問題但有兩個(gè)地方要檢查。一是SQL里不要帶DROP DATABASE這種破壞性語句評閱老師或者你自己后面想演示的時(shí)候誤執(zhí)行一下數(shù)據(jù)全沒了。二是建表語句最好加上IF NOT EXISTS。另外強(qiáng)烈建議寫一份data.sql初始化數(shù)據(jù)腳本里面放幾道例題、一個(gè)測試用戶、一場模擬競賽。這樣別人拿到項(xiàng)目導(dǎo)入后不用自己錄入就能直接看到效果。數(shù)據(jù)的初始化和演示效果直接相關(guān)這一份腳本的價(jià)值比想象中大。4.3 修改配置文件的小技巧和注意點(diǎn)項(xiàng)目里配置文件包括jdbc.properties數(shù)據(jù)庫連接、log4j.properties日志、spring-mvc.xml靜態(tài)資源放行、視圖解析器等。改配置最容易出的問題有三個(gè)屬性文件里的符號要轉(zhuǎn)義成amp;上面提過。IP地址或端口改了但前端JS里的Ajax請求地址還是localhost。文件編碼問題properties文件默認(rèn)ISO-8859-1直接寫中文注釋會導(dǎo)致亂碼。盡管不影響運(yùn)行但看著難受建議把IDE的properties文件默認(rèn)編碼改成UTF-8。日志這塊建議把log4j.properties里com.xxx.mapper這一級的日志級別設(shè)成DEBUG這樣MyBatis的執(zhí)行日志會打出來你能看到SQL是怎么拼的排查問題非常有用。等項(xiàng)目上線了再調(diào)回INFO。4.4 前后端聯(lián)調(diào)我用過的幾個(gè)快速調(diào)試技巧聯(lián)調(diào)階段我積累了幾個(gè)特別實(shí)用的技巧分享給你們。第一Chrome開發(fā)者工具的Network面板是上帝視角所有請求的狀態(tài)碼、耗時(shí)、參數(shù)一目了然?？吹揭粋€(gè)請求404先別急著改代碼看看URL是不是打錯(cuò)了、Controller里的RequestMapping路徑是不是沒配對。第二用Postman單獨(dú)測試后端接口。在寫頁面之前先把所有接口在Postman里跑通確認(rèn)返回的數(shù)據(jù)結(jié)構(gòu)再讓前端對接。這樣出了問題能快速定位是后端還是前端。第三Java端調(diào)用Flask接口如果報(bào)連接超時(shí)優(yōu)先檢查Flask服務(wù)是否啟動、端口是否正確、防火墻是否攔截。命令行curl -X POST http://localhost:5001/api/analyze -d {}測一下就知道問題在哪。5. 常見問題與排查技巧實(shí)錄根據(jù)我實(shí)際看過和經(jīng)歷過的情況整理了一份高頻問題速查表每一個(gè)都是真實(shí)發(fā)生過的。問題現(xiàn)象根本原因解決方案登錄時(shí)輸入正確密碼提示“密碼錯(cuò)誤”密碼加密方式不一致比如注冊用了BCrypt、登錄用MD5統(tǒng)一加密算法保證注冊和登錄走同一套用戶頭像圖片上傳后無法顯示上傳路徑是相對路徑前端訪問的基礎(chǔ)路徑不對將上傳目錄映射成虛擬路徑或用絕對路徑拼接URL競賽到了開始時(shí)間仍顯示未開始狀態(tài)判斷用的是管理員設(shè)置的靜態(tài)狀態(tài)沒有按當(dāng)前時(shí)間實(shí)時(shí)計(jì)算每次請求時(shí)用LocalDateTime.now()對比開始時(shí)間批量導(dǎo)入Excel時(shí)報(bào)IllegalStateExceptionPOI讀取cell類型沒有做判斷統(tǒng)一寫單元格值轉(zhuǎn)換方法先判類型再取值前端Ajax獲取數(shù)據(jù)后頁面空白后端返回的JSON字段名和前端取的字段名不一致統(tǒng)一使用駝峰命名且前后端約定好字段名Flask端接口偶發(fā)CORS報(bào)錯(cuò)前端跨域調(diào)Flask接口且未配置CORS用flask-cors全局開啟指定允許的來源部署后MyBatis查詢字段全是null忘了開啟下劃線轉(zhuǎn)駝峰映射mybatis配置中開啟map-underscore-to-camel-case中文亂碼頁面全是問號連接串沒加characterEncodingutf8或數(shù)據(jù)庫編碼不對檢查JDBC URL、數(shù)據(jù)庫建庫字符集、頁面編碼統(tǒng)一UTF-8Tomcat部署war包后訪問報(bào)404項(xiàng)目訪問路徑不對沒加項(xiàng)目名URL訪問前加/項(xiàng)目名或者把war包名設(shè)為ROOT除了表格里的我再補(bǔ)充幾個(gè)比較隱蔽的坑。第一個(gè)是并發(fā)訪問session的問題。有些同學(xué)在Controller里直接request.getSession().setAttribute(user, user)然后在攔截器里取。如果同時(shí)開兩個(gè)瀏覽器標(biāo)簽頁登錄不同賬號后登錄的會把先登錄的頂?shù)?。解決辦法是Session里存用戶ID而不是整個(gè)用戶對象需要用戶信息時(shí)再查庫。這樣即使被頂?shù)粢仓皇嵌嗖橐淮螖?shù)據(jù)庫邏輯上不會串。第二個(gè)是競賽答題頁面刷新時(shí)倒計(jì)時(shí)重置的問題。這個(gè)特別容易出問題。用戶進(jìn)入答題頁面后如果按F5刷新頁面重新加載如果倒計(jì)時(shí)是JS的setInterval從零開始算就相當(dāng)于時(shí)間重置了用戶可以無限刷新延長答題時(shí)間。正確做法是后端在用戶進(jìn)入答題狀態(tài)時(shí)記錄一個(gè)開始時(shí)間戳前端每次獲取時(shí)間都用“截止時(shí)間減去當(dāng)前服務(wù)器時(shí)間”來計(jì)算剩余時(shí)間。刷新頁面只是重新拿一下剩余時(shí)間而已不會占便宜。第三個(gè)是文件上傳的安全問題。數(shù)學(xué)競賽網(wǎng)站里用戶頭像上傳功能看起來很普通但如果沒做文件類型校驗(yàn)惡意用戶上傳一個(gè)JSP或PHP文件然后拼一個(gè)路徑去訪問就能getshell。哪怕只是做個(gè)課設(shè)也應(yīng)該對上傳文件后綴做白名單校驗(yàn)別用黑名單。同時(shí)重命名文件為隨機(jī)字符串不要保留用戶原始文件名。6. 從課設(shè)到答辯項(xiàng)目打磨與展示的經(jīng)驗(yàn)分享項(xiàng)目做完代碼部分離交付還有兩個(gè)重要的收尾工作文檔撰寫和答辯準(zhǔn)備。這部分往往被低估但它直接影響最終成績。LW也就是畢業(yè)論文或設(shè)計(jì)說明書的結(jié)構(gòu)一般是緒論、相關(guān)技術(shù)介紹、需求分析、系統(tǒng)設(shè)計(jì)、系統(tǒng)實(shí)現(xiàn)、系統(tǒng)測試、總結(jié)。寫的時(shí)候技術(shù)介紹不要大段抄書要結(jié)合你項(xiàng)目里的場景寫。需求分析要用用例圖系統(tǒng)設(shè)計(jì)要有E-R圖這些我建議用ProcessOn先梳理思路再放到文檔里。代碼的核心邏輯截圖加簡短說明就可以了關(guān)鍵是要展示你的思考過程比如“為什么選MySQL不選Oracle”“為什么組卷用權(quán)重隨機(jī)算法”。調(diào)試文檔DD我習(xí)慣寫成帶問題痕跡的記錄而不是一個(gè)純命令清單。比如某一天我遇到了什么報(bào)錯(cuò)、排查思路是什么、最后怎么解決的。這種文檔面試或評閱時(shí)特別好用因?yàn)榭吹贸瞿阏娴氖窃贒ebug而不是照著教程敲。答辯前把項(xiàng)目的核心亮點(diǎn)提煉成三句話。比如“我的系統(tǒng)基于SSM框架構(gòu)建主站為Java實(shí)現(xiàn)同時(shí)引入Python Flask作為數(shù)據(jù)分析微服務(wù)實(shí)現(xiàn)了跨語言架構(gòu)的協(xié)作”。這句話能背下來就贏了。最后再分享一個(gè)實(shí)操中的小技巧在做完項(xiàng)目后把整套環(huán)境的啟動步驟寫成一個(gè)README.md文檔放在項(xiàng)目根目錄。里面寫清楚從數(shù)據(jù)庫初始化到Tomcat啟動、從Flask服務(wù)啟動到瀏覽器訪問的每一個(gè)步驟。這個(gè)文檔既是給別人看的也是給以后的你自己看的。等過了一個(gè)月再回頭看項(xiàng)目你會發(fā)現(xiàn)沒有這份文檔連你自己都忘了該怎么啟動。數(shù)學(xué)競賽網(wǎng)站這類項(xiàng)目技術(shù)點(diǎn)不算深但勝在業(yè)務(wù)清晰、模塊完整是對SSM框架、數(shù)據(jù)庫設(shè)計(jì)、前后端交互能力的一次全面檢驗(yàn)。只要把用戶、試題、競賽、成績這四個(gè)核心模塊做扎實(shí)再點(diǎn)綴一點(diǎn)Flask輔助功能和優(yōu)秀的文檔這個(gè)項(xiàng)目就能成為一份非常拿得出手的畢設(shè)作品。做項(xiàng)目的過程中踩的那些坑調(diào)整的那些細(xì)節(jié)其實(shí)比最后的分?jǐn)?shù)更有價(jià)值工作后面試聊起這些經(jīng)歷才是真正能打動人的東西。