最近做了一套基于Spring Boot的網(wǎng)盤類管理系統(tǒng)核心功能就是個(gè)人云盤。像這種Spring Boot 前端JS的Title其實(shí)是很典型的Java Web練手項(xiàng)目網(wǎng)上也有各種各樣的教程但絕大多數(shù)都是跑通就完事真正像工程一樣考慮細(xì)節(jié)的很少。這篇文章就按我實(shí)際開(kāi)發(fā)這套個(gè)人云盤管理系統(tǒng)的經(jīng)驗(yàn)把這個(gè)題目的技術(shù)架構(gòu)、數(shù)據(jù)庫(kù)、核心功能、中間踩的坑從頭梳理一遍給想拿這個(gè)題目做畢業(yè)設(shè)計(jì)或者練手的同學(xué)一個(gè)可以直接照抄的參考。整個(gè)系統(tǒng)功能覆蓋得很完整用戶注冊(cè)登錄、文件上傳下載、文件夾管理、分享鏈接、回收站恢復(fù)、圖片和文本在線預(yù)覽。別看這些功能聽(tīng)起來(lái)簡(jiǎn)單真正做起來(lái)文件目錄層級(jí)、分片上傳、邏輯刪除、權(quán)限校驗(yàn)這些模塊單獨(dú)拎出來(lái)都能寫很多文章。所以我這里會(huì)把重點(diǎn)放在整體設(shè)計(jì)和最容易踩坑的實(shí)現(xiàn)細(xì)節(jié)上而不是貼幾百行代碼充數(shù)。1. 項(xiàng)目整體設(shè)計(jì)與技術(shù)選型思路1.1 核心需求拆解個(gè)人云盤聽(tīng)起來(lái)簡(jiǎn)單但真正拆開(kāi)需求以后會(huì)發(fā)現(xiàn)很多東西如果不提前理清楚開(kāi)發(fā)到后面很容易自己把自己繞暈。我把需求分成四塊。第一塊是用戶相關(guān)。登錄、注冊(cè)、退出、獲取當(dāng)前登錄用戶信息。這個(gè)系統(tǒng)定位是個(gè)人云盤所以權(quán)限模型不需要做多角色只要認(rèn)準(zhǔn)當(dāng)前登錄的用戶是誰(shuí)就行。所有文件數(shù)據(jù)都?xì)w屬于某個(gè)用戶IDA用戶看不到B用戶的文件。第二塊是文件管理。這是核心中的核心包括上傳文件、下載文件、新建文件夾、重命名、刪除、移動(dòng)、文件列表展示、回收站恢復(fù)。其中文件列表的樹(shù)形展示或者叫目錄結(jié)構(gòu)是很多新手容易卡住的地方。因?yàn)槲募到y(tǒng)是有層級(jí)關(guān)系的不是平鋪的列表。第三塊是分享功能。文件可以生成一個(gè)分享鏈接加上提取碼發(fā)給別人對(duì)方在瀏覽器里打開(kāi)鏈接輸入提取碼后能看到文件詳情或者直接下載文件。分享鏈接有過(guò)期時(shí)間過(guò)期后自動(dòng)失效。第四塊是其他輔助功能比如文件圖標(biāo)展示、圖片預(yù)覽、文本預(yù)覽、磁盤使用情況統(tǒng)計(jì)之類的。這屬于加分項(xiàng)但實(shí)際開(kāi)發(fā)時(shí)也要考慮進(jìn)去因?yàn)轫?yè)面展示的時(shí)候得根據(jù)文件類型做不同的標(biāo)識(shí)。需求拆解完以后最好不要急著寫代碼先設(shè)計(jì)一下數(shù)據(jù)表。數(shù)據(jù)表設(shè)計(jì)得好后面編碼會(huì)很順暢數(shù)據(jù)表設(shè)計(jì)得有問(wèn)題后面會(huì)不斷返工。所以我把數(shù)據(jù)庫(kù)設(shè)計(jì)放在開(kāi)發(fā)之前一步。1.2 為什么選Spring Boot 前端JS這個(gè)技術(shù)組合在畢業(yè)設(shè)計(jì)和各類實(shí)戰(zhàn)項(xiàng)目里出現(xiàn)頻率非常高。后端用Spring Boot核心原因在于它把Spring家族的配置簡(jiǎn)化到了不需要XML的程度內(nèi)嵌Tomcat容器一個(gè)main方法就能啟動(dòng)服務(wù)。相比傳統(tǒng)的SSHSpring Struts Hibernate或者SSMSpring Spring MVC MyBatis方案省去大量配置時(shí)間讓開(kāi)發(fā)者能把精力集中在業(yè)務(wù)邏輯上。另外Spring Boot有非常成熟的生態(tài)后面我們用到Web上傳、攔截器、配置文件多環(huán)境切換都有現(xiàn)成方案。前端選擇JavaScript方向具體我用了Vue框架加Element UI組件庫(kù)。Vue的寫法比原生JS更清晰數(shù)據(jù)驅(qū)動(dòng)視圖文件列表、上傳彈窗這些交互用組件化開(kāi)發(fā)會(huì)舒服很多。當(dāng)然如果說(shuō)題目里只寫了基于JS用原生JS照樣可以做只是開(kāi)發(fā)速度慢一些。我的建議是如果自己有Vue基礎(chǔ)就用Vue如果完全不會(huì)框架用原生JS配合jQuery也能完成只要確保和后端交互是標(biāo)準(zhǔn)HTTP接口即可。前后端分離以后開(kāi)發(fā)的時(shí)候啟動(dòng)兩個(gè)服務(wù)前端開(kāi)發(fā)服務(wù)器和后端Java進(jìn)程。遇到跨域問(wèn)題不要怕后面我會(huì)專門講CORS怎么配。重要的是不要在前端JS里寫死絕對(duì)路徑所有環(huán)境相關(guān)配置放到全局配置里統(tǒng)一管理。1.3 系統(tǒng)架構(gòu)設(shè)計(jì)整個(gè)系統(tǒng)的架構(gòu)并不復(fù)雜思路如下。前端頁(yè)面通過(guò)瀏覽器發(fā)起HTTP請(qǐng)求請(qǐng)求走到后端的Controller層。Controller負(fù)責(zé)接收參數(shù)、校驗(yàn)參數(shù)、調(diào)用Service再返回統(tǒng)一格式的JSON給前端。Service層處理具體業(yè)務(wù)邏輯比如文件上傳時(shí)判斷大小、生成存儲(chǔ)路徑、更新數(shù)據(jù)庫(kù)記錄。數(shù)據(jù)訪問(wèn)用MyBatis Plus內(nèi)置的BaseMapper常規(guī)的增刪改查不需要手寫SQL只有遞歸查詢目錄、多表統(tǒng)計(jì)這種特殊場(chǎng)景需要自定義XML。工程內(nèi)的包結(jié)構(gòu)大概是controller控制層service業(yè)務(wù)層mapper數(shù)據(jù)訪問(wèn)層entity數(shù)據(jù)庫(kù)實(shí)體dto前端出入?yún)⒎庋bconfig配置類utils工具類另外為了統(tǒng)一返回消息我寫了一個(gè)單獨(dú)的結(jié)果封裝類比如返回碼200表示成功500表示業(yè)務(wù)異常。所有Controller接口都返回這個(gè)封裝前端根據(jù)返回碼統(tǒng)一處理錯(cuò)誤提示這樣不需要每個(gè)接口單獨(dú)寫異常邏輯。提示前期架構(gòu)可以簡(jiǎn)單但結(jié)果封裝和異常處理務(wù)必要統(tǒng)一。前期偷懶只返回裸數(shù)據(jù)后期加了復(fù)雜頁(yè)面之后前端會(huì)被各種非標(biāo)準(zhǔn)返回搞得焦頭爛額。2. 數(shù)據(jù)庫(kù)設(shè)計(jì)與核心表結(jié)構(gòu)2.1 用戶表設(shè)計(jì)用戶表我用了這張結(jié)構(gòu)字段名id、username、password、nickname、avatar、create_time、status。id是自增主鍵。username要加唯一索引避免注冊(cè)時(shí)重名。password存BCrypt加密后的密文絕對(duì)禁止明文。avatar可以先存一個(gè)字符串路徑指向服務(wù)器上的頭像圖片鏈接也可以不做頭像功能完全省掉。status用于禁用賬戶1表示正常0表示禁用。注冊(cè)接口的邏輯很簡(jiǎn)單先檢查用戶名是否已存在存在則提示用戶名已被注冊(cè)不存在則用BCrypt工具類加密密碼寫入。登錄接口查詢用戶名和密碼匹配匹配成功生成JWT令牌返回給前端。這里要注意用戶密碼的密文長(zhǎng)度一般60位在數(shù)據(jù)庫(kù)里字段長(zhǎng)度不要建短了我遇到過(guò)有人把密碼字段設(shè)置成varchar(32)結(jié)果BCrypt密文根本存不下。2.2 文件信息表設(shè)計(jì)文件表是整個(gè)系統(tǒng)的核心字段比較多。我用的核心字段是id文件IDfile_name文件名file_size文件大小單位字節(jié)file_type文件類型比如image/png、application/pdffile_path存儲(chǔ)的相對(duì)路徑不含根目錄前綴user_id所屬用戶IDparent_id父目錄ID0表示根目錄folder_flag是否文件夾1是0否del_flag邏輯刪除標(biāo)記0正常1已刪除create_time創(chuàng)建時(shí)間update_time更新時(shí)間這里有一個(gè)關(guān)鍵點(diǎn)很多初學(xué)者喜歡把文件的實(shí)際存儲(chǔ)路徑直接存一個(gè)絕對(duì)路徑比如C:\server\data\user1\abc.txt。這個(gè)在本地跑沒(méi)問(wèn)題但是部署到服務(wù)器上服務(wù)器環(huán)境和本地不一致很可能路徑就失效了。正確做法是存相對(duì)路徑比如user/1/2025/03/abc.txt在啟動(dòng)配置里設(shè)置一個(gè)根目錄結(jié)合起來(lái)才是完整物理路徑。我做的系統(tǒng)就是上傳后先根據(jù)用戶ID生成一個(gè)目錄用戶ID然后把文件寫到根目錄下的用戶ID目錄里數(shù)據(jù)庫(kù)中只存用戶ID/文件名的相對(duì)路徑。第二個(gè)關(guān)鍵點(diǎn)是文件夾本身也要在文件表里占一條記錄。folder_flag1表示這條記錄是一個(gè)文件夾記錄沒(méi)有實(shí)際物理文件file_path可以為空但有parent_id用于確定歸屬。這樣文件夾樹(shù)和管理操作全都是同一張表不需要額外的目錄表。2.3 分享表設(shè)計(jì)分享功能只需要一張表。字段包括id分享IDshare_token隨機(jī)生成的短鏈接標(biāo)志用UUID去掉橫線的形式user_id分享者IDfile_id被分享的文件IDextract_code提取碼4到6位隨機(jī)數(shù)字expire_time過(guò)期時(shí)間status狀態(tài)1有效0失效每次生成分享時(shí)后端生成share_token和extract_code把文件ID和分享者ID寫進(jìn)去。其他用戶訪問(wèn)分享鏈接時(shí)后端通過(guò)share_token拿到分享記錄判斷是否過(guò)期。然后前端頁(yè)面上輸入提取碼比對(duì)成功后返回文件信息文件信息如果是文件夾則返回該文件夾下的文件列表如果是一個(gè)普通文件則可以直接觸發(fā)下載。這里要注意分享文件夾的場(chǎng)景在提取碼校驗(yàn)通過(guò)后訪問(wèn)文件夾下的子文件時(shí)還需要校驗(yàn)子文件的歸屬是否確實(shí)在這個(gè)分享文件夾下不然容易被越權(quán)訪問(wèn)。2.4 回收站與邏輯刪除設(shè)計(jì)回收站我不建議單獨(dú)建表原因很簡(jiǎn)單文件表已經(jīng)足夠承載這個(gè)邏輯了。在文件表里加一個(gè)del_flag字段刪除文件時(shí)只是把del_flag改成1同時(shí)更新時(shí)間置為當(dāng)前時(shí)間?；厥照卷?yè)面查詢時(shí)條件加上del_flag1就能把刪除過(guò)的文件撈出來(lái)。點(diǎn)擊恢復(fù)時(shí)把del_flag改回0同時(shí)可能需要檢查父ID是否還存在防止父目錄已經(jīng)被徹底刪除導(dǎo)致無(wú)法掛載。徹底刪除時(shí)才真正刪除數(shù)據(jù)庫(kù)記錄并調(diào)用文件工具類刪除物理文件。這個(gè)邏輯對(duì)比單獨(dú)建回收站表要清爽很多也便于后面加回收站保留天數(shù)這樣的擴(kuò)展需求。注意邏輯刪除容易出現(xiàn)的一個(gè)坑是查詢文件列表時(shí)忘了加del_flag0條件導(dǎo)致回收站里的文件出現(xiàn)在正常列表里。如果使用MyBatis Plus可以給文件表實(shí)體加TableLogic注解做全局邏輯刪除這樣內(nèi)置的selectList方法會(huì)自動(dòng)追加del_flag0條件省心很多。3. 核心功能模塊的實(shí)現(xiàn)細(xì)節(jié)3.1 用戶認(rèn)證與JWT權(quán)限控制登錄認(rèn)證這塊我選擇了JWT。原因是項(xiàng)目一旦前后端分離服務(wù)端如果還用Session就會(huì)面臨跨域共享Session、跨服務(wù)部署Session不一致的問(wèn)題。JWT的思路是登錄成功后把用戶ID和過(guò)期時(shí)間聲明進(jìn)一個(gè)加密的Token前端保存Token之后每個(gè)請(qǐng)求在Header里帶上。后端寫一個(gè)攔截器統(tǒng)一解析效率高也不需要額外的Redis存儲(chǔ)。JWT工具類我封裝了兩個(gè)方法一個(gè)是生成Token一個(gè)是解析Token。生成Token時(shí)把用戶ID作為claim放進(jìn)去同時(shí)設(shè)置過(guò)期時(shí)間為24小時(shí)。攔截器在每個(gè)請(qǐng)求里讀取Header的Authorization字段去掉Bearer前綴后解析。如果解析成功就把用戶ID放入ThreadLocal如果解析失敗則返回401錯(cuò)誤。登錄注冊(cè)等少數(shù)公開(kāi)接口需要放行。攔截器注冊(cè)的時(shí)候要特別注意放行順序。比如用Spring Boot的注冊(cè)方式攔截器對(duì)所有路徑生效需要在addPathPatterns時(shí)設(shè)置放行路徑列表。我在實(shí)際開(kāi)發(fā)中就把文件下載接口忘記放行結(jié)果前端跳轉(zhuǎn)瀏覽器的下載鏈接全部被攔截排查了很久才發(fā)現(xiàn)問(wèn)題是攔截器把所有下載請(qǐng)求攔截了不僅沒(méi)有返回文件流還返回了JSON錯(cuò)誤瀏覽器直接下載了一個(gè)json錯(cuò)誤文件。這個(gè)經(jīng)驗(yàn)值得記住。3.2 文件上傳與分片秒傳實(shí)現(xiàn)文件上傳是最容易出問(wèn)題的模塊。常規(guī)上傳后端接口就是接收MultipartFile參數(shù)獲取文件名和大小然后把文件寫到磁盤上再保存一條記錄到數(shù)據(jù)庫(kù)。但真實(shí)業(yè)務(wù)里大文件上傳如果不做處理用戶傳幾個(gè)GB的文件基本必失敗不是連接超時(shí)就是內(nèi)存溢出。我的方案是分片上傳。前端把文件切片每片大小5MB然后循環(huán)調(diào)用上傳接口上傳接口接收文件分片以及一個(gè)分片編號(hào)還有一個(gè)上傳ID用來(lái)標(biāo)識(shí)同一個(gè)文件的分片集合。每個(gè)分片作為臨時(shí)文件存到臨時(shí)目錄全部上傳完成后前端調(diào)用合并接口后端把所有分片按編號(hào)拼接成一個(gè)完整文件。這樣即使傳到一半網(wǎng)絡(luò)斷了也能重新上傳未完成的分片而不需要重頭再傳。這里核心代碼如下Controller接收分片時(shí)用到MultipartFile和RequestParamPostMapping(/upload/chunk) public Result uploadChunk(RequestParam(file) MultipartFile file, RequestParam(uploadId) String uploadId, RequestParam(chunkIndex) int chunkIndex) { String tempDir storageConfig.getRootPath() /tmp/ uploadId; File dir new File(tempDir); if (!dir.exists()) dir.mkdirs(); file.transferTo(new File(dir, String.valueOf(chunkIndex))); return Result.ok(); }秒傳功能就是另一個(gè)思路了。上傳前前端用JavaScript讀取文件的MD5值調(diào)用后端接口查詢?cè)撐募欠褚呀?jīng)存在于共用文件庫(kù)中。如果存在直接給當(dāng)前用戶生成一條文件記錄不再寫入實(shí)際文件。我做的個(gè)人云盤系統(tǒng)里沒(méi)有做全局去重庫(kù)但可以先在用戶自己的文件目錄里查詢?nèi)绻琈D5文件已存在則直接建立引用關(guān)系避免重復(fù)存儲(chǔ)。實(shí)際開(kāi)發(fā)時(shí)推薦加一個(gè)獨(dú)立的文件指紋表字段包括MD5、文件大小、物理路徑、被引用次數(shù)這樣才能支撐真正的秒傳。分片上傳的合并操作要小心不要把所有分片內(nèi)容一次性讀入內(nèi)存應(yīng)該用InputStream循環(huán)讀取每個(gè)分片文件然后按順序?qū)懭隣utputStream。合并完成之后再刪除臨時(shí)分片文件。這個(gè)過(guò)程中還要注意處理并發(fā)上傳同一個(gè)上傳ID的情況避免合并時(shí)文件被占用。3.3 文件下載與在線預(yù)覽文件下載接口的核心是返回文件流。我用了Spring的ResponseEntity 讀取文件為Resource設(shè)置Content-Type和Content-Disposition。這里的坑主要在中英文文件名。中文文件名如果直接放到Content-Disposition里不同瀏覽器展示效果不一樣最穩(wěn)妥的做法是用URLEncoder編碼然后前端或者瀏覽器會(huì)自動(dòng)解碼。另外自己拼接HTTP響應(yīng)頭時(shí)要注意header不能包含換行符否則會(huì)在安全掃描中被判為注入漏洞。在線預(yù)覽的話圖片和文本最簡(jiǎn)單。圖片直接通過(guò)接口返回原始二進(jìn)制前端用一個(gè)組件接收blob流來(lái)展示。文本文件讀取時(shí)要注意編碼UTF-8文件正常GBK文件會(huì)出現(xiàn)亂碼。我的處理方式是先通過(guò)工具讀取文件的前幾百個(gè)字節(jié)嘗試判斷編碼然后按對(duì)應(yīng)編碼讀取內(nèi)容再轉(zhuǎn)成UTF-8返回給前端。這樣預(yù)覽體驗(yàn)會(huì)好很多。PDF和Office文件預(yù)覽要復(fù)雜一些需要第三方組件轉(zhuǎn)碼或者使用在線預(yù)覽服務(wù)依賴環(huán)境我在畢設(shè)項(xiàng)目中就沒(méi)有做復(fù)雜的在線編輯只展示了圖片、文本、視頻音頻這幾種常見(jiàn)的。3.4 文件管理接口設(shè)計(jì)文件管理包括根目錄列表、進(jìn)入子目錄、新建文件夾、重命名、移動(dòng)文件、刪除文件。接口設(shè)計(jì)其實(shí)都圍繞文件表。根目錄列表就是查詢user_id當(dāng)前用戶ID AND parent_id0 AND del_flag0的所有文件。進(jìn)入子目錄就是查詢parent_id某個(gè)ID的文件列表。新建文件夾就插入一條folder_flag1的記錄。重命名很簡(jiǎn)單直接更新file_name字段。移動(dòng)文件就是修改parent_id。刪除文件則是邏輯刪除。文件夾的刪除是特殊的因?yàn)樗沁f歸結(jié)構(gòu)。后端刪除文件夾時(shí)不能只刪當(dāng)前記錄需要先把文件夾下所有子文件找出來(lái)。我的處理辦法是用一個(gè)遞歸方法先查詢當(dāng)前文件夾的所有直接子節(jié)點(diǎn)對(duì)每個(gè)子節(jié)點(diǎn)如果是文件夾則遞歸調(diào)用如果是文件則刪除當(dāng)前記錄最后再刪除當(dāng)前文件夾記錄。在邏輯刪除模式下也可以只刪除當(dāng)前文件夾記錄然后讓子文件的信息在文件夾樹(shù)中懸掛但這種狀態(tài)恢復(fù)時(shí)很容易出錯(cuò)還是老老實(shí)實(shí)遞歸處理。前端展示文件樹(shù)時(shí)我建議不要一次性把所有層級(jí)的文件夾全部查出來(lái)。可以按需加載點(diǎn)擊文件夾時(shí)請(qǐng)求一次子文件接口。這樣接口簡(jiǎn)單數(shù)據(jù)量也小。如果確實(shí)需要展示整棵樹(shù)那就后端遞歸組裝樹(shù)形JSON前端用Vue的遞歸組件渲染。3.5 分享鏈接生成與回收站邏輯分享鏈接我在實(shí)現(xiàn)時(shí)用了兩個(gè)隨機(jī)值。一個(gè)是share_token作為鏈接的唯一標(biāo)識(shí)直接放在URL里另一個(gè)是extract_code作為輸入提取碼用戶訪問(wèn)分享頁(yè)面時(shí)必須輸入。分享者可以選擇分享有效天數(shù)比如1天、7天、永久。對(duì)應(yīng)后端記錄過(guò)期時(shí)間。校驗(yàn)時(shí)先比對(duì)share_token是否存在然后比對(duì)提取碼最后判斷是否過(guò)期。分享鏈接的生成邏輯很簡(jiǎn)單核心就是創(chuàng)建一條分享記錄public Share createShare(Long userId, Long fileId, Integer expireDays) { Share share new Share(); share.setUserId(userId); share.setFileId(fileId); share.setShareToken(UUID.randomUUID().toString().replace(-, )); share.setExtractCode(RandomUtil.randomNumbers(4)); if (expireDays ! null expireDays 0) { share.setExpireTime(LocalDateTime.now().plusDays(expireDays)); } share.setStatus(1); shareMapper.insert(share); return share; }回收站邏輯我在文件表里用del_flag實(shí)現(xiàn)文件表里有一個(gè)delete_time字段方便定時(shí)清理超過(guò)保留期的記錄。回收站頁(yè)面復(fù)用文件列表接口只不過(guò)查詢條件換成了del_flag1并且按刪除時(shí)間倒序?；謴?fù)操作和刪除正好相反將del_flag重置為0。徹底刪除時(shí)后臺(tái)會(huì)同時(shí)調(diào)用物理文件刪除方法。如果文件在多個(gè)地方被引用比如秒傳引用物理文件刪除還需要處理引用計(jì)數(shù)不能直接刪否則可能導(dǎo)致其他用戶文件缺失。我的系統(tǒng)沒(méi)有做跨用戶引用所以沒(méi)有這個(gè)顧慮但做擴(kuò)展時(shí)要注意。4. 實(shí)操過(guò)程中的關(guān)鍵配置與調(diào)試4.1 核心依賴與配置文件這個(gè)項(xiàng)目的pom.xml里依賴不需要很多主要包括spring-boot-starter-web、spring-boot-starter-validation、mybatis-plus-boot-starter、mysql-connector-java、jjwt、hutool-all、lombok。hutool這個(gè)工具包幫了很大忙生成隨機(jī)數(shù)、計(jì)算文件MD5、日期工具都用它省下大量重復(fù)代碼。application.yml這里沒(méi)有特別難的東西但有幾個(gè)配置容易出錯(cuò)。第一個(gè)是數(shù)據(jù)源url數(shù)據(jù)庫(kù)名要和本地建的一致時(shí)區(qū)必須加serverTimezoneAsia/Shanghai否則JDBC連接會(huì)報(bào)時(shí)區(qū)異常。第二個(gè)是MyBatis Plus的mapper-locations配置如果XML文件沒(méi)放到默認(rèn)classpath下需要手動(dòng)指定。第三個(gè)是文件上傳大小我設(shè)置了max-file-size: 512MBmax-request-size: 1GB。第四個(gè)是自定義存儲(chǔ)路徑Spring Boot里使用ConfigurationProperties讀取比如cloud.storage.root-path: ./data。這里的相對(duì)路徑要小心啟動(dòng)時(shí)的工作目錄不同會(huì)指向不同位置建議部署時(shí)使用絕對(duì)路徑。我貼上最核心的配置片段可以直接改用自己的spring: servlet: multipart: max-file-size: 512MB max-request-size: 1GB datasource: url: jdbc:mysql://localhost:3306/cloud_disk?serverTimezoneAsia/Shanghai username: root password: 123456 mybatis-plus: mapper-locations: classpath:mapper/*.xml configuration: log-impl: org.apache.ibatis.logging.stdout.StdOutImpl cloud: storage: root-path: ./data4.2 CORS跨域問(wèn)題前后端分離后跨域問(wèn)題基本是必踩的。如果前端項(xiàng)目跑在http://localhost:8080后端接口在http://localhost:8081這時(shí)候前端直接調(diào)后端接口瀏覽器就會(huì)因?yàn)榭缬驍r截。解決方式是在后端寫一個(gè)配置類實(shí)現(xiàn)WebMvcConfigurer在addCorsMappings方法里配置允許的源、方法、請(qǐng)求頭。我當(dāng)時(shí)的經(jīng)驗(yàn)是允許源可以直接用allowedOriginPatterns(*)開(kāi)發(fā)環(huán)境這么配最省事。allowedHeaders需要把Authorization放進(jìn)去否則帶了Token的請(qǐng)求會(huì)被瀏覽器預(yù)檢攔下來(lái)。配置類寫起來(lái)也不復(fù)雜直接貼出來(lái)Configuration public class CorsConfig implements WebMvcConfigurer { Override public void addCorsMappings(CorsRegistry registry) { registry.addMapping(/**) .allowedOriginPatterns(*) .allowedMethods(GET, POST, PUT, DELETE, OPTIONS) .allowedHeaders(*) .allowCredentials(true) .maxAge(3600); } }另外如果自己實(shí)現(xiàn)了攔截器跨域配置和攔截器之間還有順序問(wèn)題。前端的預(yù)檢請(qǐng)求是OPTIONS方法攔截器如果攔了OPTIONS請(qǐng)求就會(huì)導(dǎo)致預(yù)檢失敗。解決辦法是在攔截器里面判斷請(qǐng)求方法如果為OPTIONS則直接放行。4.3 上傳大小限制的完整配置Spring Boot對(duì)文件上傳的限制來(lái)自兩個(gè)地方。一是Spring MVC的配置spring.servlet.multipart.max-file-size和max-request-size默認(rèn)只有1MB和10MB不修改的話傳大文件馬上報(bào)FileSizeLimitExceededException。二是Tomcat服務(wù)器本身的連接器限制如果超過(guò)這個(gè)限制可能返回Connection reset前端看起來(lái)像是連接被服務(wù)器斷開(kāi)。我在做分片上傳時(shí)因?yàn)槊恳黄挥袔譓B主要是把分片大小調(diào)好整體上傳接口的max-file-size還不能設(shè)太小否則即使分片沒(méi)超過(guò)限制后端臨時(shí)文件處理也可能不被允許。綜合下來(lái)我直接把單文件上傳限制改成512MB請(qǐng)求總大小改成1GB基本能滿足大多數(shù)使用場(chǎng)景。這里補(bǔ)充一個(gè)容易忽略的知識(shí)點(diǎn)Spring Boot 2.x以上版本中如果使用了自定義的MultipartConfigElement配置類它的優(yōu)先級(jí)會(huì)覆蓋配置文件中的spring.servlet.multipart配置。我建議不要同時(shí)用兩種配置只保留yml配置就好否則出了問(wèn)題排查時(shí)會(huì)很困惑。4.4 日志配置與接口調(diào)試調(diào)試階段強(qiáng)烈建議把日志級(jí)別調(diào)到DEBUG至少在開(kāi)發(fā)環(huán)境要調(diào)。MyBatis Plus會(huì)在控制臺(tái)打印SQL日志你可以看到執(zhí)行的每條SQL對(duì)于排查數(shù)據(jù)有沒(méi)有查對(duì)很有幫助。另外可以開(kāi)啟Spring Boot的web日志查看請(qǐng)求和響應(yīng)的基本狀態(tài)。我習(xí)慣把項(xiàng)目里所有Controller接口的出入?yún)⒃贏OP里打一條日志打印請(qǐng)求地址、請(qǐng)求參數(shù)、耗時(shí)這個(gè)做法在聯(lián)調(diào)時(shí)省了無(wú)數(shù)口舌。前端調(diào)試我推薦用瀏覽器開(kāi)發(fā)者工具配合Postman。遇到上傳類接口異常先看請(qǐng)求體里file字段名稱和后端MultipartFile參數(shù)名是否一致不一致的話后端拿到的file就是null。遇到下載接口異常直接用Postman請(qǐng)求下載地址看返回的Content-Type和Content-Disposition是不是正確。如果返回的是JSON錯(cuò)誤則說(shuō)明請(qǐng)求被攔截器或者異常處理接管了。5. 常見(jiàn)問(wèn)題與避坑指南5.1 中文文件名亂碼問(wèn)題這個(gè)幾乎是所有網(wǎng)盤類項(xiàng)目都會(huì)碰上的問(wèn)題。表現(xiàn)是前端上傳中文文件后端保存到磁盤后文件名變成亂碼下載時(shí)設(shè)置的文件名也是亂碼。原因有兩層一是HTTP傳輸時(shí)編碼不是UTF-8二是Content-Disposition頭里不能直接放中文。解決辦法是前端在FormData里正常傳文件名后端獲取文件名后到輸出響應(yīng)時(shí)用URLEncoder.encode(fileName, UTF-8)重新編碼。如果保存到磁盤的文件名亂碼檢查一下服務(wù)器操作系統(tǒng)字符集和Tomcat的URIEncoding配置通常設(shè)成UTF-8就能解決。我寫下載接口的時(shí)候?qū)憫?yīng)頭做了一定處理關(guān)鍵在于文件名要編碼而不是直接拼接String encodedFileName URLEncoder.encode(fileName, UTF-8); response.setHeader(Content-Disposition, attachment; filename\ encodedFileName \);5.2 跨域配置正確但請(qǐng)求依然失敗遇到過(guò)一次很迷惑的問(wèn)題跨域配置看起來(lái)沒(méi)問(wèn)題但前端帶Authorization的請(qǐng)求依然失敗。后來(lái)發(fā)現(xiàn)是攔截器把OPTIONS預(yù)檢請(qǐng)求攔了。瀏覽器在發(fā)起復(fù)雜請(qǐng)求時(shí)會(huì)先發(fā)一個(gè)OPTIONS請(qǐng)求如果后端返回的不是成功響應(yīng)真實(shí)請(qǐng)求就不會(huì)發(fā)出。解決辦法很簡(jiǎn)單攔截器里對(duì)OPTIONS請(qǐng)求直接返回成功。這個(gè)坑我之前提過(guò)一次但值得再?gòu)?qiáng)調(diào)因?yàn)榕挪闀r(shí)很容易忽略攔截器的存在。5.3 文件路徑與部署環(huán)境不兼容本地寫的是絕對(duì)路徑比如某個(gè)盤符下的目錄部署到Linux服務(wù)器上直接找不到路徑。這是因?yàn)椴僮飨到y(tǒng)的路徑分隔符和磁盤掛載方式完全不同。規(guī)范做法是數(shù)據(jù)庫(kù)存相對(duì)路徑根目錄通過(guò)配置文件指定。我在制作這個(gè)系統(tǒng)時(shí)就把存儲(chǔ)根目錄放到配置文件里所有物理文件寫入時(shí)獲取根目錄再拼相對(duì)路徑這樣換機(jī)器只需要改一個(gè)配置項(xiàng)。另外在Java里拼接文件路徑時(shí)不要手寫斜杠統(tǒng)一用Paths.get或者File.separator否則在不同操作系統(tǒng)上會(huì)出現(xiàn)斜杠方向不一致的問(wèn)題。5.4 回收站恢復(fù)后文件夾結(jié)構(gòu)錯(cuò)亂恢復(fù)一個(gè)處于回收站的文件夾時(shí)如果原本的父目錄已經(jīng)被徹底刪除了會(huì)出現(xiàn)一條記錄指向一個(gè)不存在的父目錄。前端打開(kāi)這個(gè)文件夾就會(huì)查不到數(shù)據(jù)。解決辦法是恢復(fù)時(shí)先檢查父目錄是否存在如果不存在則把parent_id置為0也就是回到用戶根目錄。順帶還要檢查重命名沖突如果目標(biāo)位置已經(jīng)有同名文件恢復(fù)時(shí)自動(dòng)在文件名后面加一個(gè)后綴。5.5 文件流下載時(shí)無(wú)法終止連接下載大文件時(shí)如果用戶點(diǎn)擊了取消后端的輸出流可能還在寫入最終導(dǎo)致鏈路占用很久。如果并發(fā)下載的人多連接數(shù)會(huì)飆升。我給下載接口的ResponseEntity設(shè)置緩沖區(qū)并且前端取消時(shí)瀏覽器會(huì)關(guān)閉連接后端需要在寫入時(shí)處理IOException遇到異常就及時(shí)退出循環(huán)不要繼續(xù)寫。另外可以考慮用Servlet的異步輸出做高并發(fā)優(yōu)化但這個(gè)系統(tǒng)作為個(gè)人云盤并發(fā)量很小不用過(guò)度設(shè)計(jì)。這套個(gè)人云盤管理系統(tǒng)做下來(lái)我個(gè)人體感最難的其實(shí)不是寫代碼而是把文件操作的邏輯想清楚尤其是目錄層級(jí)、回收站、分享這些和“文件關(guān)系”相關(guān)的功能。一旦數(shù)據(jù)表設(shè)計(jì)合理后端的每個(gè)接口都很直白如果一開(kāi)始就草草建表后面補(bǔ)字段、改邏輯會(huì)非常痛苦。最后分享一個(gè)實(shí)用小技巧在開(kāi)發(fā)時(shí)可以提前在本地準(zhǔn)備一些不同類型的測(cè)試文件比如大文件、圖片、中文文件名、無(wú)擴(kuò)展名文件上傳下載和預(yù)覽每個(gè)環(huán)節(jié)都測(cè)一遍很多問(wèn)題是在這些邊界文件上會(huì)暴露出來(lái)。希望這篇文章能幫到準(zhǔn)備做類似項(xiàng)目的朋友。