簡(jiǎn)介本資源為基于SpringBoot的小型超市管理系統(tǒng)畢業(yè)設(shè)計(jì)全套資料面向計(jì)算機(jī)專業(yè)學(xué)生及Java初學(xué)者解決零售場(chǎng)景下數(shù)字化管理斷層、供應(yīng)鏈信息孤島與動(dòng)態(tài)決策支持不足等問題。系統(tǒng)采用B/S架構(gòu)集成商品分類管理、采購流程優(yōu)化與銷售數(shù)據(jù)分析等核心模塊前后端通過HTML、CSS、JavaScript與后端交互提升易用性與響應(yīng)速度。壓縮包共402個(gè)文件約13.18MB以158個(gè)Java源碼、58個(gè)Vue組件、30個(gè)JavaScript腳本、25個(gè)XML配置及45張JPG、36張PNG界面截圖為主另含SQL建庫腳本、CSS樣式、JSON數(shù)據(jù)與項(xiàng)目說明文檔結(jié)構(gòu)完整便于二次開發(fā)。已有147人學(xué)習(xí)下載。讀者可獲得完整可運(yùn)行的代碼工程、數(shù)據(jù)庫腳本與LW文檔通過銷售統(tǒng)計(jì)與經(jīng)營(yíng)報(bào)表模塊理解決策支持邏輯適合作為課程設(shè)計(jì)或畢業(yè)設(shè)計(jì)參考快速掌握SpringBoot與MySQL整合開發(fā)流程。1. 一個(gè)超市老板的賬本為什么值得用 Spring Boot 重寫很多小型超市的日常運(yùn)轉(zhuǎn)靠的是一本手寫臺(tái)賬加一臺(tái)老收銀機(jī)。老板白天盯貨、晚上對(duì)賬最怕兩件事一是庫存對(duì)不上二是月底盤不清。這個(gè)標(biāo)題要解決的就是把「進(jìn)貨、銷售、庫存、會(huì)員、員工」這幾本賬從紙面搬到一套能跑起來的 Web 系統(tǒng)里。技術(shù)選型上Spring Boot 負(fù)責(zé)把后端接口和業(yè)務(wù)邏輯快速搭起來MySQL 負(fù)責(zé)把商品、訂單、庫存這些結(jié)構(gòu)化數(shù)據(jù)存住前端用最樸素的頁面把操作暴露給收銀員和管理員。適合誰看適合正在做課程設(shè)計(jì)、畢業(yè)設(shè)計(jì)或者想給身邊小超市做一套輕量管理工具的開發(fā)者。它不追求高并發(fā)追求的是「一個(gè)人能維護(hù)、一臺(tái)普通電腦能跑、數(shù)據(jù)不丟」。2. 需求拆解與技術(shù)選型為什么是 Spring Boot MySQL2.1 小型超市的業(yè)務(wù)邊界到底在哪先把「小型」兩個(gè)字釘死。小型超市通常指單店經(jīng)營(yíng)、SKU 在幾百到兩三千之間、收銀臺(tái)一到兩個(gè)、沒有連鎖調(diào)撥需求。它的核心業(yè)務(wù)只有四條線商品管理、庫存管理、銷售收銀、基礎(chǔ)報(bào)表。會(huì)員和員工管理屬于加分項(xiàng)不是第一版必須做的。我一般會(huì)先把業(yè)務(wù)畫成三張表的關(guān)系商品表是主數(shù)據(jù)庫存表跟著商品走銷售訂單表在收銀時(shí)產(chǎn)生并反向扣減庫存。會(huì)員表獨(dú)立存在訂單表里存一個(gè)會(huì)員 ID 做關(guān)聯(lián)即可。這樣拆的好處是后面加促銷、加退貨都只是在訂單表上做擴(kuò)展不會(huì)把商品表搞臟。提示不要一上來就設(shè)計(jì)「供應(yīng)商、采購、退貨、促銷、積分」全套。第一版把商品、庫存、訂單跑通比堆二十張空表有價(jià)值得多。2.2 為什么選 Spring Boot 而不是別的后端框架Spring Boot 在這個(gè)場(chǎng)景里的優(yōu)勢(shì)很具體起步依賴把 Web、JDBC、模板引擎一次性拉齊不用自己配 web.xml內(nèi)嵌 Tomcat 讓打包出來的 jar 直接java -jar就能跑省掉單獨(dú)裝容器的步驟application.properties里改幾行就能切換數(shù)據(jù)庫連接。對(duì)比一下常見選擇純 Servlet 寫起來太碎每個(gè)請(qǐng)求都要自己處理參數(shù)和轉(zhuǎn)發(fā)SSM 配置量大對(duì)只想做一個(gè)小系統(tǒng)的人來說心智負(fù)擔(dān)重Node 或 Python 方案不是不行但很多課程設(shè)計(jì)和答辯環(huán)境默認(rèn)認(rèn) Java 技術(shù)棧Spring Boot 的兼容性最好。數(shù)據(jù)庫選 MySQL 的理由更直接免費(fèi)、資料多、mysqldump備份一條命令搞定、圖形化工具遍地都是。小型超市的數(shù)據(jù)量MySQL 單機(jī)綽綽有余。2.3 項(xiàng)目分層與目錄結(jié)構(gòu)我習(xí)慣用 controller / service / mapper / entity 四層配合 resources 下的 mapper XML 和靜態(tài)頁面。目錄大致長(zhǎng)這樣supermarket/ ├── src/main/java/com/example/supermarket/ │ ├── controller/ # 接收請(qǐng)求做參數(shù)校驗(yàn) │ ├── service/ # 業(yè)務(wù)邏輯事務(wù)在這里 │ ├── mapper/ # 數(shù)據(jù)庫訪問接口 │ └── entity/ # 與表對(duì)應(yīng)的實(shí)體類 ├── src/main/resources/ │ ├── mapper/ # MyBatis 的 XML 映射文件 │ ├── static/ # 前端頁面與靜態(tài)資源 │ └── application.properties └── pom.xml分層的意義在于收銀邏輯扣庫存、生成訂單必須放在 service 層并加事務(wù)不能寫在 controller 里。否則一旦扣庫存成功、生成訂單失敗賬就亂了。這是小型系統(tǒng)最容易翻車的地方。2.4 依賴清單與版本選擇思路pom.xml里我一般只留必要的幾個(gè)依賴避免版本沖突dependencies !-- Web 能力內(nèi)嵌 Tomcat Spring MVC -- dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency !-- 數(shù)據(jù)庫訪問MyBatis 比 JPA 更貼近手寫 SQL適合報(bào)表類查詢 -- dependency groupIdorg.mybatis.spring.boot/groupId artifactIdmybatis-spring-boot-starter/artifactId version2.3.1/version /dependency !-- MySQL 驅(qū)動(dòng) -- dependency groupIdcom.mysql/groupId artifactIdmysql-connector-j/artifactId scoperuntime/scope /dependency !-- 連接池HikariCP 是 Spring Boot 默認(rèn)無需額外配置 -- /dependencies參數(shù)說明MyBatis 的版本要和你用的 Spring Boot 大版本匹配2.x 系列對(duì)應(yīng) Spring Boot 2.x 和 3.x 都能用但 3.x 項(xiàng)目建議用更新的 starter。MySQL 驅(qū)動(dòng)從 8.0 開始包名是com.mysql.cj.jdbc.Driver連接串里要帶時(shí)區(qū)和字符集參數(shù)否則中文商品名會(huì)變問號(hào)。3. 數(shù)據(jù)庫設(shè)計(jì)五張核心表怎么落地3.1 商品表與庫存表的分工商品表存「是什么」庫存表存「有多少」。分開的理由是庫存會(huì)頻繁變動(dòng)商品信息很少變分開后庫存表的更新不會(huì)鎖住商品表的讀。CREATE TABLE product ( id BIGINT PRIMARY KEY AUTO_INCREMENT, barcode VARCHAR(32) NOT NULL UNIQUE COMMENT 條形碼收銀掃碼用, name VARCHAR(64) NOT NULL COMMENT 商品名, category VARCHAR(32) COMMENT 分類, price DECIMAL(10,2) NOT NULL COMMENT 售價(jià), status TINYINT DEFAULT 1 COMMENT 1上架 0下架 ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE stock ( product_id BIGINT PRIMARY KEY, quantity INT NOT NULL DEFAULT 0 COMMENT 當(dāng)前庫存, warn_line INT DEFAULT 10 COMMENT 預(yù)警線, update_time DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;參數(shù)說明DECIMAL(10,2)存金額不要用 float否則 0.10.2 會(huì)出現(xiàn)精度誤差對(duì)賬時(shí)能讓你懷疑人生。utf8mb4是為了支持 emoji 和生僻字商品名。庫存表用product_id做主鍵保證一個(gè)商品只有一條庫存記錄。3.2 訂單表與訂單明細(xì)表的一對(duì)多訂單表存「這一單的總信息」明細(xì)表存「這一單買了哪些商品」。這是典型的一對(duì)多也是數(shù)據(jù)庫多對(duì)多關(guān)系的落地方式。CREATE TABLE sale_order ( id BIGINT PRIMARY KEY AUTO_INCREMENT, order_no VARCHAR(32) NOT NULL UNIQUE COMMENT 訂單號(hào), member_id BIGINT COMMENT 會(huì)員ID可空, total_amount DECIMAL(10,2) NOT NULL, pay_type TINYINT COMMENT 1現(xiàn)金 2掃碼, create_time DATETIME DEFAULT CURRENT_TIMESTAMP ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE order_item ( id BIGINT PRIMARY KEY AUTO_INCREMENT, order_id BIGINT NOT NULL, product_id BIGINT NOT NULL, quantity INT NOT NULL, price DECIMAL(10,2) NOT NULL COMMENT 成交單價(jià)防止商品調(diào)價(jià)后歷史訂單失真, INDEX idx_order (order_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;參數(shù)說明明細(xì)表里冗余存一個(gè)price是因?yàn)樯唐肥蹆r(jià)會(huì)變歷史訂單必須保留成交時(shí)的價(jià)格。idx_order索引是為了按訂單查明細(xì)時(shí)不用全表掃。訂單號(hào)order_no建議用「日期隨機(jī)數(shù)」生成不要用自增 ID 直接暴露給用戶。3.3 會(huì)員表與員工表的最小字段集CREATE TABLE member ( id BIGINT PRIMARY KEY AUTO_INCREMENT, phone VARCHAR(20) NOT NULL UNIQUE, name VARCHAR(32), points INT DEFAULT 0 COMMENT 積分, create_time DATETIME DEFAULT CURRENT_TIMESTAMP ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE staff ( id BIGINT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(32) NOT NULL UNIQUE, password VARCHAR(64) NOT NULL COMMENT 存哈希不存明文, role TINYINT DEFAULT 1 COMMENT 1收銀員 2管理員 ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;參數(shù)說明密碼字段長(zhǎng)度給 64是為了存 SHA-256 或 BCrypt 的結(jié)果。千萬不要存明文這是最基礎(chǔ)的安全底線。員工表用role區(qū)分權(quán)限收銀員只能進(jìn)收銀頁管理員才能改商品和看報(bào)表。3.4 連接配置與初始化腳本application.properties里幾個(gè)關(guān)鍵項(xiàng)spring.datasource.urljdbc:mysql://localhost:3306/supermarket?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai spring.datasource.usernameroot spring.datasource.passwordyour_password spring.datasource.driver-class-namecom.mysql.cj.jdbc.Driver mybatis.mapper-locationsclasspath:mapper/*.xml mybatis.configuration.map-underscore-to-camel-casetrue參數(shù)說明serverTimezone必須設(shè)否則連接 MySQL 8 會(huì)報(bào)時(shí)區(qū)錯(cuò)誤。map-underscore-to-camel-casetrue讓數(shù)據(jù)庫的product_id自動(dòng)映射到 Java 的productId省掉大量手動(dòng)映射。初始化時(shí)把建表 SQL 放在schema.sql里Spring Boot 啟動(dòng)會(huì)自動(dòng)執(zhí)行方便反復(fù)重建測(cè)試環(huán)境。4. 核心功能實(shí)現(xiàn)從收銀到庫存扣減4.1 商品查詢與分頁接口商品列表要支持按名稱模糊查、按分類篩、分頁。MyBatis 的 XML 寫法select idlistProducts resultTypecom.example.supermarket.entity.Product SELECT id, barcode, name, category, price, status FROM product where if testkeyword ! null and keyword ! AND name LIKE CONCAT(%, #{keyword}, %) /if if testcategory ! null and category ! AND category #{category} /if /where ORDER BY id DESC LIMIT #{offset}, #{size} /select邏輯說明where標(biāo)簽會(huì)自動(dòng)處理第一個(gè)條件前的 AND避免拼接出WHERE AND的語法錯(cuò)誤。CONCAT(%, #{keyword}, %)用#{}而不是${}能防止 SQL 注入。offset和size由 service 層根據(jù)頁碼算出來比如第 2 頁每頁 10 條offset 就是 10。4.2 收銀下單與庫存扣減的事務(wù)處理這是整個(gè)系統(tǒng)最不能出錯(cuò)的地方。收銀動(dòng)作包含三步生成訂單、寫明細(xì)、扣庫存。三步必須在一個(gè)事務(wù)里任何一步失敗全部回滾。Service public class SaleService { Autowired private SaleOrderMapper orderMapper; Autowired private OrderItemMapper itemMapper; Autowired private StockMapper stockMapper; Transactional(rollbackFor Exception.class) public String checkout(ListCartItem items, Long memberId) { // 1. 先校驗(yàn)庫存避免扣減到一半才發(fā)現(xiàn)不夠 for (CartItem item : items) { Stock stock stockMapper.selectByProductId(item.getProductId()); if (stock null || stock.getQuantity() item.getQuantity()) { throw new RuntimeException(庫存不足 item.getProductId()); } } // 2. 生成訂單主記錄 SaleOrder order new SaleOrder(); order.setOrderNo(generateOrderNo()); order.setMemberId(memberId); order.setTotalAmount(calcTotal(items)); orderMapper.insert(order); // 3. 寫明細(xì)并扣庫存 for (CartItem item : items) { OrderItem oi new OrderItem(); oi.setOrderId(order.getId()); oi.setProductId(item.getProductId()); oi.setQuantity(item.getQuantity()); oi.setPrice(item.getPrice()); itemMapper.insert(oi); stockMapper.decrease(item.getProductId(), item.getQuantity()); } return order.getOrderNo(); } }邏輯說明Transactional(rollbackFor Exception.class)里的rollbackFor很關(guān)鍵默認(rèn)只回滾運(yùn)行時(shí)異常加上它之后受檢異常也會(huì)回滾。先校驗(yàn)再扣減是為了在并發(fā)不高的小型超市場(chǎng)景下用最簡(jiǎn)單的方式避免超賣。如果以后并發(fā)上來了再改成UPDATE stock SET quantity quantity - #{qty} WHERE product_id #{id} AND quantity #{qty}靠數(shù)據(jù)庫行鎖保證原子性。4.3 庫存預(yù)警與低庫存查詢庫存預(yù)警不需要定時(shí)任務(wù)收銀扣減后順手查一下就行或者管理員進(jìn)首頁時(shí)查一次。SELECT p.name, s.quantity, s.warn_line FROM stock s JOIN product p ON p.id s.product_id WHERE s.quantity s.warn_line ORDER BY s.quantity ASC;邏輯說明用 JOIN 把商品名帶出來前端直接展示。quantity warn_line是預(yù)警條件warn_line默認(rèn) 10管理員可以按商品單獨(dú)調(diào)。這個(gè)查詢走的是 stock 表全掃但庫存表通常只有幾千行性能沒問題。4.4 銷售報(bào)表的按日匯總老板最想看的是「今天賣了多少錢、哪些貨走得快」。SELECT DATE(create_time) AS day, COUNT(*) AS order_count, SUM(total_amount) AS total FROM sale_order WHERE create_time #{start} AND create_time #{end} GROUP BY DATE(create_time) ORDER BY day DESC;參數(shù)說明start和end用日期字符串傳入end取次日零點(diǎn)這樣能覆蓋當(dāng)天全部訂單。DATE(create_time)會(huì)用到函數(shù)數(shù)據(jù)量大時(shí)索引失效但小型超市一天幾百單完全夠用。如果以后要優(yōu)化可以加一個(gè)sale_date冗余字段并建索引。5. 避坑與排查那些讓我返工三次的問題5.1 中文亂碼從連接串到建表字符集現(xiàn)象商品名存進(jìn)去變成問號(hào)或者頁面顯示亂碼。原因三個(gè)地方任意一處字符集不對(duì)都會(huì)出問題——數(shù)據(jù)庫連接串沒帶characterEncodingutf8、建表時(shí)用了latin1、前端頁面沒聲明 UTF-8。解決連接串加useUnicodetruecharacterEncodingutf8建表統(tǒng)一DEFAULT CHARSETutf8mb4HTML 頭部加meta charsetUTF-8。三處對(duì)齊后基本不會(huì)再犯。5.2 事務(wù)不生效方法內(nèi)部調(diào)用踩的坑現(xiàn)象收銀時(shí)庫存扣了但訂單沒生成數(shù)據(jù)對(duì)不上。原因Transactional標(biāo)注的方法被同一個(gè)類里的另一個(gè)方法直接調(diào)用Spring 的代理沒攔住事務(wù)根本沒開。解決把事務(wù)方法抽到獨(dú)立的 service 類里或者通過注入自身代理調(diào)用。我一般直接把收銀邏輯單獨(dú)放一個(gè)SaleServicecontroller 只調(diào)它不繞彎。5.3 庫存超賣并發(fā)下的經(jīng)典問題現(xiàn)象兩個(gè)收銀臺(tái)同時(shí)賣最后一件商品結(jié)果庫存變成 -1。原因先查后扣的寫法在并發(fā)下不安全兩個(gè)線程都查到庫存為 1都執(zhí)行扣減。解決把扣減改成帶條件的原子更新UPDATE stock SET quantity quantity - #{qty} WHERE product_id #{id} AND quantity #{qty}然后判斷影響行數(shù)為 0 就拋異?；貪L。這是最省事的方案不用引入分布式鎖。5.4 訂單號(hào)重復(fù)別用時(shí)間戳裸奔現(xiàn)象同一秒內(nèi)兩筆訂單訂單號(hào)撞了插入報(bào)唯一鍵沖突。原因直接用System.currentTimeMillis()做訂單號(hào)毫秒級(jí)并發(fā)會(huì)重復(fù)。解決訂單號(hào)用「yyyyMMddHHmmss 4 位隨機(jī)數(shù)」或者用數(shù)據(jù)庫自增 ID 拼前綴。更穩(wěn)妥的是單獨(dú)建一張序列表但小型系統(tǒng)用隨機(jī)數(shù)足夠。5.5 連接池耗盡忘了關(guān)流和長(zhǎng)事務(wù)現(xiàn)象系統(tǒng)跑一段時(shí)間后報(bào)「無法獲取數(shù)據(jù)庫連接」。原因手寫 JDBC 時(shí)忘了關(guān) Connection或者某個(gè)事務(wù)里做了耗時(shí)操作比如發(fā)短信導(dǎo)致連接被長(zhǎng)時(shí)間占用。解決統(tǒng)一用 MyBatis 或 JdbcTemplate它們會(huì)管理連接釋放。事務(wù)方法里只做數(shù)據(jù)庫操作把外部調(diào)用挪到事務(wù)外。HikariCP 默認(rèn)最大連接數(shù)是 10小型超市夠用但別在事務(wù)里 sleep。6. 進(jìn)階技巧讓這套系統(tǒng)多活兩年第一版跑通之后真正決定這套系統(tǒng)能不能長(zhǎng)期用的是幾個(gè)細(xì)節(jié)。我踩過的最大教訓(xùn)是一開始圖省事把所有配置寫死在代碼里結(jié)果換臺(tái)機(jī)器部署就要改代碼重新打包。后來我把數(shù)據(jù)庫地址、端口、備份路徑全挪到application.properties用不同 profile 區(qū)分開發(fā)和生產(chǎn)部署時(shí)只改配置文件不動(dòng)一行 Java。第二個(gè)習(xí)慣是給關(guān)鍵操作留日志。收銀、改價(jià)、刪商品這三類動(dòng)作我都會(huì)在 service 里打一條帶操作人和時(shí)間的日志。不是為了審計(jì)是為了出問題時(shí)能回溯。有一次庫存對(duì)不上就是靠日志發(fā)現(xiàn)某筆訂單被重復(fù)提交了兩次。第三個(gè)技巧是備份。MySQL 的mysqldump配合系統(tǒng)的定時(shí)任務(wù)每天凌晨導(dǎo)出一份 SQL 文件保留最近七天。命令很簡(jiǎn)單mysqldump -u root -p supermarket /backup/supermarket_$(date %Y%m%d).sql參數(shù)說明-u和-p后面跟賬號(hào)密碼supermarket是庫名重定向到帶日期的文件?；謴?fù)時(shí)用mysql -u root -p supermarket 備份文件.sql。這個(gè)習(xí)慣看起來笨但真出事的時(shí)候它是唯一的后悔藥。最后一個(gè)建議是控制功能膨脹。小型超市系統(tǒng)的價(jià)值在于穩(wěn)定和簡(jiǎn)單不在于功能多。每次想加新模塊之前先問一句老板真的會(huì)用嗎如果答案模糊就先不加。我見過太多課程設(shè)計(jì)堆了十幾個(gè)模塊最后連收銀主流程都跑不順。把商品、庫存、訂單這三條線打磨到不出錯(cuò)比什么都強(qiáng)。希望幫到你。本文還有配套的精品資源點(diǎn)擊獲取