管理系統(tǒng)實(shí)戰(zhàn):從零搭建到避坑指南)
1. 為什么這套老三樣組合至今仍是后臺(tái)管理系統(tǒng)的首選后臺(tái)管理系統(tǒng)這個(gè)東西做過的人都知道需求翻來覆去就那些登錄鑒權(quán)、菜單權(quán)限、增刪改查、分頁(yè)列表、表單校驗(yàn)、文件上傳。聽起來簡(jiǎn)單但真要從零搭一個(gè)能用的架子坑一點(diǎn)都不少。我前后用不同技術(shù)棧搭過七八個(gè)后臺(tái)系統(tǒng)繞了一大圈最后還是回到了SpringBoot MyBatis Thymeleaf這套組合上。原因很直接這套組合的心智負(fù)擔(dān)最低。SpringBoot 把配置和依賴管理全包了MyBatis 讓你對(duì) SQL 有完全的掌控權(quán)Thymeleaf 是服務(wù)端渲染頁(yè)面直接由后端吐出來不需要前后端分離那一套接口聯(lián)調(diào)、跨域處理、Token 傳遞的繁瑣流程。對(duì)于一個(gè)中小型后臺(tái)、內(nèi)部工具、或者個(gè)人項(xiàng)目來說這套方案的開發(fā)效率高得離譜。這篇文章我打算把整個(gè)搭建過程完整拆一遍從項(xiàng)目結(jié)構(gòu)設(shè)計(jì)、依賴選型、數(shù)據(jù)庫(kù)設(shè)計(jì)到核心的 CRUD 實(shí)現(xiàn)、分頁(yè)、權(quán)限攔截、模板布局再到實(shí)際開發(fā)中踩過的那些坑。適合有一定 Java 基礎(chǔ)、想快速上手一個(gè)完整后臺(tái)項(xiàng)目的朋友也適合那些做慣了前后端分離、想回頭看看服務(wù)端渲染方案到底香在哪的老手。文章里所有代碼和配置都是可以直接抄作業(yè)的我會(huì)把每個(gè)選擇背后的理由講清楚而不是甩一堆代碼讓你自己猜。先說清楚這套方案的定位它不適合高并發(fā)、大流量的 C 端產(chǎn)品也不適合需要復(fù)雜前端交互比如拖拽看板、實(shí)時(shí)協(xié)作的場(chǎng)景。但如果你要做的是一個(gè)幾十上百人用的內(nèi)部管理系統(tǒng)或者一個(gè)需要快速交付的 MVP那這套組合的性價(jià)比幾乎沒有對(duì)手。Thymeleaf 的模板復(fù)用能力配合 SpringBoot 的自動(dòng)配置一個(gè)中等復(fù)雜度的后臺(tái)兩三天出原型完全不是問題。2. 項(xiàng)目整體架構(gòu)設(shè)計(jì)與技術(shù)選型拆解2.1 分層結(jié)構(gòu)怎么劃分才不混亂很多人搭后臺(tái)系統(tǒng)一開始圖省事Controller 里直接寫 SQL、拼 HTML寫著寫著代碼就爛成一鍋粥。我的習(xí)慣是從第一天就嚴(yán)格分層哪怕項(xiàng)目再小。標(biāo)準(zhǔn)的分層是這樣的Controller 層只負(fù)責(zé)接收請(qǐng)求參數(shù)、調(diào)用 Service、返回視圖或重定向不寫任何業(yè)務(wù)邏輯。Service 層業(yè)務(wù)邏輯的核心事務(wù)控制放在這一層調(diào)用 Mapper 完成數(shù)據(jù)操作。Mapper 層只做數(shù)據(jù)庫(kù)交互一個(gè)方法對(duì)應(yīng)一條 SQL保持純粹。Entity / DTOEntity 對(duì)應(yīng)數(shù)據(jù)庫(kù)表結(jié)構(gòu)DTO 用于接收前端參數(shù)和返回給頁(yè)面兩者不要混用。為什么要 Entity 和 DTO 分開因?yàn)閿?shù)據(jù)庫(kù)字段和頁(yè)面需要的字段往往不一致。比如用戶表里有password字段但返回給頁(yè)面時(shí)絕對(duì)不能帶上再比如列表頁(yè)需要顯示角色名稱但用戶表里只存了role_id這時(shí)候就需要一個(gè) DTO 來承載聯(lián)表查詢的結(jié)果?;煊?Entity 會(huì)導(dǎo)致兩個(gè)問題一是敏感字段容易泄露到頁(yè)面二是表結(jié)構(gòu)一變頁(yè)面全崩。包結(jié)構(gòu)我一般這樣組織com.example.admin ├── controller // 控制器 ├── service // 業(yè)務(wù)接口 │ └── impl // 業(yè)務(wù)實(shí)現(xiàn) ├── mapper // MyBatis 接口 ├── entity // 數(shù)據(jù)庫(kù)實(shí)體 ├── dto // 數(shù)據(jù)傳輸對(duì)象 ├── config // 配置類 ├── interceptor // 攔截器 ├── common // 通用工具、常量、統(tǒng)一返回 └── AdminApplication // 啟動(dòng)類這個(gè)結(jié)構(gòu)看起來平平無奇但它的好處是職責(zé)邊界清晰。新人接手時(shí)看到mapper就知道是數(shù)據(jù)庫(kù)操作看到interceptor就知道是攔截邏輯不用滿項(xiàng)目找。2.2 為什么選 Thymeleaf 而不是 JSP 或前后端分離這是最多人糾結(jié)的點(diǎn)。我逐個(gè)說下我的判斷。JSP 的問題JSP 本質(zhì)上是 Servlet 容器的一部分打包成可執(zhí)行 JAR 后運(yùn)行會(huì)有各種路徑問題而且 JSP 的語(yǔ)法和 HTML 混在一起可讀性差現(xiàn)代 SpringBoot 項(xiàng)目基本已經(jīng)拋棄它了。Thymeleaf 是純 HTML 模板瀏覽器直接打開也能看到靜態(tài)效果前后端協(xié)作時(shí)前端可以先做好靜態(tài)頁(yè)面后端再往里填數(shù)據(jù)。前后端分離的問題分離方案Vue/React REST API當(dāng)然好但它引入了額外的復(fù)雜度——跨域配置、Token 管理、接口文檔維護(hù)、兩套代碼倉(cāng)庫(kù)。對(duì)于一個(gè)后臺(tái)管理系統(tǒng)來說這些成本很多時(shí)候是浪費(fèi)的。Thymeleaf 服務(wù)端渲染頁(yè)面直接由后端生成登錄狀態(tài)用 Session 管理簡(jiǎn)單直接。Thymeleaf 的核心優(yōu)勢(shì)在于它的模板片段復(fù)用。后臺(tái)系統(tǒng)的頁(yè)面結(jié)構(gòu)高度相似——頂部導(dǎo)航、左側(cè)菜單、內(nèi)容區(qū)這些用 Thymeleaf 的th:fragment和th:replace抽成公共片段改一處全站生效。這個(gè)能力在 JSP 里也有jsp:include但 Thymeleaf 的語(yǔ)法更自然而且支持在瀏覽器里直接預(yù)覽。提示Thymeleaf 默認(rèn)會(huì)緩存模板開發(fā)階段一定要在配置文件里關(guān)掉緩存否則改完 HTML 刷新頁(yè)面看不到變化會(huì)浪費(fèi)大量時(shí)間排查。2.3 依賴清單與版本選擇依賴這塊我不建議盲目追新后臺(tái)系統(tǒng)穩(wěn)定壓倒一切。下面是我實(shí)測(cè)比較穩(wěn)的一套組合依賴版本建議作用spring-boot-starter-web跟隨 SpringBoot 主版本W(wǎng)eb 支持spring-boot-starter-thymeleaf跟隨主版本模板引擎mybatis-spring-boot-starter2.3.xMyBatis 集成mysql-connector-j8.x數(shù)據(jù)庫(kù)驅(qū)動(dòng)pagehelper-spring-boot-starter1.4.x分頁(yè)插件spring-boot-starter-validation跟隨主版本參數(shù)校驗(yàn)lombok最新簡(jiǎn)化實(shí)體類SpringBoot 主版本我建議用2.7.x或者3.x。2.7.x 的優(yōu)勢(shì)是生態(tài)成熟、資料多遇到問題一搜就有答案3.x 用了 Jakarta EE 命名空間javax.*全部變成jakarta.*如果你參考的教程比較老直接上 3.x 會(huì)有一堆包名對(duì)不上的問題。新手我建議從 2.7.x 起步把整個(gè)流程跑通了再考慮升級(jí)。PageHelper 這個(gè)分頁(yè)插件值得單獨(dú)說一句。MyBatis 本身不帶分頁(yè)功能你得自己寫LIMIT語(yǔ)句還要單獨(dú)寫一個(gè)COUNT查詢。PageHelper 的做法是在你執(zhí)行查詢前調(diào)用PageHelper.startPage(pageNum, pageSize)它會(huì)自動(dòng)攔截下一條 SQL幫你拼上分頁(yè)和總數(shù)查詢。用起來非常省事但有個(gè)坑后面會(huì)講。3. 數(shù)據(jù)庫(kù)設(shè)計(jì)與核心表結(jié)構(gòu)落地3.1 后臺(tái)系統(tǒng)最少需要哪幾張表一個(gè)能跑起來的最小后臺(tái)我建議至少設(shè)計(jì)這幾張表用戶表、角色表、菜單表以及用戶角色關(guān)聯(lián)表、角色菜單關(guān)聯(lián)表。有人會(huì)問就做個(gè)簡(jiǎn)單后臺(tái)搞這么復(fù)雜干嘛我的經(jīng)驗(yàn)是權(quán)限這塊一開始不設(shè)計(jì)好后面加功能會(huì)非常痛苦。哪怕你現(xiàn)在只需要一個(gè)管理員賬號(hào)也建議把用戶和角色分開。因?yàn)闃I(yè)務(wù)一旦發(fā)展運(yùn)營(yíng)只能看訂單、財(cái)務(wù)只能看賬單這種需求一定會(huì)來。到時(shí)候你再去改表結(jié)構(gòu)、改代碼成本比一開始就設(shè)計(jì)好高得多。核心表結(jié)構(gòu)大致如下-- 用戶表 CREATE TABLE sys_user ( id BIGINT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(50) NOT NULL UNIQUE, password VARCHAR(100) NOT NULL, nickname VARCHAR(50), status TINYINT DEFAULT 1 COMMENT 1啟用 0禁用, create_time DATETIME DEFAULT CURRENT_TIMESTAMP ); -- 角色表 CREATE TABLE sys_role ( id BIGINT PRIMARY KEY AUTO_INCREMENT, role_name VARCHAR(50) NOT NULL, role_code VARCHAR(50) NOT NULL UNIQUE ); -- 用戶角色關(guān)聯(lián) CREATE TABLE sys_user_role ( user_id BIGINT NOT NULL, role_id BIGINT NOT NULL, PRIMARY KEY (user_id, role_id) ); -- 菜單表 CREATE TABLE sys_menu ( id BIGINT PRIMARY KEY AUTO_INCREMENT, parent_id BIGINT DEFAULT 0, menu_name VARCHAR(50) NOT NULL, url VARCHAR(200), icon VARCHAR(50), sort_order INT DEFAULT 0 ); -- 角色菜單關(guān)聯(lián) CREATE TABLE sys_role_menu ( role_id BIGINT NOT NULL, menu_id BIGINT NOT NULL, PRIMARY KEY (role_id, menu_id) );3.2 密碼存儲(chǔ)與字段設(shè)計(jì)的幾個(gè)關(guān)鍵決策密碼絕對(duì)不能明文存。這是底線沒有商量余地。我用的是 BCryptSpring Security 里有現(xiàn)成的BCryptPasswordEncoder但如果你不想引入整個(gè) Spring Security它比較重可以單獨(dú)引入spring-security-crypto這個(gè)輕量包只為了用它的加密工具。BCrypt 的好處是它自帶鹽值每次加密同一個(gè)密碼得到的結(jié)果都不一樣但校驗(yàn)時(shí)能正確匹配。這比 MD5 加固定鹽安全得多。字段長(zhǎng)度給 100 是因?yàn)?BCrypt 生成的哈希串固定是 60 位留點(diǎn)余量。菜單表的parent_id設(shè)計(jì)成自關(guān)聯(lián)是為了支持多級(jí)菜單。后臺(tái)系統(tǒng)的菜單通常是樹形結(jié)構(gòu)——系統(tǒng)管理下面掛用戶管理角色管理菜單管理。用parent_id 0表示頂級(jí)菜單查詢時(shí)先查頂級(jí)再遞歸查子級(jí)或者一次性全查出來在內(nèi)存里組裝成樹。注意菜單的url字段要和 Controller 的映射路徑對(duì)應(yīng)上這是后面做權(quán)限攔截的基礎(chǔ)。如果 url 寫錯(cuò)了攔截器就攔不住會(huì)出現(xiàn)菜單看不到但直接輸網(wǎng)址能訪問的漏洞。3.3 初始化數(shù)據(jù)的準(zhǔn)備表建好后得先塞一條管理員數(shù)據(jù)進(jìn)去否則你連登錄都進(jìn)不去。密碼字段要填 BCrypt 加密后的值不能直接寫明文。你可以寫一個(gè)臨時(shí)的測(cè)試方法用BCryptPasswordEncoder().encode(你的密碼)生成哈希串然后手動(dòng)插進(jìn)數(shù)據(jù)庫(kù)。初始化菜單數(shù)據(jù)時(shí)我建議先把所有菜單的parent_id都設(shè)成 0等系統(tǒng)跑起來、菜單能正常顯示了再慢慢調(diào)整層級(jí)關(guān)系。一上來就搞復(fù)雜的樹形結(jié)構(gòu)調(diào)試起來很費(fèi)勁。4. 核心功能實(shí)現(xiàn)從登錄到增刪改查4.1 登錄鑒權(quán)與 Session 管理登錄邏輯本身不復(fù)雜接收用戶名密碼查庫(kù)比對(duì)成功就把用戶信息塞進(jìn) Session失敗就返回錯(cuò)誤提示。但有幾個(gè)細(xì)節(jié)必須處理好。第一密碼比對(duì)要用加密工具的 matches 方法不能自己寫字符串比較。BCrypt 每次加密結(jié)果不同直接比較哈希串永遠(yuǎn)不相等。第二登錄失敗不要提示用戶名不存在或密碼錯(cuò)誤統(tǒng)一提示用戶名或密碼錯(cuò)誤。這是為了防止有人通過錯(cuò)誤提示枚舉出系統(tǒng)里存在哪些用戶名。第三Session 里存什么。我一般存一個(gè)精簡(jiǎn)的用戶對(duì)象id、username、nickname、角色列表、權(quán)限菜單列表。不要把整個(gè) User 實(shí)體塞進(jìn)去尤其是密碼字段萬一哪天不小心在頁(yè)面里輸出了 Session 內(nèi)容密碼就泄露了。登錄成功后跳轉(zhuǎn)到后臺(tái)首頁(yè)首頁(yè)需要展示當(dāng)前用戶的菜單。菜單的獲取邏輯是根據(jù)用戶 id 查角色根據(jù)角色查菜單去重后按sort_order排序再組裝成樹形結(jié)構(gòu)返回給頁(yè)面。4.2 攔截器實(shí)現(xiàn)權(quán)限控制攔截器是這套方案里權(quán)限控制的核心。思路很簡(jiǎn)單寫一個(gè)HandlerInterceptor在preHandle方法里判斷當(dāng)前請(qǐng)求的路徑是否在用戶的權(quán)限菜單里不在就攔截。public class AuthInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { HttpSession session request.getSession(); Object user session.getAttribute(loginUser); if (user null) { response.sendRedirect(/login); return false; } return true; } }上面這個(gè)是最基礎(chǔ)的登錄攔截只判斷有沒有登錄。如果要做到菜單級(jí)權(quán)限還需要在 Session 里存一份當(dāng)前用戶可訪問的 url 集合preHandle里比對(duì)請(qǐng)求路徑。比對(duì)時(shí)要注意排除登錄頁(yè)、靜態(tài)資源、錯(cuò)誤頁(yè)這些不需要權(quán)限的路徑否則會(huì)陷入死循環(huán)——攔截器攔截了登錄頁(yè)用戶永遠(yuǎn)登不進(jìn)去。攔截器注冊(cè)時(shí)用addPathPatterns(/**)攔截所有請(qǐng)求再用excludePathPatterns排除掉白名單。白名單至少包括/login、/logout、/css/**、/js/**、/images/**、/error。實(shí)操心得靜態(tài)資源路徑一定要排除干凈。我踩過一次坑CSS 文件被攔截器攔下來重定向到登錄頁(yè)結(jié)果登錄頁(yè)樣式全丟排查了半天才發(fā)現(xiàn)是攔截器的問題。4.3 通用 CRUD 的模板化寫法后臺(tái)系統(tǒng)里 80% 的代碼都是增刪改查如果每個(gè)模塊都從頭寫一遍效率太低。我的做法是抽象出一套通用的寫法新模塊直接復(fù)制改改就行。以用戶管理為例一個(gè)完整的 CRUD 包含這幾個(gè)部分列表查詢帶分頁(yè)和條件搜索Controller 接收頁(yè)碼、每頁(yè)條數(shù)、搜索關(guān)鍵詞調(diào)用 ServiceService 里用 PageHelper 分頁(yè)返回一個(gè)PageInfo對(duì)象給頁(yè)面。頁(yè)面用 Thymeleaf 遍歷渲染表格底部渲染分頁(yè)條。新增和編輯這兩個(gè)功能通常共用一個(gè)表單頁(yè)面。新增時(shí)表單是空的編輯時(shí)表單回填數(shù)據(jù)。判斷依據(jù)是請(qǐng)求里有沒有 id 參數(shù)。Controller 里用GetMapping(/form)處理頁(yè)面跳轉(zhuǎn)用PostMapping(/save)處理提交。刪除一般用邏輯刪除而不是物理刪除也就是給表加一個(gè)deleted字段刪除時(shí)把它置為 1查詢時(shí)過濾掉。物理刪除一旦誤操作數(shù)據(jù)就找不回來了。邏輯刪除的代價(jià)是每條查詢都要帶WHERE deleted 0稍微麻煩點(diǎn)但安全。分頁(yè)這塊用 PageHelper 有個(gè)細(xì)節(jié)要注意PageHelper.startPage()必須緊挨著查詢語(yǔ)句調(diào)用中間不能插入其他數(shù)據(jù)庫(kù)操作否則分頁(yè)會(huì)作用到錯(cuò)誤的 SQL 上。我見過有人把startPage寫在方法開頭中間查了別的表結(jié)果分頁(yè)參數(shù)跑偏了。4.4 Thymeleaf 模板布局與片段復(fù)用Thymeleaf 最實(shí)用的功能就是片段復(fù)用。后臺(tái)系統(tǒng)的頁(yè)面結(jié)構(gòu)高度一致把公共部分抽出來能省大量重復(fù)代碼。我一般會(huì)建一個(gè)layout.html里面定義好頭部、側(cè)邊欄、內(nèi)容區(qū)的骨架內(nèi)容區(qū)用一個(gè)th:fragment占位。其他頁(yè)面通過th:replace引入這個(gè)布局把自己的內(nèi)容填進(jìn)去。!-- layout.html -- !DOCTYPE html html xmlns:thhttp://www.thymeleaf.org head meta charsetUTF-8 title th:text${pageTitle}后臺(tái)管理/title link relstylesheet th:href{/css/main.css} /head body div classheader th:replace~{fragments/header :: header}/div div classsidebar th:replace~{fragments/sidebar :: sidebar}/div div classcontent div th:replace${content}/div /div /body /html這種布局方式叫裝飾器模式Thymeleaf 官方推薦配合thymeleaf-layout-dialect使用但純用th:replace也能實(shí)現(xiàn)類似效果。新手我建議先用簡(jiǎn)單的th:replace把公共片段抽出來等熟悉了再上布局方言。菜單渲染是個(gè)重點(diǎn)。側(cè)邊欄菜單是樹形結(jié)構(gòu)Thymeleaf 里用嵌套的th:each遍歷。一級(jí)菜單遍歷一次每個(gè)一級(jí)菜單下面再遍歷它的子菜單。判斷當(dāng)前訪問的 url 是否等于菜單 url相等就加個(gè)高亮樣式讓用戶知道自己在哪個(gè)頁(yè)面。5. 開發(fā)過程中最容易踩的坑與排查實(shí)錄5.1 常見問題速查表我把這些年踩過的坑整理成一張表遇到問題可以先對(duì)照排查問題現(xiàn)象可能原因解決方向頁(yè)面 404模板路徑不對(duì) / Controller 映射不匹配檢查spring.thymeleaf.prefix配置和RequestMapping模板改了不生效模板緩存沒關(guān)配置spring.thymeleaf.cachefalse靜態(tài)資源 404攔截器攔截了靜態(tài)資源攔截器白名單加上/css/**等分頁(yè)總數(shù)不對(duì)PageHelper 調(diào)用位置錯(cuò)誤startPage緊貼查詢語(yǔ)句中文亂碼數(shù)據(jù)庫(kù)連接沒指定編碼JDBC url 加characterEncodingutf8登錄后立刻掉線Session 超時(shí)太短配置server.servlet.session.timeout表單提交 400參數(shù)類型不匹配檢查 DTO 字段類型和表單 nameMyBatis 找不到 Mapper沒加MapperScan啟動(dòng)類加注解指定包路徑5.2 幾個(gè)典型問題的深度排查問題一Thymeleaf 頁(yè)面報(bào)錯(cuò)但看不出具體原因。Thymeleaf 的報(bào)錯(cuò)信息有時(shí)候很含糊只說模板解析錯(cuò)誤不告訴你是哪一行。這時(shí)候可以打開 DEBUG 日志在配置文件里把logging.level.org.thymeleaf設(shè)成 DEBUG它會(huì)打印出詳細(xì)的解析過程。另一個(gè)技巧是先把模板里的動(dòng)態(tài)表達(dá)式一個(gè)個(gè)注釋掉定位到具體是哪段出的問題。問題二MyBatis 的駝峰映射失效。數(shù)據(jù)庫(kù)字段是create_time實(shí)體類屬性是createTime正常情況下 MyBatis 會(huì)自動(dòng)映射但有時(shí)候查出來是 null。原因是駝峰映射沒開啟。在配置文件里加上mybatis.configuration.map-underscore-to-camel-casetrue就能解決。這個(gè)配置我建議一開始就加上能省很多事。問題三事務(wù)不生效。Service 方法上加了Transactional但數(shù)據(jù)沒回滾。最常見的原因是方法不是 public 的或者同類內(nèi)部方法調(diào)用A 方法調(diào) B 方法B 上有事務(wù)注解。Spring 的事務(wù)是基于代理的內(nèi)部調(diào)用不走代理事務(wù)自然不生效。解決辦法是把 B 方法抽到另一個(gè) Service 里或者注入自己的代理對(duì)象。問題四分頁(yè)查詢后總數(shù)不對(duì)。PageHelper 返回的PageInfo里有個(gè)total字段正常情況下是總記錄數(shù)。但如果你的查詢語(yǔ)句里有GROUP BY或者復(fù)雜的子查詢PageHelper 自動(dòng)生成的 count 語(yǔ)句可能算錯(cuò)。這時(shí)候需要手動(dòng)寫 count 查詢用PageInfo的構(gòu)造方法傳入自定義的總數(shù)。5.3 獨(dú)家避坑經(jīng)驗(yàn)經(jīng)驗(yàn)一開發(fā)階段一定要開 SQL 日志。在配置文件里把 MyBatis 的日志實(shí)現(xiàn)設(shè)成org.apache.ibatis.logging.stdout.StdOutImpl這樣每條執(zhí)行的 SQL 和參數(shù)都會(huì)打印到控制臺(tái)。排查問題時(shí)一眼就能看出 SQL 拼得對(duì)不對(duì)、參數(shù)傳得對(duì)不對(duì)。上線前記得關(guān)掉否則日志量太大。經(jīng)驗(yàn)二表單提交前先做前端校驗(yàn)后端也要再校驗(yàn)一遍。前端校驗(yàn)是為了用戶體驗(yàn)后端校驗(yàn)是為了安全。永遠(yuǎn)不要相信前端傳來的數(shù)據(jù)因?yàn)檎?qǐng)求可以被偽造。用spring-boot-starter-validation的注解NotBlank、Size等在 DTO 上做校驗(yàn)Controller 參數(shù)加Valid校驗(yàn)失敗會(huì)自動(dòng)返回錯(cuò)誤信息。經(jīng)驗(yàn)三刪除操作一定要加二次確認(rèn)。不管是前端彈窗確認(rèn)還是后端加邏輯刪除目的都是防止誤刪。我見過有人手滑點(diǎn)錯(cuò)把整個(gè)用戶表清空了只能從備份恢復(fù)。邏輯刪除是最后的保險(xiǎn)。經(jīng)驗(yàn)四菜單權(quán)限和接口權(quán)限要分開控制。菜單權(quán)限控制的是用戶能看到哪些菜單接口權(quán)限控制的是用戶能調(diào)用哪些接口。只做菜單權(quán)限是不夠的因?yàn)橛脩艨梢灾苯虞?url 訪問。兩者都要做才能形成完整的權(quán)限閉環(huán)。6. 項(xiàng)目擴(kuò)展方向與個(gè)人實(shí)操體會(huì)這套基礎(chǔ)架子搭好之后能擴(kuò)展的方向其實(shí)很多。比如加一個(gè)操作日志模塊用 AOP 攔截所有增刪改操作記錄操作人、操作時(shí)間、操作內(nèi)容出問題時(shí)能追溯。再比如加一個(gè)定時(shí)任務(wù)模塊用 Spring 的Scheduled處理一些周期性的數(shù)據(jù)統(tǒng)計(jì)。還有文件上傳、數(shù)據(jù)導(dǎo)出 Excel、郵件通知這些都是后臺(tái)系統(tǒng)的常見需求按需往上加就行。我個(gè)人在實(shí)際操作中的體會(huì)是后臺(tái)系統(tǒng)的難點(diǎn)從來不在技術(shù)本身而在需求的邊界。一開始想清楚哪些功能要做、哪些不做比悶頭寫代碼重要得多。我見過太多項(xiàng)目做著做著需求不斷膨脹最后變成一個(gè)四不像。所以我的建議是先用這套方案搭一個(gè)最小可用的版本把核心流程跑通然后再根據(jù)實(shí)際使用中的反饋逐步迭代。最后再分享一個(gè)小技巧Thymeleaf 的模板可以配置成從文件系統(tǒng)加載而不是 classpath這樣改完 HTML 不用重啟應(yīng)用刷新頁(yè)面就能看到效果。配置方式是設(shè)置spring.thymeleaf.prefixfile:./src/main/resources/templates/開發(fā)階段非常提效。上線時(shí)再改回 classpath 模式保證打包后的資源路徑正確。