最近不少同學在找基于 Spring Boot 的畢業(yè)設(shè)計或者課程設(shè)計項目要求很一致源碼完整、能跑起來、功能不能太敷衍。我手里這套“大學生招聘系統(tǒng)”網(wǎng)上流傳的 32850 版本正好是這類項目里的一個典型。它不像那些只有登錄注冊和增刪改查的花架子從學生、企業(yè)到管理員三條用戶線的核心業(yè)務都閉環(huán)了技術(shù)棧也踩得很穩(wěn)Spring Boot 搭后端Vue 搭前端MySQL 存數(shù)據(jù)另外還整合了 JWT 認證和 MinIO 文件存儲。這篇文章我就把它從設(shè)計到實現(xiàn)的思路、關(guān)鍵源碼以及我實際搭建過程中踩過的坑全盤拆給你。這套系統(tǒng)的域名和用途很明確面向高校場景下的招聘平臺。你可以把它當成一個簡化版的“校招內(nèi)推網(wǎng)站”學生在前臺搜職位、傳簡歷、投遞、收面試邀請企業(yè)注冊后可以發(fā)布崗位、篩選簡歷、安排面試管理員在后臺做用戶和職位的審核以及看運營數(shù)據(jù)。它解決了傳統(tǒng)線下校招信息不對稱、簡歷管理混亂、面試安排靠人工催的問題對學習者來說它是一個能完整串聯(lián)前后端、權(quán)限、消息流和文件存儲的絕佳練手項目。下面我按自己實際拆分這套源碼的順序一步步把內(nèi)容講透。1. 整體設(shè)計思路為什么這套系統(tǒng)能直接用于答辯和項目展示拿到一套源碼第一件事不是急著點運行而是先把它的功能邊界和使用場景摸清楚。這套系統(tǒng)的核心場景是“校招”圍繞“學生找工作、企業(yè)招人”這一對供需關(guān)系展開并加入管理員作為平臺運營方。這種三角色模型是招聘系統(tǒng)最經(jīng)典的結(jié)構(gòu)也是面試官最容易認可的業(yè)務閉環(huán)。1.1 功能模塊到底有哪些從用戶端劃分系統(tǒng)大概可以拆成三個端加一個公共模塊。學生端C 端功能偏“投遞”注冊登錄、個人中心、簡歷管理基礎(chǔ)信息、教育經(jīng)歷、項目經(jīng)歷、技能標簽、職位瀏覽、按關(guān)鍵詞和分類搜索職位、投遞簡歷、查看投遞狀態(tài)投遞中、已被查看、已發(fā)面試、不合適、收到企業(yè)面試邀請后在系統(tǒng)里確認并查看面試安排。企業(yè)端B 端功能偏“篩選”注冊后提交營業(yè)執(zhí)照等資質(zhì)材料、登錄發(fā)布崗位、管理已發(fā)布崗位上下架、修改、查看投遞了本企業(yè)職位的學生列表、查看學生簡歷詳情、對簡歷進行篩選操作通過/淘汰、向通過篩選的學生發(fā)送面試邀請。管理員端P 端功能偏“治理”對企業(yè)注冊進行資質(zhì)審核、對職位進行審核和違規(guī)下架、管理學生賬號禁用/解禁、查看平臺核心數(shù)據(jù)崗位總數(shù)、投遞量、注冊用戶量、熱門職位排行。公共模塊則包括人機驗證、修改密碼、會話保持、操作日志等。這些功能共同構(gòu)成了一個可演示的完整閉環(huán)學生注冊→投遞→企業(yè)篩選→面試邀請→學生確認面試。1.2 三條用戶線的權(quán)限邊界我在看這套代碼時最先關(guān)注的是它的權(quán)限是怎么做的。很多課設(shè)項目把權(quán)限寫在頁面上比如“不是管理員就不顯示按鈕”但真正的做法是要在接口層做控制。這套系統(tǒng)的做法是在后端用 Spring Security 攔截所有請求通過角色標識判斷當前登錄用戶是ROLE_STUDENT、ROLE_COMPANY還是ROLE_ADMIN然后在接口上通過PreAuthorize(hasRole(ADMIN))之類的注解做細粒度控制。比如學生能訪問/api/job/list但訪問不了/api/company/apply/list管理員能訪問/api/admin/statistics但普通學生訪問會返回 403。這種設(shè)計不僅保證了數(shù)據(jù)安全也讓代碼結(jié)構(gòu)更清晰。實際使用中業(yè)務層還要再校驗一次數(shù)據(jù)歸屬比如企業(yè)只能操作自己創(chuàng)建的職位這個邏輯不能只依賴前端傳參。1.3 數(shù)據(jù)庫表設(shè)計的核心邏輯這套項目的數(shù)據(jù)庫一共十幾張表核心表我用一個表格列出來你就明白數(shù)據(jù)是怎么流轉(zhuǎn)的表名主要字段作用userid, username, password, role, phone, status統(tǒng)一用戶表用 role 區(qū)分學生/企業(yè)/管理員resumeid, user_id, name, school, major, education, skills學生簡歷一對一掛在用戶下companyid, user_id, company_name, license_url, audit_status企業(yè)資質(zhì)信息注冊時填寫待審核job_postid, company_id, title, category, city, salary_min, salary_max, description, status職位表包含薪資區(qū)間、城市、上下架狀態(tài)job_applicationid, job_id, resume_id, student_id, company_id, status, create_time投遞記錄狀態(tài)隨時間流轉(zhuǎn)interviewid, application_id, company_id, student_id, time, location, remark面試邀請關(guān)聯(lián)到具體的投遞記錄這種設(shè)計的巧妙之處在于用一個user表撐起了三種角色再用角色前置的輔助表存各自的擴展信息。企業(yè)注冊后生成company記錄并處于待審核狀態(tài)學生注冊后自動創(chuàng)建一個空resume這樣可以避免后面業(yè)務邏輯里各種查不到記錄的空指針問題屬于比較成熟的項目組織方式。2. 技術(shù)選型的門道Spring Boot Vue MinIO 這樣組合的理由這套源碼使用的技術(shù)組合很常見但每一個選型背后都有明確的理由我實際踩過一遍后對這些取舍更清楚了。2.1 后端Spring Boot 的自動裝配和生態(tài)優(yōu)勢Spring Boot 能讓項目“開箱即用”核心是它的自動配置機制。比如你在pom.xml里引入了spring-boot-starter-webBoot 會自動檢查是否存在WebMvcConfigurationSupport、Servlet等類然后自動創(chuàng)建需要的 Bean。這就是我在項目啟動時幾乎不需要手動寫DispatcherServlet配置的原因。對于學生來說這也意味著可以少寫大量 XML 和配置把精力放在業(yè)務邏輯上。這套系統(tǒng)用的版本是 Spring Boot 2.x配合 MyBatis-Plus 操作數(shù)據(jù)庫。MyBatis-Plus 簡直是為課設(shè)和中小型系統(tǒng)量身定做的BaseMapper里已經(jīng)封裝好了selectById、selectList、insert這些常用方法不需要自己寫 SQL分頁查詢用Page對象就能搞定。我曾在單表查詢非常多的地方直接用LambdaQueryWrapper來做條件拼接比如職位搜索時按關(guān)鍵詞、城市、薪資范圍過濾代碼比 XML 里的動態(tài) SQL 還要好讀LambdaQueryWrapperJobPost wrapper new LambdaQueryWrapper(); wrapper.like(StringUtils.hasText(keyword), JobPost::getTitle, keyword) .eq(StringUtils.hasText(city), JobPost::getCity, city) .orderByDesc(JobPost::getCreateTime); return jobPostMapper.selectPage(new Page(pageNum, pageSize), wrapper);這種寫法的好處是類型安全字段名拼錯了編譯階段就會暴露而不是等到運行時報錯。2.2 前端Vue 與后端靜態(tài)資源整合的坑系統(tǒng)前端是 Vue 寫的。我拿到的源碼里前端項目在一個frontend目錄下里面是標準 Vue 2 Element UI axios vue-router vuex 結(jié)構(gòu)。開發(fā)環(huán)境上前后端通過 devServer 代理解決跨域生產(chǎn)環(huán)境上這套代碼采用了“把前端打包后塞進 Spring Boot 靜態(tài)目錄”的方式這也是熱詞里“vue打包放進springboot”的典型訴求。為什么這么做因為課程設(shè)計或畢業(yè)設(shè)計的演示環(huán)境通常只有一臺服務器前端單獨部署還要配 Nginx麻煩且容易失敗。直接把 Vue 打包出來的dist目錄復制到src/main/resources/static下面Spring Boot 會自動把它當作靜態(tài)資源處理。也就是說除了/api/開頭的請求其他路徑都會返回 Vue 的頁面。這樣最終只需要打一個 Jar 包就能同時提供頁面和數(shù)據(jù)接口部署起來省心很多。但這里有一個非常隱晦的坑Vue Router 默認是history模式頁面路由是比如/student/course如果用戶直接刷新這個路徑Spring Boot 的靜態(tài)資源處理器會嘗試尋找student/course.html然后返回 404。解決方法就是在后端加一個控制器把非 API 的路徑都重定向到index.html。這套源碼里就是用Controller包了個ForwardControllerController public class ForwardController { GetMapping(value {/, /{path:[^\\.]*}, /{path:[^\\.]*}/{sub:[^\\.]*}}) public String forward() { return forward:/index.html; } }這個細節(jié)很多人一開始不知道我建議拿到源碼后先改掉默認的 hash 路由用上面的方式處理否則部署完會彈出詭異的白屏。2.3 認證與文件存儲JWT MinIO 的實戰(zhàn)選擇為什么選 JWT 而不用 Session因為系統(tǒng)的前端是 Vue而且未來可能會拆分成多個服務JWT 無狀態(tài)、跨域友好、能直接攜帶用戶信息。它的加密算法可以選對稱加密 HS256也可以用非對稱加密 RS256。這套系統(tǒng)用 HS256 更省事密鑰放在application.yml中登錄成功后生成一個包含userId和role的 token。同時它整合了 MinIO 來存圖片和 PDF 簡歷。MinIO 是一個對象存儲服務兼容 Amazon S3 API比起自建分布式文件系統(tǒng)簡單得多。熱詞中“minio加入到springboot”也是常見問題。這套系統(tǒng)在pom.xml里引入minio客戶端依賴配置好 endpoint、accessKey、secretKey 和 bucket然后封裝一個MinioServicepublic String uploadFile(MultipartFile file) { String fileName System.currentTimeMillis() _ file.getOriginalFilename(); minioClient.putObject( PutObjectArgs.builder() .bucket(bucketName) .object(fileName) .contentType(file.getContentType()) .stream(file.getInputStream(), file.getSize(), -1) .build()); return endpoint / bucketName / fileName; }用 MinIO 存簡歷 PDF 和公司資質(zhì)圖片比存 BLOB 字段更合理。數(shù)據(jù)庫維護文件的 URL 就行避免了數(shù)據(jù)庫膨脹也讓靜態(tài)資源可以走獨立域名。2.4 項目目錄結(jié)構(gòu)說明拿到源碼后建議先看目錄結(jié)構(gòu)。這是這套系統(tǒng)的包組織方式src/main/java/com/recruit ├── config/ # Security、MinIO、CORS、WebMvc 配置 ├── controller/ # 接口層按功能拆 Admin/Student/Company ├── service/ # 業(yè)務邏輯層接口 impl ├── mapper/ # MyBatis-Plus 持久層接口 ├── entity/ # 數(shù)據(jù)庫實體類 ├── dto/ # 接收參數(shù)的類 ├── vo/ # 返回給前端的數(shù)據(jù)對象 ├── common/ # 統(tǒng)一返回結(jié)果、異常處理、常量 ├── utils/ # JWT 工具類等我見過太多源碼所有類都堆在com.example下找起來非常痛苦。這套系統(tǒng)的包名雖然沒有特別規(guī)范但至少按功能拆得很清楚Controller 對應的 Service、Mapper 可以直接跳轉(zhuǎn)這對學習和后續(xù)二次開發(fā)都很友好。3. 關(guān)鍵功能實現(xiàn)源碼級別的拆解整個系統(tǒng)的核心不在頁面布局而在幾個關(guān)鍵鏈路。我把其中最值得閱讀和修改的四個部分拎出來講。3.1 注冊與登錄Spring Security JWT 的集成要點登錄是所有系統(tǒng)的入口但很多人的登錄邏輯是當成擺設(shè)。這套系統(tǒng)比較好的地方是它把 Spring Security 的UsernamePasswordAuthenticationToken和自定義 JWT 工具類結(jié)合了起來。具體實現(xiàn)上登錄接口先校驗用戶名密碼成功后就生成 token。生成 token 的代碼大致是// utils/JwtUtil.java public String generateToken(User user) { return Jwts.builder() .setSubject(String.valueOf(user.getId())) .claim(role, user.getRole()) .claim(username, user.getUsername()) .setIssuedAt(new Date()) .setExpiration(new Date(System.currentTimeMillis() expireTime)) .signWith(SignatureAlgorithm.HS256, secretKey) .compact(); }然后寫一個JwtAuthenticationFilter繼承 Spring Security 的OncePerRequestFilter在每次請求進來時取出 Authorization 頭解析 token把用戶權(quán)限寫入SecurityContextHolder。我在查看代碼時特別注意到它自己寫了一個getAuthentication方法定義了一些SimpleGrantedAuthority權(quán)限。集成時最容易出問題的點是 Security 放行規(guī)則。一定要記住/api/auth/login/api/auth/register/api/captcha這些公共接口不能攔截否則登錄都過不去。另外 Swagger 如果接入的話也要放行swagger-resources、v3/api-docs等路徑。這套系統(tǒng)在這塊處理得比較清楚你可以沿用它的規(guī)則。3.2 學生投遞簡歷的核心流程投遞是招聘系統(tǒng)的“下單”動作所以我特別關(guān)注它的完整事務。學生點“投遞”按鈕后前端發(fā)送一個請求包含職位ID和簡歷ID。后端邏輯大致如下Transactional public Result apply(Integer studentId, Integer jobId, Integer resumeId) { JobPost job jobPostMapper.selectById(jobId); if (job null || job.getStatus() ! 1) { return Result.error(職位不存在或已下架); } // 防止重復投遞 Long count applicationMapper.selectCount( new LambdaQueryWrapperJobApplication() .eq(JobApplication::getJobId, jobId) .eq(JobApplication::getStudentId, studentId)); if (count 0) { return Result.error(請勿重復投遞); } JobApplication application new JobApplication(); application.setJobId(jobId); application.setResumeId(resumeId); application.setStudentId(studentId); application.setCompanyId(job.getCompanyId()); application.setStatus(0); // 0投遞中 applicationMapper.insert(application); return Result.success(投遞成功); }注意這里我用Transactional來保證事務因為這里讀后寫且存在重復投遞的并發(fā)風險。雖然實際中課設(shè)項目并發(fā)量不高但寫代碼時要把這個意識帶上。對于學生端來說之后查看投遞記錄的接口要把職位信息和面試信息聯(lián)表查出來不能只返回一個狀態(tài)數(shù)字。3.3 企業(yè)發(fā)布職位與簡歷篩選企業(yè)側(cè)的邏輯主要集中在CompanyController中。發(fā)布職位時公司不是必填字段而是從當前登錄用戶的user記錄去關(guān)聯(lián)company表然后取companyName。我在源碼里看到它用SecurityUtils.getCurrentUserId()來獲取當前登錄者的 ID再用 ID 去查關(guān)聯(lián)公司。這是一個很值得借鑒的小技巧避免前端手工傳 user_id 或 company_id減少越權(quán)風險。簡歷篩選的流程是企業(yè)查看某個職位下的所有投遞列表列表里要拼接學生的名字、學校、專業(yè)等點擊“查看簡歷”時調(diào)用/api/company/resume/{id}Controller 返回的是一個ResumeVO包含遠程學歷信息和文件 URL。企業(yè)點擊“通過”后后端將job_application.status改為 2并自動創(chuàng)建一條interview記錄此時學生端就能看到“面試邀請”狀態(tài)。PostMapping(/interview) public Result createInterview(RequestBody InterviewDTO dto) { JobApplication application applicationMapper.selectById(dto.getApplicationId()); application.setStatus(2); applicationMapper.updateById(application); Interview interview new Interview(); interview.setApplicationId(dto.getApplicationId()); interview.setCompanyId(application.getCompanyId()); interview.setStudentId(application.getStudentId()); interview.setTime(dto.getTime()); interview.setLocation(dto.getLocation()); interview.setRemark(dto.getRemark()); interviewMapper.insert(interview); return Result.success(); }這里其實可以做得更好比如發(fā)送站內(nèi)信或郵件通知但作為課設(shè)項目目前夠用。3.4 管理員數(shù)據(jù)看板的實現(xiàn)思路管理員的首頁一般是幾個統(tǒng)計卡片和圖表。這套系統(tǒng)的統(tǒng)計接口用了簡單的聚合查詢例如統(tǒng)計總注冊學生數(shù)、總企業(yè)數(shù)、總職位數(shù)、總投遞數(shù)。對于熱門職位排行它用了 MyBatis-Plus 的groupByQueryWrapperJobApplication wrapper new QueryWrapper(); wrapper.select(job_id, count(*) as cnt) .groupBy(job_id) .orderByDesc(cnt) .last(limit 10);然后把結(jié)果顯示成柱狀圖數(shù)據(jù)交給前端。雖然談不上大數(shù)據(jù)但管理員的日常運營看板就是這種模式調(diào)試起來很直觀。你也可以在此基礎(chǔ)上增加時間范圍的篩選條件來統(tǒng)計某個月份的投遞趨勢。4. 從源碼到上線完整構(gòu)建、配置與避坑實錄很多人在本地能跑起來一到換個環(huán)境就歇菜了。我按照從零開始構(gòu)建這套系統(tǒng)的順序把配置和部署過程中的步驟和坑逐一記錄下來。4.1 環(huán)境準備與基礎(chǔ)配置你需要準備好這些JDK 1.8 或更高版本、Maven 3.6、MySQL 5.7、MinIO 服務、Node.js 14用于前端構(gòu)建。建議版本不要拉太高Spring Boot 2.x 在 JDK 17 下也能跑但一些老依賴可能存在問題熱詞里“springboot版本太高”就是一個常見坑如果你下載的依賴版本互相沖突優(yōu)先鎖定 Boot 版本為 2.7.x這是穩(wěn)定很多的安全牌。數(shù)據(jù)庫配置在application.yml里重點關(guān)注下面幾項server: port: 8080 spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/recruit?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai username: root password: 123456 servlet: multipart: max-file-size: 10MB max-request-size: 20MB minio: endpoint: http://localhost:9000 access-key: minioadmin secret-key: minioadmin bucket: recruit-file jwt: secret: your-secret-key-please-change-me expire-time: 86400000這些配置文件里最容易錯的是時區(qū)和 URL。serverTimezoneAsia/Shanghai不設(shè)置的話可能會出現(xiàn) 8 小時的時間偏差。文件大小限制也要調(diào)大否則上傳簡歷 PDF 會直接報文件超限。4.2 前端打包如何塞進 Spring Boot前端項目在frontend文件夾里首先要把它的代理配置填好。開發(fā)階段vue.config.js里設(shè)proxy: /api指向http://localhost:8080用來解決本地前后端聯(lián)調(diào)的跨域問題。生產(chǎn)構(gòu)建時你需要先清理掉代理配置因為前端 static 目錄里的資源默認同源。打包命令也很簡單cd frontend npm install npm run build構(gòu)建完成后dist目錄下會生成index.html和一堆 JS/CSS 文件。把這整個dist里的內(nèi)容復制到后端的src/main/resources/static目錄下。注意是復制內(nèi)容不是把dist文件夾復制進去。復制完之后后端項目重新打包。前端里的接口請求地址必須用相對路徑例如/api/student/job/list不能寫死http://localhost:8080/...。我在拿到源碼后發(fā)現(xiàn)它寫了一個統(tǒng)一的request.jsbaseURL 設(shè)為空字符串這是合理設(shè)計。如果原來的源碼中有絕對地址你要先改成相對路徑否則上線必掛。4.3 后端部署Maven 插件、數(shù)據(jù)庫初始化數(shù)據(jù)庫的初始化腳本一般在sql目錄下比如recruit.sql。你需要用 Navicat 或者命令行導入。如果 SQL 文件里有測試數(shù)據(jù)直接跑一遍即可。我建議你把管理員賬號、測試學生、測試企業(yè)的密碼都問清楚或者自己先用后端的注冊頁注冊一個學生賬號再手動把它的role改成ADMIN這樣至少能保證進后臺。后端打包時Spring Boot 默認打包會執(zhí)行測試如果項目里有測試類但環(huán)境不完整可能會失敗。我通常會跳過測試mvn clean package -DskipTests打完的target/*.jar就是可執(zhí)行 jar。啟動時指定配置文件java -jar recruit-system.jar --spring.profiles.activeprod如果你沒有太多服務器經(jīng)驗也可以用 spring-boot-maven-plugin 的repackage目標把依賴都打進去確保 jar 能獨立運行。4.4 常見問題排查速查表我根據(jù)自己跑這類項目的實際經(jīng)歷把最常見的 6 個問題整理成了一張表當你搭建時遇到卡住可以直接對照排查癥狀可能原因解決辦法啟動后前端頁面能打開接口 404前端靜態(tài)資源和后端 API 路徑?jīng)_突或者 ForwardController 沒有包含某條路徑檢查index.html里的資源路徑是否正確重點看 js/css 引用的是相對還是絕對提交登錄接口報 403Security 配置里沒有放行登錄路徑或者 CSRF 未禁用在 SecurityConfig 里.csrf().disable()并把/api/auth/**加入 permitAll數(shù)據(jù)庫中文亂碼JDBC URL 缺少characterEncodingutf8或者表編碼不是 utf8mb4修改連接串并執(zhí)行ALTER TABLE xxx CONVERT TO CHARACTER SET utf8mb4;文件上傳失敗MinIO 桶未創(chuàng)建或密鑰錯誤手動用 browser 登錄 MinIO 控制臺創(chuàng)建指定的 bucket并檢查 access-key/secret-key刷新頁面變成白屏Vue Router history 模式?jīng)]有后端兜底加入 ForwardController 轉(zhuǎn)發(fā)所有非/api路徑到index.html接口總是 401 token 失效JWT 密鑰未統(tǒng)一或者系統(tǒng)時間不一致檢查前后端和服務器的系統(tǒng)時間JWT 過期時間不要設(shè)太短這些坑每一個我都遇到過一次以上。尤其是端口沖突問題在 IDE 里啟動多個實例時經(jīng)常被占用可以在application.yml里改端口也可以在 IDEA 啟動配置的 VM 參數(shù)里寫-Dserver.port8081。很多同學改完前端代碼重新打包發(fā)現(xiàn)頁面還是舊的原因是用瀏覽器緩存強烈建議部署時讓 Nginx 或后端靜態(tài)資源響應頭加上Cache-Control: no-cache否則調(diào)試到懷疑人生。最后再分享一個能立刻提高演示好感度的小技巧——IDEA 里配置啟動參數(shù)。如果你要在不同端口上開多套環(huán)境驗證權(quán)限不用反復改 yml 文件而是點擊右上角啟動配置在 Program arguments 里填寫--server.port9090Spring Boot 的命令行參數(shù)優(yōu)先級高于配置文件這個參數(shù)能直接覆蓋 yml 里的端口。這是我在實際開發(fā)中經(jīng)常用的一招尤其當你同時跑后端服務和前端 devServer 的時候能少踩不少端口沖突的坑。把這套系統(tǒng)跑通弄明白每個模塊為什么這樣設(shè)計你不僅能完成一個像樣的課設(shè)還能在面試里聊出一個有業(yè)務深度、有權(quán)限控制、有文件存儲的完整項目。