)
簡介這是一套面向Java Web初學者與課程設計者的都市供求信息網項目源碼采用前后臺分離設計適合用于畢業(yè)設計、課程實訓或自學練手。前臺覆蓋信息列表展示、分類瀏覽、詳情查看、定位搜索與模糊搜索以及信息發(fā)布后臺則實現信息列表與詳情顯示、信息審核、刪除、付費設置和退出登錄等管理功能完整呈現了一個供求信息平臺的業(yè)務閉環(huán)。壓縮包共106個文件約4.18MB以jsp頁面、java源文件與class編譯文件為核心輔以gif、jpg圖片素材、jar依賴包、xml與properties配置、js腳本及css樣式另含數據庫文件與項目元數據結構清晰便于導入運行。目前已有139人學習下載。通過研讀源碼可掌握Servlet與Action分層、數據庫操作封裝、分頁與搜索邏輯等常見Web開發(fā)要點并可直接參考其目錄組織與配置方式快速搭建同類信息發(fā)布系統(tǒng)。1. 都市供求信息網源碼拆解一個 Java Web 項目從跑起來到改得動的完整路徑拿到一份「都市供求信息網」的 Java 項目源碼很多人第一反應是找 README、翻配置文件、然后mvn spring-boot:run一把梭。但真正做過這類信息發(fā)布平臺的人都知道跑起來只是起點能不能改、改完會不會崩、并發(fā)上來數據對不對才是分水嶺。這個標題背后對應的是一類非常典型的 Java Web 練手項目用戶注冊登錄、供求信息發(fā)布、分類檢索、后臺審核技術棧大概率是 Spring Boot MyBatis/MyBatis-Plus MySQL Thymeleaf 或前后端分離。它適合兩類人一是想找一個完整業(yè)務閉環(huán)來練手的 Java 初學者二是需要快速搭一個信息發(fā)布類系統(tǒng)骨架的開發(fā)者。接下來我不講空泛的架構圖而是按「環(huán)境怎么配、表怎么建、核心接口怎么寫、哪里最容易翻車」的順序把這份源碼類項目拆到能直接抄作業(yè)的程度。2. 環(huán)境與依賴把都市供求信息網源碼在本地跑起來的最小步驟2.1 先確認 JDK 和 Maven 的版本匹配別讓編譯期就翻車這類項目源碼最常見的一個坑就是pom.xml里寫的 Java 版本和你本地 JDK 對不上。熱搜里那個「java: 警告: 源發(fā)行版 17 需要目標發(fā)行版 17」就是典型癥狀——不是代碼錯是編譯配置沒對齊。我一般會先看三處pom.xml的java.version、IDE 的 Project SDK、以及maven-compiler-plugin的 source/target。三處一致后面才省心。# 查看當前 JDK 版本確認與 pom.xml 中 java.version 一致 java -version # 查看 Maven 版本建議 3.6 mvn -v # 清理并跳過測試編譯先確認依賴能拉下來 mvn clean compile -DskipTests邏輯說明java -version確認運行時版本mvn -v確認構建工具可用。mvn clean compile是最小驗證動作能編譯通過說明依賴坐標沒寫錯、倉庫能訪問。參數上-DskipTests在首次拉依賴時能省時間但正式構建前建議去掉讓測試跑一遍暴露問題。如果編譯報「找不到符號」但代碼明明存在八成是 Lombok 沒裝插件或者注解處理器沒開。這類項目大量用Data、Slf4jIDE 不裝 Lombok 插件就會滿屏紅。2.2 數據庫建表與初始數據字符集和字段類型是兩個高頻雷區(qū)都市供求信息網這類項目的表結構通常圍繞「用戶表、信息分類表、供求信息表、評論/留言表」展開。建表時最容易忽略的是字符集——用默認的 latin1 存中文插入時不報錯查出來全是問號。我一般統(tǒng)一用utf8mb4排序規(guī)則utf8mb4_general_ci。-- 創(chuàng)建數據庫顯式指定字符集避免中文亂碼 CREATE DATABASE city_info DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; USE city_info; -- 供求信息主表標題、內容、分類、發(fā)布人、狀態(tài) CREATE TABLE info ( id BIGINT PRIMARY KEY AUTO_INCREMENT, title VARCHAR(120) NOT NULL, content TEXT, category_id INT NOT NULL, user_id BIGINT NOT NULL, status TINYINT DEFAULT 0 COMMENT 0待審 1通過 2駁回, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, INDEX idx_category (category_id), INDEX idx_status_time (status, create_time) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;邏輯說明status用 TINYINT 而不是 VARCHAR是為了后臺審核狀態(tài)流轉時能用整型比較索引效率更高。idx_status_time復合索引服務于「按狀態(tài)篩選 按時間倒序」這個最高頻的查詢。參數上VARCHAR(120)對標題夠用TEXT給正文別一上來就LONGTEXT浪費空間還拖慢排序。初始數據里通常有一個管理員賬號密碼多半是 MD5 或 BCrypt 存進去的。如果你拿到的是明文密碼字段登錄時記得看login接口里有沒有做加密比對不然你輸明文永遠登不進去。2.3 配置文件三處必改端口、數據源、文件上傳路徑源碼里的application.yml或application.properties是跑起來的關鍵。我一般按順序改三處服務端口、數據庫連接、上傳目錄。上傳目錄尤其容易被忽略——默認路徑可能是作者機器上的絕對路徑到你這里直接報「目錄不存在」。server: port: 8080 spring: datasource: url: jdbc:mysql://localhost:3306/city_info?useUnicodetruecharacterEncodingutf8mb4serverTimezoneAsia/Shanghai username: root password: your_password driver-class-name: com.mysql.cj.jdbc.Driver servlet: multipart: max-file-size: 10MB max-request-size: 20MB # 自定義上傳路徑改成你本地真實存在的目錄 file: upload-path: /data/upload/city_info/邏輯說明serverTimezoneAsia/Shanghai不加的話MySQL 8 驅動可能報時區(qū)錯誤。max-file-size控制單文件max-request-size控制整個請求圖片上傳場景兩個都要設。file.upload-path是自定義配置代碼里用Value(${file.upload-path})注入改完記得手動mkdir -p建目錄程序不會自動創(chuàng)建。提示如果啟動報Access denied for user先確認 MySQL 用戶權限和密碼再確認url里的庫名拼寫。這兩處占登錄失敗原因的八成。3. 核心業(yè)務接口供求信息發(fā)布與檢索的代碼骨架3.1 信息發(fā)布接口參數校驗和狀態(tài)初始化別偷懶發(fā)布接口是整個系統(tǒng)的入口寫得好不好直接決定后面審核和檢索順不順。我見過太多源碼把校驗寫在 Controller 里一堆 if-else改起來痛苦。常見做法是用Valid 自定義注解把校驗規(guī)則收到 DTO 上。// InfoCreateDTO發(fā)布請求的參數載體 Data public class InfoCreateDTO { NotBlank(message 標題不能為空) Size(max 120, message 標題過長) private String title; NotBlank(message 內容不能為空) private String content; NotNull(message 分類不能為空) private Integer categoryId; } // Service 層發(fā)布邏輯狀態(tài)初始化為待審 Service public class InfoService { Autowired private InfoMapper infoMapper; public Long publish(InfoCreateDTO dto, Long userId) { Info info new Info(); BeanUtils.copyProperties(dto, info); info.setUserId(userId); info.setStatus(0); // 0 待審統(tǒng)一入口初始化 info.setCreateTime(new Date()); infoMapper.insert(info); return info.getId(); } }邏輯說明DTO 負責入參校驗Entity 負責落庫兩者分開是為了避免前端字段直接映射到數據庫字段帶來的越權風險。status在 Service 層強制設為 0而不是信任前端傳值這是安全底線。參數上Size(max120)要和數據庫VARCHAR(120)對齊否則會出現「校驗通過但入庫截斷」的玄學問題。3.2 分類檢索與分頁把索引用上別讓 LIKE 拖垮全表供求信息網的核心查詢是「按分類 關鍵詞 分頁」。很多人圖省事寫WHERE title LIKE %關鍵詞%數據量小沒事上萬條就開始慢。常見做法是分類走索引關鍵詞如果必須模糊匹配至少保證前綴能命中或者引入全文索引。!-- MyBatis Mapper分類精確匹配 標題模糊 分頁 -- select idpageByCategory resultTypecom.example.entity.Info SELECT id, title, category_id, create_time FROM info WHERE status 1 AND category_id #{categoryId} if testkeyword ! null and keyword ! AND title LIKE CONCAT(#{keyword}, %) /if ORDER BY create_time DESC LIMIT #{offset}, #{pageSize} /select邏輯說明status 1只查已審核通過的這是業(yè)務規(guī)則。LIKE CONCAT(#{keyword}, %)是前綴匹配能命中title上的索引如果有的話比%關鍵詞%的全表掃描強很多。LIMIT #{offset}, #{pageSize}是物理分頁offset 由(pageNum-1)*pageSize算出。參數上pageSize建議限制在 20 以內太大容易拖慢響應。注意如果業(yè)務確實需要任意位置模糊搜索MySQL 的LIKE %x%無法走普通索引考慮上全文索引或者把檢索需求交給獨立的搜索組件別硬扛。3.3 后臺審核狀態(tài)流轉用枚舉管狀態(tài)別散落魔法數字審核功能看著簡單就是改個status字段但狀態(tài)一多、流轉一復雜魔法數字 0/1/2 散落在各處維護起來就是血淚經驗。我一般用枚舉把狀態(tài)和允許的流轉收口。public enum InfoStatus { PENDING(0, 待審), APPROVED(1, 通過), REJECTED(2, 駁回); private final int code; private final String desc; InfoStatus(int code, String desc) { this.code code; this.desc desc; } public int getCode() { return code; } // 校驗流轉是否合法只有待審能變成通過或駁回 public static boolean canTransfer(int from, int to) { return from PENDING.code (to APPROVED.code || to REJECTED.code); } }邏輯說明枚舉把狀態(tài)碼和描述綁在一起前端展示、后端判斷都用同一份定義。canTransfer把流轉規(guī)則集中審核接口調用它做前置校驗避免「已通過的又被駁回」這種臟數據。參數上code和數據庫 TINYINT 對應新增狀態(tài)時只改枚舉不改散落的 if。4. 避坑與排查都市供求信息網源碼落地時最容易踩的五個坑4.1 中文亂碼從數據庫到響應頭一條鏈都要查現象發(fā)布信息時標題正常列表頁顯示成問號或方塊。原因字符集在某一環(huán)斷了——可能是數據庫建庫時用了 latin1可能是 JDBC url 沒帶characterEncoding也可能是響應頭Content-Type沒指定 charset。解決按「數據庫 → 連接串 → 應用配置 → 響應頭」順序排查數據庫統(tǒng)一utf8mb4連接串加useUnicodetruecharacterEncodingutf8mb4Spring 配置里spring.http.encoding.charsetUTF-8基本能覆蓋。4.2 上傳圖片存進去卻訪問不到路徑映射沒配現象圖片上傳成功數據庫也有記錄但前端img標簽 404。原因文件存到了磁盤目錄但沒有做靜態(tài)資源映射Web 容器不知道這個目錄能對外訪問。解決加一個配置類把上傳目錄映射到 URL 路徑。Configuration public class WebConfig implements WebMvcConfigurer { Value(${file.upload-path}) private String uploadPath; Override public void addResourceHandlers(ResourceHandlerRegistry registry) { // 把 /upload/** 映射到本地上傳目錄 registry.addResourceHandler(/upload/**) .addResourceLocations(file: uploadPath); } }邏輯說明addResourceLocations的file:前綴不能少否則會被當成 classpath 路徑。uploadPath結尾要帶斜杠不然拼接出來的路徑會少一層。4.3 分頁總數不對count 查詢和列表查詢條件不一致現象列表顯示 10 條分頁控件卻顯示 100 頁。原因count 語句和 list 語句的 WHERE 條件寫得不一樣比如 list 帶了status1count 忘了帶。解決把公共條件抽成 SQL 片段兩處include同一個片段從根上杜絕不一致。4.4 登錄后刷新就掉線Session 配置或跨域沒處理現象登錄成功跳轉正常一刷新就退回登錄頁。原因前后端分離時跨域請求默認不帶 Cookie或者 Session 超時時間太短。解決后端配置 CORS 時allowCredentials(true)前端請求帶withCredentials同時確認server.servlet.session.timeout不是默認的 30 分鐘以下。4.5 并發(fā)發(fā)布出現重復數據唯一約束沒加現象用戶快速點兩次發(fā)布庫里出現兩條一模一樣的信息。原因接口沒做冪等數據庫也沒唯一約束。解決在業(yè)務層加防重比如同一用戶同一標題短時間內只允許一條數據庫層對關鍵字段加唯一索引兜底。別只靠前端按鈕置灰那玩意兒擋不住手快和腳本。5. 從能跑到能改給都市供求信息網加一個「信息過期自動下架」的定時任務把項目跑起來、接口調通之后真正讓它像個產品的一步是加上業(yè)務生命周期管理。供求信息天然有時效性一條租房信息掛三個月還在列表里用戶體驗就崩了。我一般會加一個定時任務把超過 N 天且狀態(tài)為「通過」的信息自動置為「過期」。這里用 Spring 的Scheduled就夠不引入額外組件。Component public class InfoExpireTask { Autowired private InfoMapper infoMapper; // 每天凌晨 2 點執(zhí)行把 30 天前的已通過信息置為過期 Scheduled(cron 0 0 2 * * ?) public void expireOldInfo() { Date deadline DateUtils.addDays(new Date(), -30); int rows infoMapper.expireBefore(deadline); // 打日志便于排查別讓定時任務變成黑匣子 System.out.println(本次過期信息條數: rows); } }對應的 Mapper 更新語句update idexpireBefore UPDATE info SET status 3 WHERE status 1 AND create_time lt; #{deadline} /update邏輯說明cron 0 0 2 * * ?表示每天 2 點執(zhí)行避開白天高峰。status 3表示過期和前面的 0/1/2 區(qū)分開。create_time deadline用而不是邊界更清晰。參數上30 天是業(yè)務可配的建議抽到配置文件里別寫死在代碼。驗證方法很簡單手動把某條數據的create_time改成 40 天前把 cron 臨時改成每分鐘跑一次看狀態(tài)有沒有變。確認邏輯對了再改回每天凌晨。這個習慣救過我很多次——定時任務的 bug 往往要等到第二天才發(fā)現臨時改頻率能當場驗證。提示定時任務在多實例部署時會重復執(zhí)行如果以后要上多臺機器記得加分布式鎖或者改用調度中心單機練手階段可以先不管。最后說個我自己的習慣拿到任何一份 Java 項目源碼我不會急著改業(yè)務而是先跑通、再打斷點走一遍核心鏈路、最后才動手加功能。都市供求信息網這類項目結構清晰、業(yè)務閉環(huán)完整是練「讀代碼 → 改代碼 → 加功能」這條鏈路的好素材。別一上來就重構先讓它在你手里穩(wěn)穩(wěn)跑起來再談改得動。希望幫到你。本文還有配套的精品資源點擊獲取 都市供求信息網源碼拆解：從跑通到改動的Java Web實戰(zhàn)
簡介這是一套面向Java Web初學者與課程設計者的都市供求信息網項目源碼采用前后臺分離設計適合用于畢業(yè)設計、課程實訓或自學練手。前臺覆蓋信息列表展示、分類瀏覽、詳情查看、定位搜索與模糊搜索以及信息發(fā)布后臺則實現信息列表與詳情顯示、信息審核、刪除、付費設置和退出登錄等管理功能完整呈現了一個供求信息平臺的業(yè)務閉環(huán)。壓縮包共106個文件約4.18MB以jsp頁面、java源文件與class編譯文件為核心輔以gif、jpg圖片素材、jar依賴包、xml與properties配置、js腳本及css樣式另含數據庫文件與項目元數據結構清晰便于導入運行。目前已有139人學習下載。通過研讀源碼可掌握Servlet與Action分層、數據庫操作封裝、分頁與搜索邏輯等常見Web開發(fā)要點并可直接參考其目錄組織與配置方式快速搭建同類信息發(fā)布系統(tǒng)。1. 都市供求信息網源碼拆解一個 Java Web 項目從跑起來到改得動的完整路徑拿到一份「都市供求信息網」的 Java 項目源碼很多人第一反應是找 README、翻配置文件、然后mvn spring-boot:run一把梭。但真正做過這類信息發(fā)布平臺的人都知道跑起來只是起點能不能改、改完會不會崩、并發(fā)上來數據對不對才是分水嶺。這個標題背后對應的是一類非常典型的 Java Web 練手項目用戶注冊登錄、供求信息發(fā)布、分類檢索、后臺審核技術棧大概率是 Spring Boot MyBatis/MyBatis-Plus MySQL Thymeleaf 或前后端分離。它適合兩類人一是想找一個完整業(yè)務閉環(huán)來練手的 Java 初學者二是需要快速搭一個信息發(fā)布類系統(tǒng)骨架的開發(fā)者。接下來我不講空泛的架構圖而是按「環(huán)境怎么配、表怎么建、核心接口怎么寫、哪里最容易翻車」的順序把這份源碼類項目拆到能直接抄作業(yè)的程度。2. 環(huán)境與依賴把都市供求信息網源碼在本地跑起來的最小步驟2.1 先確認 JDK 和 Maven 的版本匹配別讓編譯期就翻車這類項目源碼最常見的一個坑就是pom.xml里寫的 Java 版本和你本地 JDK 對不上。熱搜里那個「java: 警告: 源發(fā)行版 17 需要目標發(fā)行版 17」就是典型癥狀——不是代碼錯是編譯配置沒對齊。我一般會先看三處pom.xml的java.version、IDE 的 Project SDK、以及maven-compiler-plugin的 source/target。三處一致后面才省心。# 查看當前 JDK 版本確認與 pom.xml 中 java.version 一致 java -version # 查看 Maven 版本建議 3.6 mvn -v # 清理并跳過測試編譯先確認依賴能拉下來 mvn clean compile -DskipTests邏輯說明java -version確認運行時版本mvn -v確認構建工具可用。mvn clean compile是最小驗證動作能編譯通過說明依賴坐標沒寫錯、倉庫能訪問。參數上-DskipTests在首次拉依賴時能省時間但正式構建前建議去掉讓測試跑一遍暴露問題。如果編譯報「找不到符號」但代碼明明存在八成是 Lombok 沒裝插件或者注解處理器沒開。這類項目大量用Data、Slf4jIDE 不裝 Lombok 插件就會滿屏紅。2.2 數據庫建表與初始數據字符集和字段類型是兩個高頻雷區(qū)都市供求信息網這類項目的表結構通常圍繞「用戶表、信息分類表、供求信息表、評論/留言表」展開。建表時最容易忽略的是字符集——用默認的 latin1 存中文插入時不報錯查出來全是問號。我一般統(tǒng)一用utf8mb4排序規(guī)則utf8mb4_general_ci。-- 創(chuàng)建數據庫顯式指定字符集避免中文亂碼 CREATE DATABASE city_info DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; USE city_info; -- 供求信息主表標題、內容、分類、發(fā)布人、狀態(tài) CREATE TABLE info ( id BIGINT PRIMARY KEY AUTO_INCREMENT, title VARCHAR(120) NOT NULL, content TEXT, category_id INT NOT NULL, user_id BIGINT NOT NULL, status TINYINT DEFAULT 0 COMMENT 0待審 1通過 2駁回, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, INDEX idx_category (category_id), INDEX idx_status_time (status, create_time) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;邏輯說明status用 TINYINT 而不是 VARCHAR是為了后臺審核狀態(tài)流轉時能用整型比較索引效率更高。idx_status_time復合索引服務于「按狀態(tài)篩選 按時間倒序」這個最高頻的查詢。參數上VARCHAR(120)對標題夠用TEXT給正文別一上來就LONGTEXT浪費空間還拖慢排序。初始數據里通常有一個管理員賬號密碼多半是 MD5 或 BCrypt 存進去的。如果你拿到的是明文密碼字段登錄時記得看login接口里有沒有做加密比對不然你輸明文永遠登不進去。2.3 配置文件三處必改端口、數據源、文件上傳路徑源碼里的application.yml或application.properties是跑起來的關鍵。我一般按順序改三處服務端口、數據庫連接、上傳目錄。上傳目錄尤其容易被忽略——默認路徑可能是作者機器上的絕對路徑到你這里直接報「目錄不存在」。server: port: 8080 spring: datasource: url: jdbc:mysql://localhost:3306/city_info?useUnicodetruecharacterEncodingutf8mb4serverTimezoneAsia/Shanghai username: root password: your_password driver-class-name: com.mysql.cj.jdbc.Driver servlet: multipart: max-file-size: 10MB max-request-size: 20MB # 自定義上傳路徑改成你本地真實存在的目錄 file: upload-path: /data/upload/city_info/邏輯說明serverTimezoneAsia/Shanghai不加的話MySQL 8 驅動可能報時區(qū)錯誤。max-file-size控制單文件max-request-size控制整個請求圖片上傳場景兩個都要設。file.upload-path是自定義配置代碼里用Value(${file.upload-path})注入改完記得手動mkdir -p建目錄程序不會自動創(chuàng)建。提示如果啟動報Access denied for user先確認 MySQL 用戶權限和密碼再確認url里的庫名拼寫。這兩處占登錄失敗原因的八成。3. 核心業(yè)務接口供求信息發(fā)布與檢索的代碼骨架3.1 信息發(fā)布接口參數校驗和狀態(tài)初始化別偷懶發(fā)布接口是整個系統(tǒng)的入口寫得好不好直接決定后面審核和檢索順不順。我見過太多源碼把校驗寫在 Controller 里一堆 if-else改起來痛苦。常見做法是用Valid 自定義注解把校驗規(guī)則收到 DTO 上。// InfoCreateDTO發(fā)布請求的參數載體 Data public class InfoCreateDTO { NotBlank(message 標題不能為空) Size(max 120, message 標題過長) private String title; NotBlank(message 內容不能為空) private String content; NotNull(message 分類不能為空) private Integer categoryId; } // Service 層發(fā)布邏輯狀態(tài)初始化為待審 Service public class InfoService { Autowired private InfoMapper infoMapper; public Long publish(InfoCreateDTO dto, Long userId) { Info info new Info(); BeanUtils.copyProperties(dto, info); info.setUserId(userId); info.setStatus(0); // 0 待審統(tǒng)一入口初始化 info.setCreateTime(new Date()); infoMapper.insert(info); return info.getId(); } }邏輯說明DTO 負責入參校驗Entity 負責落庫兩者分開是為了避免前端字段直接映射到數據庫字段帶來的越權風險。status在 Service 層強制設為 0而不是信任前端傳值這是安全底線。參數上Size(max120)要和數據庫VARCHAR(120)對齊否則會出現「校驗通過但入庫截斷」的玄學問題。3.2 分類檢索與分頁把索引用上別讓 LIKE 拖垮全表供求信息網的核心查詢是「按分類 關鍵詞 分頁」。很多人圖省事寫WHERE title LIKE %關鍵詞%數據量小沒事上萬條就開始慢。常見做法是分類走索引關鍵詞如果必須模糊匹配至少保證前綴能命中或者引入全文索引。!-- MyBatis Mapper分類精確匹配 標題模糊 分頁 -- select idpageByCategory resultTypecom.example.entity.Info SELECT id, title, category_id, create_time FROM info WHERE status 1 AND category_id #{categoryId} if testkeyword ! null and keyword ! AND title LIKE CONCAT(#{keyword}, %) /if ORDER BY create_time DESC LIMIT #{offset}, #{pageSize} /select邏輯說明status 1只查已審核通過的這是業(yè)務規(guī)則。LIKE CONCAT(#{keyword}, %)是前綴匹配能命中title上的索引如果有的話比%關鍵詞%的全表掃描強很多。LIMIT #{offset}, #{pageSize}是物理分頁offset 由(pageNum-1)*pageSize算出。參數上pageSize建議限制在 20 以內太大容易拖慢響應。注意如果業(yè)務確實需要任意位置模糊搜索MySQL 的LIKE %x%無法走普通索引考慮上全文索引或者把檢索需求交給獨立的搜索組件別硬扛。3.3 后臺審核狀態(tài)流轉用枚舉管狀態(tài)別散落魔法數字審核功能看著簡單就是改個status字段但狀態(tài)一多、流轉一復雜魔法數字 0/1/2 散落在各處維護起來就是血淚經驗。我一般用枚舉把狀態(tài)和允許的流轉收口。public enum InfoStatus { PENDING(0, 待審), APPROVED(1, 通過), REJECTED(2, 駁回); private final int code; private final String desc; InfoStatus(int code, String desc) { this.code code; this.desc desc; } public int getCode() { return code; } // 校驗流轉是否合法只有待審能變成通過或駁回 public static boolean canTransfer(int from, int to) { return from PENDING.code (to APPROVED.code || to REJECTED.code); } }邏輯說明枚舉把狀態(tài)碼和描述綁在一起前端展示、后端判斷都用同一份定義。canTransfer把流轉規(guī)則集中審核接口調用它做前置校驗避免「已通過的又被駁回」這種臟數據。參數上code和數據庫 TINYINT 對應新增狀態(tài)時只改枚舉不改散落的 if。4. 避坑與排查都市供求信息網源碼落地時最容易踩的五個坑4.1 中文亂碼從數據庫到響應頭一條鏈都要查現象發(fā)布信息時標題正常列表頁顯示成問號或方塊。原因字符集在某一環(huán)斷了——可能是數據庫建庫時用了 latin1可能是 JDBC url 沒帶characterEncoding也可能是響應頭Content-Type沒指定 charset。解決按「數據庫 → 連接串 → 應用配置 → 響應頭」順序排查數據庫統(tǒng)一utf8mb4連接串加useUnicodetruecharacterEncodingutf8mb4Spring 配置里spring.http.encoding.charsetUTF-8基本能覆蓋。4.2 上傳圖片存進去卻訪問不到路徑映射沒配現象圖片上傳成功數據庫也有記錄但前端img標簽 404。原因文件存到了磁盤目錄但沒有做靜態(tài)資源映射Web 容器不知道這個目錄能對外訪問。解決加一個配置類把上傳目錄映射到 URL 路徑。Configuration public class WebConfig implements WebMvcConfigurer { Value(${file.upload-path}) private String uploadPath; Override public void addResourceHandlers(ResourceHandlerRegistry registry) { // 把 /upload/** 映射到本地上傳目錄 registry.addResourceHandler(/upload/**) .addResourceLocations(file: uploadPath); } }邏輯說明addResourceLocations的file:前綴不能少否則會被當成 classpath 路徑。uploadPath結尾要帶斜杠不然拼接出來的路徑會少一層。4.3 分頁總數不對count 查詢和列表查詢條件不一致現象列表顯示 10 條分頁控件卻顯示 100 頁。原因count 語句和 list 語句的 WHERE 條件寫得不一樣比如 list 帶了status1count 忘了帶。解決把公共條件抽成 SQL 片段兩處include同一個片段從根上杜絕不一致。4.4 登錄后刷新就掉線Session 配置或跨域沒處理現象登錄成功跳轉正常一刷新就退回登錄頁。原因前后端分離時跨域請求默認不帶 Cookie或者 Session 超時時間太短。解決后端配置 CORS 時allowCredentials(true)前端請求帶withCredentials同時確認server.servlet.session.timeout不是默認的 30 分鐘以下。4.5 并發(fā)發(fā)布出現重復數據唯一約束沒加現象用戶快速點兩次發(fā)布庫里出現兩條一模一樣的信息。原因接口沒做冪等數據庫也沒唯一約束。解決在業(yè)務層加防重比如同一用戶同一標題短時間內只允許一條數據庫層對關鍵字段加唯一索引兜底。別只靠前端按鈕置灰那玩意兒擋不住手快和腳本。5. 從能跑到能改給都市供求信息網加一個「信息過期自動下架」的定時任務把項目跑起來、接口調通之后真正讓它像個產品的一步是加上業(yè)務生命周期管理。供求信息天然有時效性一條租房信息掛三個月還在列表里用戶體驗就崩了。我一般會加一個定時任務把超過 N 天且狀態(tài)為「通過」的信息自動置為「過期」。這里用 Spring 的Scheduled就夠不引入額外組件。Component public class InfoExpireTask { Autowired private InfoMapper infoMapper; // 每天凌晨 2 點執(zhí)行把 30 天前的已通過信息置為過期 Scheduled(cron 0 0 2 * * ?) public void expireOldInfo() { Date deadline DateUtils.addDays(new Date(), -30); int rows infoMapper.expireBefore(deadline); // 打日志便于排查別讓定時任務變成黑匣子 System.out.println(本次過期信息條數: rows); } }對應的 Mapper 更新語句update idexpireBefore UPDATE info SET status 3 WHERE status 1 AND create_time lt; #{deadline} /update邏輯說明cron 0 0 2 * * ?表示每天 2 點執(zhí)行避開白天高峰。status 3表示過期和前面的 0/1/2 區(qū)分開。create_time deadline用而不是邊界更清晰。參數上30 天是業(yè)務可配的建議抽到配置文件里別寫死在代碼。驗證方法很簡單手動把某條數據的create_time改成 40 天前把 cron 臨時改成每分鐘跑一次看狀態(tài)有沒有變。確認邏輯對了再改回每天凌晨。這個習慣救過我很多次——定時任務的 bug 往往要等到第二天才發(fā)現臨時改頻率能當場驗證。提示定時任務在多實例部署時會重復執(zhí)行如果以后要上多臺機器記得加分布式鎖或者改用調度中心單機練手階段可以先不管。最后說個我自己的習慣拿到任何一份 Java 項目源碼我不會急著改業(yè)務而是先跑通、再打斷點走一遍核心鏈路、最后才動手加功能。都市供求信息網這類項目結構清晰、業(yè)務閉環(huán)完整是練「讀代碼 → 改代碼 → 加功能」這條鏈路的好素材。別一上來就重構先讓它在你手里穩(wěn)穩(wěn)跑起來再談改得動。希望幫到你。本文還有配套的精品資源點擊獲取