做過后臺管理系統(tǒng)的人大概都遇到過一個岔路口一個只有十來個人用的內(nèi)部工具需求三天兩頭改前端要做的其實就是列表、表單、彈窗、刪除確認這幾件事這時候如果上來就搞前后端分離光是接口聯(lián)調(diào)、跨域、權(quán)限透傳、部署兩套產(chǎn)物就能耗掉大半工期。我前陣子接手的一個運維臺賬系統(tǒng)就是這么個場景十來個頁面二十多張表交付周期四周最后定下來的技術(shù)組合就是標(biāo)題里這四樣SpringBoot 打底、MyBatis-Plus 干數(shù)據(jù)層、Thymeleaf 渲染頁面、AdminLTE 套殼。整套東西跑起來增刪改查這類活兒的開發(fā)節(jié)奏會非常快一個標(biāo)準(zhǔn)模塊從建表到頁面能點熟練的話兩三個小時就能出一版。這篇內(nèi)容想聊的就是這套組合在真實項目里的落地細節(jié)不是官方文檔的復(fù)述。適合的人大概有三類剛接觸 SpringBoot 想做點完整東西練手的手上有個內(nèi)部系統(tǒng)要快速交付、不想被前端工程化拖住的以及已經(jīng)會用這套棧但總在分頁、表單回顯、靜態(tài)資源這些地方反復(fù)卡殼的。我會把依賴版本的坑、MyBatis-Plus 分頁插件的正確姿勢、AdminLTE 接 Thymeleaf 的布局復(fù)用方式、還有增刪改查四個動作里那些文檔不會寫的細節(jié)一條一條攤開講。中間穿插的配置和代碼都是可以直接抄去改的遇到需要取舍的地方我會說清楚為什么這么選。1. 先想清楚這套四件套各自的邊界在哪1.1 服務(wù)端渲染在內(nèi)部系統(tǒng)里的性價比賬選型這件事最怕的是拿互聯(lián)網(wǎng) C 端的標(biāo)準(zhǔn)去套內(nèi)部管理系統(tǒng)。C 端產(chǎn)品用戶量大、交互復(fù)雜、首屏性能敏感前后端分離帶來的收益能覆蓋掉工程復(fù)雜度。但內(nèi)部臺賬、審批、配置管理這類系統(tǒng)頁面數(shù)量有限、交互模式高度重復(fù)、用戶就那幾十個首屏慢個三百毫秒沒人在意反而更在意這個字段能不能加一列這個查詢條件能不能多一個這種需求變更的速度。服務(wù)端渲染在這個場景下的優(yōu)勢很直接一個 Controller 方法配一個模板數(shù)據(jù)從數(shù)據(jù)庫到頁面是一條直線沒有中間層。改一個字段動的是實體類、Mapper 不用動、模板加一行、Controller 加一個取值五分鐘的事。換成前后端分離同樣的改動要動 DTO、接口、前端 model、前端表單、可能還有類型定義五個文件起步還得等前端同學(xué)排期。代價也要說清楚。Thymeleaf 的模板語法是在 HTML 屬性上做文章邏輯復(fù)雜了會很難看超過三層的條件嵌套基本就沒法維護了局部刷新能力弱想要個下拉聯(lián)動、表格無刷新編輯就得自己寫零散的 JSSEO 完全談不上不過內(nèi)部系統(tǒng)也不需要。我的判斷標(biāo)準(zhǔn)很簡單如果這個系統(tǒng)的主要使用者是公司內(nèi)部員工、頁面總數(shù)在五十個以內(nèi)、沒有復(fù)雜的前端狀態(tài)管理需求這套組合就是劃算的如果要做的是面向外部用戶的產(chǎn)品或者有大量實時交互那就老老實實上分離架構(gòu)。1.2 四個組件各管一段別讓職責(zé)串味實際寫代碼時最常見的混亂是把本該在 Service 層的邏輯塞進 Controller或者把查詢條件拼裝散落在模板里。這套棧里四樣?xùn)|西的職責(zé)其實很清晰組件負責(zé)的事不該干的事SpringBoot容器、依賴注入、配置、事務(wù)邊界不寫業(yè)務(wù)規(guī)則MyBatis-Plus單表 CRUD、條件構(gòu)造、分頁、邏輯刪除不處理展示格式、不做權(quán)限判斷Thymeleaf數(shù)據(jù)渲染、條件展示、循環(huán)、格式化不拼查詢條件、不做業(yè)務(wù)計算AdminLTE頁面骨架、樣式、常用交互組件不承載業(yè)務(wù)邏輯一個典型的分層寫法是Controller 只做參數(shù)接收、調(diào)用 Service、往 Model 里塞數(shù)據(jù)、返回視圖名Service 管事務(wù)和業(yè)務(wù)規(guī)則比如用戶名不能重復(fù)刪除前要檢查有沒有關(guān)聯(lián)數(shù)據(jù)Mapper 只管數(shù)據(jù)訪問。Thymeleaf 模板里只做展示判斷比如狀態(tài)字段是 0 還是 1 決定顯示什么顏色的標(biāo)簽。這個邊界守住了后面加需求才不會牽一發(fā)動全身。1.3 什么時候該果斷放棄這套方案我不太喜歡某某技術(shù)已死這種論調(diào)但確實有幾類需求不適合硬套。一是需要大量圖表實時刷新的看板Thymeleaf 渲染完就定死了后續(xù)全靠手寫 JS 輪詢不如直接上圖表庫配接口二是移動端適配要求高的場景AdminLTE 是桌面優(yōu)先的布局雖然響應(yīng)式做了但在手機上體驗一般三是需要多人協(xié)同編輯同一份數(shù)據(jù)的場景服務(wù)端渲染那套表單提交模型處理不了沖突合并。碰到這三類趁早換方案別等到寫了一半再返工。2. 骨架搭建依賴順序和版本對齊比想象中重要2.1 pom 里的依賴清單版本別隨手寫新建工程的時候最容易出事的就是版本。SpringBoot 版本、MyBatis-Plus 版本、Thymeleaf 版本三者之間有隱性約束尤其是 MyBatis-Plus它跟 SpringBoot 的適配是按大版本對應(yīng)的3.5.x 系列對 SpringBoot 2.x 和 3.x 的支持情況不一樣。我的做法是先用 Spring Initializr 生成一個干凈的骨架選定 SpringBoot 版本然后把 MyBatis-Plus 的版本號顯式寫上不依賴父 POM 的默認管理。dependencies dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-thymeleaf/artifactId /dependency dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-validation/artifactId /dependency dependency groupIdcom.baomidou/groupId artifactIdmybatis-plus-boot-starter/artifactId version3.5.5/version /dependency dependency groupIdcom.mysql/groupId artifactIdmysql-connector-j/artifactId scoperuntime/scope /dependency dependency groupIdorg.projectlombok/groupId artifactIdlombok/artifactId optionaltrue/optional /dependency /dependencies這里有兩個細節(jié)值得單獨拎出來。第一spring-boot-starter-validation必須單獨引入SpringBoot 2.3 之后校驗相關(guān)的包已經(jīng)從 web starter 里剝離了不引這個Valid注解會靜默失效——注意是靜默不報錯表單提交什么校驗都不觸發(fā)很容易查半天。第二MySQL 驅(qū)動在較新的 SpringBoot 里坐標(biāo)改成了com.mysql:mysql-connector-j老項目里常見的mysql:mysql-connector-java雖然還能用但會有告警新項目直接寫新的。如果你用的是 SpringBoot 3.xMyBatis-Plus 的 starter 也要換成mybatis-plus-spring-boot3-starter這個坐標(biāo)差異在官方文檔里不算顯眼但包名不一樣直接復(fù)制 2.x 的配置會啟動失敗報找不到自動配置類。2.2 application.yml 里必須動的那幾項配置文件這塊默認值大多能用但有四項我每次都會改server: port: 8080 servlet: encoding: charset: UTF-8 force: true spring: thymeleaf: cache: false prefix: classpath:/templates/ suffix: .html mode: HTML datasource: url: jdbc:mysql://127.0.0.1:3306/demo_db?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghaiallowPublicKeyRetrievaltrue username: demo password: demo123 driver-class-name: com.mysql.cj.jdbc.Driver mybatis-plus: configuration: map-underscore-to-camel-case: true log-impl: org.apache.ibatis.logging.stdout.StdOutImpl global-config: db-config: id-type: auto logic-delete-field: deleted logic-delete-value: 1 logic-not-delete-value: 0 mapper-locations: classpath*:/mapper/**/*.xmlthymeleaf.cache在開發(fā)期一定要關(guān)掉這個后面還會展開講它是最容易讓人懷疑人生的一個配置。map-underscore-to-camel-case默認是 true但顯式寫出來能避免接手別人項目時的困惑。log-impl打開 SQL 打印調(diào)試期非常有用上線前記得關(guān)掉不然日志量會很嚇人。serverTimezone這個參數(shù)不能省省了在寫入LocalDateTime的時候可能差八小時而且是那種數(shù)據(jù)看著對、時間就是不對的詭異問題。數(shù)據(jù)源連接串里的allowPublicKeyRetrievaltrue是配合較新版本 MySQL 的認證插件用的不加的話在某些環(huán)境下會報公鑰檢索失敗。這個參數(shù)涉及安全邊界只在本地和內(nèi)網(wǎng)開發(fā)環(huán)境用生產(chǎn)環(huán)境按各自的數(shù)據(jù)庫規(guī)范走。3. MyBatis-Plus 數(shù)據(jù)層從實體映射到分頁查詢的完整鏈路3.1 實體類和表結(jié)構(gòu)的映射約定MyBatis-Plus 默認有一套約定類名轉(zhuǎn)下劃線對應(yīng)表名字段名轉(zhuǎn)下劃線對應(yīng)列名。遵守約定能省掉大量注解。我在項目里通常就三條規(guī)則表名統(tǒng)一加業(yè)務(wù)前綴比如sys_user、biz_order主鍵統(tǒng)一叫id且自增每張表都帶create_time、update_time、deleted三個公共字段。Data TableName(sys_user) public class SysUser { TableId(type IdType.AUTO) private Long id; private String username; private String realName; private String phone; private Integer status; TableField(fill FieldFill.INSERT) private LocalDateTime createTime; TableField(fill FieldFill.INSERT_UPDATE) private LocalDateTime updateTime; TableLogic private Integer deleted; }TableLogic這個注解是邏輯刪除的核心。加上它之后所有通過 MyBatis-Plus 生成的刪除語句都會自動變成UPDATE ... SET deleted 1查詢語句會自動追加deleted 0。這個機制的好處是業(yè)務(wù)代碼里完全感知不到刪除的實現(xiàn)方式壞處是有幾個場景會失效手寫 XML 里的 SQL 不會自動加條件需要自己補update語句也不會自動過濾已刪除數(shù)據(jù)還有就是唯一索引要重新設(shè)計——如果username建了唯一索引刪掉一個用戶之后想再建同名用戶就會沖突因為那條軟刪除的記錄還在表里。軟刪除的唯一索引問題常見的解法是把deleted字段設(shè)計成刪除時寫入主鍵 ID而不是固定寫 1這樣聯(lián)合唯一索引(username, deleted)就能保證只有一條未刪除記錄。不過這樣配置就復(fù)雜一些小項目里我一般直接放棄用戶名唯一索引改在 Service 層做查重判斷簡單夠用。自動填充需要配一個處理器Component public class MetaHandler implements MetaObjectHandler { Override public void insertFill(MetaObject metaObject) { this.strictInsertFill(metaObject, createTime, LocalDateTime.class, LocalDateTime.now()); this.strictInsertFill(metaObject, updateTime, LocalDateTime.class, LocalDateTime.now()); } Override public void updateFill(MetaObject metaObject) { this.strictUpdateFill(metaObject, updateTime, LocalDateTime.class, LocalDateTime.now()); } }注意strictUpdateFill只對TableField(fill FieldFill.INSERT_UPDATE)標(biāo)注的字段生效如果實體類漏了這個注解填充不會執(zhí)行而且不會報錯。3.2 分頁插件必須先注冊否則分頁永遠返回全量這是我見過最多人踩的坑。MyBatis-Plus 從 3.4 開始分頁功能必須手動注冊攔截器不注冊的話Page對象傳進去也不報錯但total永遠是 0、records永遠是全表數(shù)據(jù)。很多人第一次遇到會以為是Page參數(shù)位置傳錯了查半天。Configuration public class MybatisPlusConfig { Bean public MybatisPlusInterceptor mybatisPlusInterceptor() { MybatisPlusInterceptor interceptor new MybatisPlusInterceptor(); PaginationInnerInterceptor pagination new PaginationInnerInterceptor(DbType.MYSQL); pagination.setMaxLimit(500L); pagination.setOverflow(false); interceptor.addInnerInterceptor(pagination); return interceptor; } }setMaxLimit(500L)是個保護措施防止前端傳個size999999把數(shù)據(jù)庫拖死。setOverflow(false)的意思是頁碼超出范圍時返回空列表而不是回到第一頁這個選擇看業(yè)務(wù)習(xí)慣我傾向于 false因為回到第一頁會讓用戶以為自己點錯了。分頁查詢配合條件構(gòu)造器的典型寫法public IPageSysUser pageQuery(UserQuery query, long current, long size) { PageSysUser page new Page(current, size); LambdaQueryWrapperSysUser wrapper new LambdaQueryWrapper(); wrapper.like(StringUtils.hasText(query.getUsername()), SysUser::getUsername, query.getUsername()) .eq(query.getStatus() ! null, SysUser::getStatus, query.getStatus()) .ge(query.getBeginTime() ! null, SysUser::getCreateTime, query.getBeginTime()) .le(query.getEndTime() ! null, SysUser::getCreateTime, query.getEndTime()) .orderByDesc(SysUser::getId); return this.page(page, wrapper); }LambdaQueryWrapper比QueryWrapper好在字段名是方法引用改字段名的時候編譯器會報錯字符串寫法的QueryWrapper只能等到運行時才發(fā)現(xiàn)列名寫錯了。條件構(gòu)造器里每個方法都有個重載版本第一個參數(shù)是布爾值用來控制這個條件是否生效這個特性在寫動態(tài)查詢時極其好用能避免大量 if 判斷。3.3 多條件搜索的拼接邏輯應(yīng)該放在哪條件拼接的位置有兩派做法放 Controller 里用參數(shù)逐個判斷或者放 Service 里封裝成一個方法。我傾向后者Controller 就負責(zé)把請求參數(shù)打包成一個查詢對象傳下去。這樣做的另一個好處是查詢參數(shù)可以做成一個獨立的類字段上直接掛校驗注解和日期格式注解。Data public class UserQuery { private String username; private Integer status; DateTimeFormat(pattern yyyy-MM-dd) private LocalDate beginTime; DateTimeFormat(pattern yyyy-MM-dd) private LocalDate endTime; }DateTimeFormat這個注解是給表單綁定用的處理的是從頁面提交上來的字符串到日期對象的轉(zhuǎn)換。如果是 JSON 接口用的是JsonFormat兩個注解長得像但作用域完全不同混用會導(dǎo)致日期綁不上、拋 400 錯誤。這個區(qū)別我在帶新人的時候解釋過很多遍本質(zhì)上就是數(shù)據(jù)來源不同表單走的是 Spring 的ConversionServiceJSON 走的是 Jackson。4. AdminLTE 接 Thymeleaf靜態(tài)資源、布局復(fù)用和腳本順序4.1 靜態(tài)資源目錄怎么擺路徑怎么寫才不打架AdminLTE 是一套基于 Bootstrap 的后臺模板下載下來是個完整的前端工程里面有dist、plugins兩個主要目錄。放進 SpringBoot 項目的正確位置是src/main/resources/static/放進去之后通過/dist/css/adminlte.min.css這樣的路徑就能訪問。目錄結(jié)構(gòu)我一般是這么組織的resources/ static/ dist/ AdminLTE 的 css、js plugins/ 各種插件fontawesome、jquery、bootstrap uploads/ 用戶上傳的圖片運行時生成 templates/ layout/ 公共片段 user/ 業(yè)務(wù)頁面 login.html有個細節(jié)很容易被忽略SpringBoot 的靜態(tài)資源默認映射到/**如果模板里寫的是link th:href{/dist/css/adminlte.min.css}加了{}語法之后SpringBoot 會自動處理上下文路徑。如果你的應(yīng)用部署在非根路徑下比如server.servlet.context-path/admin不用{}寫死的相對路徑全部會 404。這個坑在本地開發(fā)時完全發(fā)現(xiàn)不了因為本地默認是根路徑。上傳目錄的問題要單獨說一下。static/uploads這個位置在打成 jar 包之后是只讀的往里寫文件會失敗。生產(chǎn)環(huán)境應(yīng)該把上傳路徑配成一個外部目錄通過WebMvcConfigurer加資源映射Configuration public class WebConfig implements WebMvcConfigurer { Value(${app.upload-path}) private String uploadPath; Override public void addResourceHandlers(ResourceHandlerRegistry registry) { registry.addResourceHandler(/uploads/**) .addResourceLocations(file: uploadPath); } }這樣頁面里引用/uploads/xxx.png就能拿到外部目錄里的文件開發(fā)和生產(chǎn)的路徑差異用配置文件隔離。4.2 用 fragment 做布局復(fù)用別引額外的方言包Thymeleaf 復(fù)用頁面的方式有好幾種官方推薦的thymeleaf-layout-dialect用起來確實優(yōu)雅但它多一個依賴語法也自成一套團隊里如果新人多學(xué)習(xí)成本不太劃算。我一般用原生的 fragment 組合來實現(xiàn)。先定義公共片段!-- templates/layout/common.html -- !DOCTYPE html html xmlns:thhttp://www.thymeleaf.org head th:fragmenthead(title) meta charsetutf-8 title th:text${title}頁面標(biāo)題/title link th:href{/plugins/fontawesome-free/css/all.min.css} relstylesheet link th:href{/dist/css/adminlte.min.css} relstylesheet /head body nav th:fragmentnavbar classmain-header navbar navbar-expand navbar-white navbar-light ul classnavbar-nav li classnav-item a classnav-link>!DOCTYPE html html xmlns:thhttp://www.thymeleaf.org head th:replace~{layout/common :: head(用戶管理)}/head body classhold-transition sidebar-mini layout-fixed div classwrapper nav th:replace~{layout/common :: navbar}/nav aside th:replace~{layout/common :: sidebar}/aside div classcontent-wrapper section classcontent-header div classcontainer-fluid h1用戶管理/h1 /div /section section classcontent div classcontainer-fluid !-- 業(yè)務(wù)內(nèi)容 -- /div /section /div footer th:replace~{layout/common :: footer}/footer /div /body /htmlth:replace和th:insert的區(qū)別要說一下replace是用片段整體替換掉當(dāng)前標(biāo)簽insert是把片段塞進當(dāng)前標(biāo)簽內(nèi)部。用replace的時候當(dāng)前標(biāo)簽本身會被丟掉所以寫法上要保證被替換的標(biāo)簽類型跟片段的根標(biāo)簽一致。側(cè)邊欄的菜單高亮靠當(dāng)前路徑判斷a th:href{/user/list} classnav-link th:classappend${#httpServletRequest.requestURI.startsWith(/user)} ? active#httpServletRequest這個對象在 Thymeleaf 3 里默認是可用的不過在嚴格的安全配置下可能取不到取不到就退回用手動傳一個activeMenu變量的方式穩(wěn)一些。4.3 腳本加載順序不對頁面會靜默失靈AdminLTE 依賴 jQuery、Bootstrap、popper這幾個的順序不能亂。正確的寫法是 jQuery 在最前然后 bootstrap 的 bundle 版本自帶 popper最后才是 adminlte 的主腳本script th:src{/plugins/jquery/jquery.min.js}/script script th:src{/plugins/bootstrap/js/bootstrap.bundle.min.js}/script script th:src{/dist/js/adminlte.min.js}/script順序錯了的典型現(xiàn)象是折疊菜單點不開、下拉框點一下閃一下就關(guān)、彈窗出不來?？刂婆_可能只有一條$ is not defined或者干脆什么都沒有。我遇到過最隱蔽的一次是有人把 adminlte.min.js 放到了head里頁面骨架還沒渲染完腳本就執(zhí)行了界面看著正常但所有交互事件都沒綁上。所以腳本統(tǒng)一放/body前這是硬規(guī)矩。還有個版本匹配的坑AdminLTE 3 基于 Bootstrap 4AdminLTE 4 基于 Bootstrap 5。如果從網(wǎng)上復(fù)制了個 AdminLTE 3 的頁面模板又去引了 Bootstrap 5 的 CSS會出現(xiàn)間距全亂、圓角對不上、按鈕顏色偏色這類看著像但又不太像的問題。這種情況我的建議是一旦確定用哪個版本把整套靜態(tài)資源一次性拷全不要東拼西湊。5. 增刪改查四個動作真正花時間的都在細節(jié)里5.1 列表頁分頁、搜索條件回填與參數(shù)保持列表頁看著最簡單實際上坑最多。分頁組件要跟搜索條件共存翻到第二頁的時候搜索條件不能丟這個是最基本的要求。我的做法是 Controller 接收查詢對象和分頁參數(shù)把所有條件重新塞回 ModelGetMapping(/list) public String list(UserQuery query, RequestParam(defaultValue 1) long current, RequestParam(defaultValue 10) long size, Model model) { IPageSysUser page userService.pageQuery(query, current, size); model.addAttribute(page, page); model.addAttribute(query, query); return user/list; }模板里的分頁鏈接必須帶上搜索條件nav ul classpagination pagination-sm li classpage-item th:classappend${page.current 1} ? disabled a classpage-link th:href{/user/list(current${page.current - 1}, size${page.size}, username${query.username}, status${query.status})}上一頁/a /li li classpage-item th:eachi : ${#numbers.sequence(1, page.pages)} th:classappend${i page.current} ? active a classpage-link th:href{/user/list(current${i}, size${page.size}, username${query.username}, status${query.status})} th:text${i}1/a /li li classpage-item th:classappend${page.current page.pages} ? disabled a classpage-link th:href{/user/list(current${page.current 1}, size${page.size}, username${query.username}, status${query.status})}下一頁/a /li /ul /nav{...}語法里括號內(nèi)的參數(shù)會自動做 URL 編碼不用手動處理中文。這是 Thymeleaf 一個很實用的特性用字符串拼接的方式拼 URL 反而容易出問題。頁碼直接用#numbers.sequence全展開在數(shù)據(jù)量小的內(nèi)部系統(tǒng)里夠用。如果分頁超過二十頁這個寫法會把頁碼撐爆需要做滑動窗口那就得寫個小工具方法或者在 Controller 里算好beginPage和endPage傳給模板。內(nèi)部系統(tǒng)我一般不管頁面撐開了用戶自己會縮小范圍。搜索表單的回填也要注意th:value里如果原值是 null渲染出來是空字符串不會報錯但下拉框要注意選中狀態(tài)select namestatus classform-control option value全部狀態(tài)/option option value1 th:selected${query.status 1}啟用/option option value0 th:selected${query.status 0}停用/option /select這里有個類型陷阱query.status是Integer如果表單里value1Thymeleaf 在比較時做的是對象比較Integer(1) 1在 Thymeleaf 的表達式引擎里通常能自動拆箱成立但如果 status 是String類型就會失敗。我在項目里統(tǒng)一用Integer接狀態(tài)值避免這個歧義。5.2 新增和編輯表單復(fù)用、校驗失敗回顯與查重時機新增和編輯的頁面高度相似字段完全一樣區(qū)別只是有沒有初始值。復(fù)用同一個模板是標(biāo)準(zhǔn)做法用一個id是否為空來判斷GetMapping(/form) public String form(RequestParam(required false) Long id, Model model) { SysUser user id null ? new SysUser() : userService.getById(id); model.addAttribute(user, user); return user/form; }模板里所有th:value都綁到user對象的字段上新增時是空對象自然是空值。保存用兩個方法分別處理新增和修改不要試圖用一個方法通用因為校驗規(guī)則不一樣新增要查重修改要排除自己。校驗這塊PostMapping(/save) public String save(Valid ModelAttribute(user) SysUser user, BindingResult bindingResult, RedirectAttributes ra) { if (userService.existsUsername(user.getUsername(), user.getId())) { bindingResult.rejectValue(username, duplicate, 該登錄名已被占用); } if (bindingResult.hasErrors()) { return user/form; } userService.saveOrUpdate(user); ra.addFlashAttribute(msg, 保存成功); return redirect:/user/list; }ModelAttribute(user)里的名字很關(guān)鍵它決定了模板里用${user}能不能取到值。如果校驗失敗返回表單頁Model 里必須有這個對象ModelAttribute會自動把它塞進去。這一點如果漏了表現(xiàn)就是校驗失敗跳回表單頁結(jié)果所有已填內(nèi)容全空用戶得重新填一遍體驗極差。RedirectAttributes的addFlashAttribute是重定向后傳遞提示消息的標(biāo)準(zhǔn)做法數(shù)據(jù)存在 session 里跳轉(zhuǎn)后讀一次就沒了。如果用addAttribute參數(shù)會拼到 URL 上中文還得編碼很難看。表單模板里的錯誤提示div classform-group label登錄名 span classtext-danger*/span/label input typetext classform-control th:classappend${#fields.hasErrors(user.username)} ? is-invalid th:field*{username} div classinvalid-feedback th:if${#fields.hasErrors(user.username)} th:errors*{username}錯誤信息/div /divth:field*{username}會自動生成id、name、value三個屬性比手寫th:value更省事而且跟#fields的錯誤機制是配套的。用th:field的時候注意必須在form上掛th:object否則*{}語法找不到上下文。查重的時機也有講究。放在 Service 里做也行但那樣校驗失敗的信息拿不到BindingResult只能拋異?；蛘叻祷劐e誤碼頁面回顯就得另想辦法。放在 Controller 里配合bindingResult.rejectValue是這套棧下最順手的做法錯誤信息能直接出現(xiàn)在對應(yīng)字段下面。5.3 刪除單條、批量與邏輯刪除的取舍刪除功能最容易被輕視。一個GetMapping(/delete/{id})寫完就完事了看著能跑但這是典型的錯誤做法——GET 請求被瀏覽器預(yù)加載、被爬蟲抓取、被用戶誤刷新都能觸發(fā)刪除。刪必須用 POST。PostMapping(/delete) public String delete(RequestParam Long id, RedirectAttributes ra) { userService.removeById(id); ra.addFlashAttribute(msg, 刪除成功); return redirect:/user/list; } PostMapping(/batchDelete) public String batchDelete(RequestParam(ids) ListLong ids, RedirectAttributes ra) { userService.removeByIds(ids); ra.addFlashAttribute(msg, 已刪除 ids.size() 條); return redirect:/user/list; }前端確認用 AdminLTE 自帶的模態(tài)框或者confirm批量刪除要注意一個細節(jié)如果用戶一條都沒勾選就點刪除ids參數(shù)是空的Spring 綁定ListLong會直接拋 400。穩(wěn)妥的寫法是RequestParam(value ids, required false)進來先判空if (CollectionUtils.isEmpty(ids)) { ra.addFlashAttribute(msg, 請先選擇要刪除的記錄); return redirect:/user/list; }邏輯刪除的取舍前面提過一部分這里補充一個實際場景如果業(yè)務(wù)上需要回收站功能邏輯刪除是必須的如果數(shù)據(jù)完全不敏感物理刪除反而干凈因為軟刪除的記錄日積月累會讓表越來越大查詢還得帶條件。我的經(jīng)驗是涉及人員、訂單、財務(wù)這類數(shù)據(jù)的表用邏輯刪除配置項、日志這類表直接物理刪。混著用沒問題加不加TableLogic是按實體類控制的。6. 聯(lián)調(diào)階段最容易卡住的幾個現(xiàn)象與排查順序6.1 模板改了頁面不變先看緩存開關(guān)這個現(xiàn)象我第一次遇到時懷疑過 IDE 沒保存、懷疑過瀏覽器緩存、懷疑過 SpringBoot 沒熱加載折騰了快一個小時最后發(fā)現(xiàn)就是spring.thymeleaf.cachetrue。開發(fā)環(huán)境必須設(shè)成 false這個配置默認值在 SpringBoot 里是 true。即使關(guān)了緩存如果你改了模板但沒重新編譯而項目又是從target/classes里讀模板的那還是看不到變化。IDEA 里的做法是 Build 一次或者用spring-boot-devtools配合自動編譯。我用 devtools 的時候會把spring.thymeleaf.prefix指向file:src/main/resources/templates/直接從源碼目錄讀改完刷新就生效省掉編譯這一步spring: thymeleaf: prefix: file:src/main/resources/templates/ cache: false這個配置只能用在開發(fā)環(huán)境生產(chǎn)環(huán)境必須走 classpath。另外一個容易混淆的點改了 Java 代碼之后模板的變動可能被編譯覆蓋。排查順序我一般是配置文件有沒有生效 → 模板路徑對不對 → 編譯產(chǎn)物是不是最新的從外往里查比一上來就打斷點快。6.2 日期和數(shù)字的格式化Thymeleaf 里要靠工具類LocalDateTime直接輸出到頁面會是2024-03-15T10:23:45中間帶個 T很難看。格式化的寫法td th:text${#temporals.format(user.createTime, yyyy-MM-dd HH:mm)}時間/td#temporals是 Thymeleaf 3 內(nèi)置的處理 Java 8 時間類型的工具需要thymeleaf-extras-java8time依賴不過 SpringBoot 的 starter 里已經(jīng)包含了不用單獨引。如果是Date類型用的是#dates.format兩個工具類不能混用混了會報找不到方法?？罩堤幚硎橇硪粋€高頻問題。${user.realName}如果是 null頁面直接不渲染內(nèi)容不會報錯但#temporals.format(null, ...)會拋異常。穩(wěn)妥的寫法是td th:text${user.createTime ! null} ? ${#temporals.format(user.createTime, yyyy-MM-dd HH:mm)} : --/td金額類的字段用#numbers.formatDecimal(amount, 1, 2)保留兩位小數(shù)注意第一個參數(shù)是整數(shù)最少位數(shù)不是總位數(shù)這個參數(shù)含義經(jīng)常被搞反。6.3 靜態(tài)資源 404 與中文亂碼的分層排查靜態(tài)資源 404 的排查我有一套固定順序。先看 URL 對不對瀏覽器 F12 的網(wǎng)絡(luò)面板里能看到實際請求的路徑如果路徑里帶了../或者重復(fù)的/static/說明模板里的路徑寫錯了——{}語法不需要你手寫/static它對應(yīng)的就是static目錄的根。再看 Spring Security 有沒有攔截如果項目集成了安全框架靜態(tài)資源默認是要放行的配置里漏了requestMatchers(/dist/**, /plugins/**).permitAll()就會全 404。最后看打包方式j(luò)ar 包里的static目錄是通過 classpath 訪問的如果資源放的目錄名不是static比如放成了public或者resources那 SpringBoot 也能識別但目錄名拼錯就完了。中文亂碼分兩種。一種是請求參數(shù)亂碼表單提交的中文到后端變成問號這是編碼配置問題server.servlet.encoding.forcetrue加上頁面的charsetutf-8基本能解決。另一種是響應(yīng)內(nèi)容亂碼頁面上中文變成方塊或者亂碼通常是模板文件本身的編碼不對IDEA 里在文件右下角能看到當(dāng)前編碼確認是 UTF-8 就行。還有一種最隱蔽的數(shù)據(jù)庫連接的characterEncoding寫成了utf8但表是utf8mb4存表情符號的時候報錯或者截斷這個只能從建表語句開始統(tǒng)一。6.4 表單提交后提示信息不顯示addFlashAttribute存進去的消息在頁面里要用${msg}取。取不到的情況一般是重定向的地址跟存放的會話不一致或者頁面模板里漏了判斷div classalert alert-success alert-dismissible th:if${msg ! null} button typebutton classclose>