簡(jiǎn)介JAVA版WMS倉(cāng)儲(chǔ)管理系統(tǒng)源碼是一套面向第三方物流、自營(yíng)倉(cāng)儲(chǔ)及特殊信息化需求企業(yè)的完整解決方案兼顧WEB后臺(tái)與Android PDA端涵蓋訂單管理OMS、倉(cāng)儲(chǔ)管理WMS、計(jì)費(fèi)管理BMS、現(xiàn)場(chǎng)作業(yè)RF等核心模塊并已對(duì)接SAP ECC、SAP HANA、用友U8、百勝E3等系統(tǒng)。壓縮包共2000個(gè)文件、大小73.09MB以Java源碼、JSP/JS等前后端資源、CSS樣式、PNG圖片及Android APK為主另含SQL腳本、XML配置、JAR依賴和少量文檔目錄清晰便于檢索。功能覆蓋倉(cāng)庫配置、月臺(tái)管理、進(jìn)貨出貨、退貨、庫內(nèi)盤點(diǎn)、庫存查詢及分析報(bào)表適合學(xué)習(xí)企業(yè)級(jí)WMS架構(gòu)、業(yè)務(wù)流與二次開發(fā)。已有4542人學(xué)習(xí)下載是物流倉(cāng)儲(chǔ)信息化及JAVA實(shí)戰(zhàn)落地場(chǎng)景的可復(fù)用參考。1. 先把話說透JAVA版WMS倉(cāng)儲(chǔ)管理系統(tǒng)源碼到底能拿來干什么JAVA版WMS倉(cāng)儲(chǔ)管理系統(tǒng)源碼我前前后后拆過三遍。第一遍是給一個(gè)做五金配件的中轉(zhuǎn)倉(cāng)選型第二遍是幫同事的畢業(yè)設(shè)計(jì)搭骨架第三遍是自己在本地把整套流程完整跑起來做壓測(cè)。先說結(jié)論這份源碼不是那種只能截圖演示的課程設(shè)計(jì)它的庫位、波次、盤點(diǎn)三條線是能對(duì)應(yīng)到真實(shí)倉(cāng)庫作業(yè)的拿去做二次開發(fā)底座或者做面試項(xiàng)目都立得住。多數(shù)人第一次打開WMS源碼都會(huì)懵這不就是一套進(jìn)銷存嗎入庫、出庫、庫存三張表加幾個(gè)頁面完了。這是最大的誤解。好用的WMS不是把賬記清楚而是讓揀貨員少走路、讓庫位利用率上去、讓盤點(diǎn)差異查得到源頭。這份JAVA源碼的價(jià)值恰好就在這幾個(gè)點(diǎn)上。適合誰看正在給中小倉(cāng)庫選型的Java工程師、準(zhǔn)備拿WMS做課程設(shè)計(jì)或面試項(xiàng)目的同學(xué)、以及想把ERP里倉(cāng)儲(chǔ)模塊單獨(dú)拆出來的團(tuán)隊(duì)。不適合誰指望下載下來不改代碼直接上生產(chǎn)、連本機(jī)Java環(huán)境都沒配過的用戶——后面這種情況建議先按第四章把環(huán)境跑通再看業(yè)務(wù)。2. 模塊邊界與技術(shù)棧為什么這套JAVA源碼是“能改的WMS”而不是“能看的PPT”2.1 模塊劃分基礎(chǔ)數(shù)據(jù)、入庫、出庫、庫存、報(bào)表五條線一套WMS能不能落地先看模塊邊界清不清楚。這份源碼的包結(jié)構(gòu)把業(yè)務(wù)劃成了五條線我在本地建完表、跑通流程之后覺得這個(gè)劃分是合理的沒有把業(yè)務(wù)邏輯全塞進(jìn)一個(gè)超大Service里。模塊核心實(shí)體表主要頁面二次開發(fā)關(guān)注點(diǎn)基礎(chǔ)數(shù)據(jù)倉(cāng)庫、庫區(qū)、庫位、貨主、商品、客戶倉(cāng)庫管理、庫位管理、商品檔案庫位編碼規(guī)則決定后續(xù)所有揀貨路徑入庫管理采購(gòu)入庫單、退貨入庫單、上架任務(wù)入庫單管理、收貨、上架上架任務(wù)與庫位推薦策略出庫管理銷售出庫單、波次、揀貨任務(wù)、復(fù)核出庫單管理、波次管理、揀貨波次算法和庫存分配是核心庫存管理實(shí)時(shí)庫存、庫存移動(dòng)、盤點(diǎn)單庫存查詢、庫存移動(dòng)、盤點(diǎn)庫存流水與單據(jù)必須解耦報(bào)表統(tǒng)計(jì)收發(fā)表、庫齡表、作業(yè)量統(tǒng)計(jì)收發(fā)存匯總、庫齡分析大數(shù)據(jù)量下建議走匯總表和ERP式的進(jìn)銷存相比WMS多出來的核心概念是“作業(yè)任務(wù)”入庫單審核通過后不直接加庫存而是先生成上架任務(wù)出庫單確認(rèn)后不直接減庫存而是先生成揀貨任務(wù)。這一步差異正是Java面向?qū)ο笏枷朐趥}(cāng)儲(chǔ)場(chǎng)景里的落地——把倉(cāng)庫、庫位、作業(yè)任務(wù)建模成對(duì)象而不是把一切操作都變成對(duì)庫存表的一串UPDATE。這也是這份源碼值得拆的原因它的實(shí)體關(guān)系是符合真實(shí)WMS建模規(guī)范的順著類圖能讀出業(yè)務(wù)流程。2.2 技術(shù)棧選型Spring Boot MyBatis Plus MySQL Redis Vue這套源碼的技術(shù)棧是典型的Java后端組合Spring Boot做應(yīng)用框架MyBatis Plus做ORMMySQL存業(yè)務(wù)數(shù)據(jù)Redis管登錄態(tài)和緩存前端是Vue Element UI前后端分離。選這個(gè)組合不是因?yàn)樗露且驗(yàn)樗m合當(dāng)前這個(gè)場(chǎng)景——中小倉(cāng)庫的數(shù)據(jù)量撐死在千萬級(jí)以內(nèi)MySQL完全頂?shù)米pring Boot的約定優(yōu)于配置能讓團(tuán)隊(duì)把精力放在倉(cāng)儲(chǔ)業(yè)務(wù)而不是框架配置上。Spring Boot打包成可執(zhí)行JAR依賴全部打進(jìn)包里部署時(shí)不需要單獨(dú)裝Tomcat這是它比傳統(tǒng)SSH工程省心的地方。但這也意味著如果本機(jī)JDK版本和編譯時(shí)的版本不一致JAR包啟動(dòng)常常直接報(bào)“UnsupportedClassVersionError”。很多人第一次跑源碼就卡在這里——本地IDE里右鍵運(yùn)行好好的打成JAR扔到Linux上就起不來。常見做法是先確認(rèn)java -version和Maven的maven.compiler.source配置保持一致再談其他。網(wǎng)上關(guān)于java環(huán)境變量配置詳細(xì)教程的帖子一抓一大把但這套源碼的坑不完全在環(huán)境變量更多在后面的數(shù)據(jù)庫初始化和Redis依賴上。從做項(xiàng)目的角度說這個(gè)技術(shù)棧對(duì)Java工程師非常友好能講清楚Spring Boot的啟動(dòng)流程能聊MyBatis Plus的單表CRUD和復(fù)雜SQL分離還能拿“java是靜態(tài)鏈接的”這種問題自嘲一下部署期的依賴地獄。拿它當(dāng)java課程設(shè)計(jì)案例源碼來改造工作量適中拿它準(zhǔn)備java面試題庫存扣減、分布式鎖、分頁插件這些都是高頻考點(diǎn)下文會(huì)詳細(xì)講。2.3 源碼的包結(jié)構(gòu)怎么讀從Controller到Mapper的調(diào)用鏈源碼下下來第一件事不是看頁面而是看包結(jié)構(gòu)。常見分層是controller / service / mapper / entity / dto這套源碼基本遵循這個(gè)規(guī)范。我的建議是按一條完整業(yè)務(wù)流去讀調(diào)用鏈例如“創(chuàng)建出庫單”O(jiān)utboundController.createOutbound() - OutboundService.createOutbound(dto) - 校驗(yàn)商品、庫存、客戶檔案 - 生成出庫單主表 出庫單明細(xì) - 觸發(fā)波次分配邏輯 - OutboundMapper.insertBatch()上面的調(diào)用鏈用文字描述是這樣看代碼時(shí)按這個(gè)線索找類就行。很多新手容易犯的錯(cuò)是直接打開Mapper的XML文件從頭讀到尾那里面全是SQL讀不出業(yè)務(wù)。正確順序是先讀Controller的接口定義知道有什么功能再跳進(jìn)Service看業(yè)務(wù)編排最后才落到Mapper看具體SQL。遇到庫存相關(guān)方法時(shí)注意看有沒有Transactional和鎖這兩樣?xùn)|西在WMS這種并發(fā)場(chǎng)景里缺一不可。3. 庫位與波次建模改代碼前先把這兩張表想透3.1 庫位編碼規(guī)則決定WMS上限的第一行代碼這套源碼里庫位編碼是最值得先讀的字典表。很多二次開發(fā)的人上來就改界面、加字段把庫位編碼當(dāng)成隨便填的字符串這是大忌。庫位編碼一旦上線后改動(dòng)所有歷史揀貨路徑、庫存定位數(shù)據(jù)全部要跟著動(dòng)是一門沒有后悔藥的生意。常見且推薦的庫位編碼規(guī)則是“倉(cāng)庫-庫區(qū)-排-列-層”五段式段位含義示例倉(cāng)庫編碼物理倉(cāng)唯一標(biāo)識(shí)WH01庫區(qū)編碼按功能分區(qū)A整件區(qū)、B拆零區(qū)、C退貨區(qū)排貨架排號(hào)01列貨架列號(hào)02層貨架層號(hào)03拼出來就是WH01-A-01-02-03。為什么一定要有規(guī)律因?yàn)椴ù螔浰惴ㄊ前磶煳痪幋a排序來生成揀貨路徑的編碼有序意味著揀貨員的動(dòng)線有序。如果庫位編碼是WH01-A-03-02-01和WH01-A-01-02-03混著來排序后揀貨員會(huì)在同一排貨架來回折返跑倉(cāng)庫越大效率越低?？催@份源碼時(shí)先翻wms_location表的初始化SQL如果演示數(shù)據(jù)里的庫位編碼都是有規(guī)律生成的說明作者理解這一層值得繼續(xù)往下讀。對(duì)應(yīng)的建表SQL大概長(zhǎng)這樣CREATE TABLE wms_location ( id BIGINT PRIMARY KEY AUTO_INCREMENT, warehouse_code VARCHAR(20) NOT NULL COMMENT 倉(cāng)庫編碼, zone_code VARCHAR(20) NOT NULL COMMENT 庫區(qū)編碼, location_code VARCHAR(40) NOT NULL COMMENT 庫位編碼如 WH01-A-01-02-03, location_type TINYINT NOT NULL DEFAULT 1 COMMENT 1整件 2拆零 3暫存 4退貨, status TINYINT NOT NULL DEFAULT 1 COMMENT 1啟用 0停用, UNIQUE KEY uk_location (location_code) ) ENGINE InnoDB DEFAULT CHARSET utf8mb4;上面這段SQL里UNIQUE KEY uk_location是必須的——同一編碼不允許出現(xiàn)兩條記錄這是庫位管理最基本的一致性約束。location_type字段也別小看它在后續(xù)上架和揀貨策略里要參與過濾比如拆零區(qū)的庫位不應(yīng)該被整件波次命中。3.2 波次揀貨從出庫單到揀貨任務(wù)的實(shí)現(xiàn)邏輯波次是WMS里比庫存更核心的概念。所謂波次就是把一批出庫單聚合到一起按某種策略生成一批揀貨任務(wù)讓揀貨員一次性把貨揀完再分發(fā)復(fù)核。這份源碼里波次相關(guān)的表是wms_wave和wms_pick_task其中生成揀貨任務(wù)明細(xì)的核心SQL邏輯上等價(jià)于下面的寫法SELECT d.product_id, d.qty_required, i.location_code, i.qty_available FROM wms_outbound_detail d JOIN wms_inventory i ON i.product_id d.product_id AND i.qty_available d.qty_required AND i.status 1 WHERE d.wave_no #{waveNo} ORDER BY i.location_code;這條SQL干的事情是按波次號(hào)查出所有出庫明細(xì)然后去庫存表里匹配可用數(shù)量充足的庫位最后按庫位編碼排序輸出揀貨路線。ORDER BY i.location_code就是前面說的路徑優(yōu)化最樸素的實(shí)現(xiàn)就是靠編碼排序。生產(chǎn)環(huán)境通常還會(huì)加上“庫位動(dòng)線權(quán)重”字段比如離打包臺(tái)近的庫位權(quán)重高優(yōu)先分配但源碼層面能做到按庫位排序已經(jīng)能覆蓋很多中小倉(cāng)庫的訴求了。需要注意這里的JOIN條件i.qty_available d.qty_required是一種樂觀校驗(yàn)查詢時(shí)過濾掉可用不足的庫位但在高并發(fā)環(huán)境下查詢通過不代表扣減一定成功——這個(gè)問題第五章會(huì)重點(diǎn)展開。3.3 庫存表與單據(jù)要解耦可用、凍結(jié)、在途必須分開新手改WMS最容易犯的錯(cuò)是讓所有業(yè)務(wù)直接UPDATE庫存表。正確做法是庫存變動(dòng)全部先寫流水表再更新庫存匯總表庫存表只保留當(dāng)前時(shí)點(diǎn)的匯總值供查詢和分配使用。這套源碼的庫存設(shè)計(jì)具備這個(gè)特征核心字段分化成可用的、凍結(jié)的、在途的三個(gè)維度字段含義典型場(chǎng)景qty_available可用庫存可被新訂單分配的數(shù)量qty_frozen凍結(jié)庫存已分配給揀貨任務(wù)但未出庫的數(shù)量qty_onway在途庫存采購(gòu)已審核但未入庫上架的數(shù)量把這三個(gè)數(shù)量分開后很多業(yè)務(wù)邏輯就順了出庫單創(chuàng)建時(shí)凍結(jié)庫存揀貨完成復(fù)核后才扣減可用、核銷凍結(jié)采購(gòu)到貨時(shí)先入在途上架完成才轉(zhuǎn)可用。這才對(duì)得上真實(shí)倉(cāng)庫的作業(yè)節(jié)奏。如果只有一個(gè)庫存數(shù)字就會(huì)出現(xiàn)在途、揀貨中、可售全部混在一起庫存賬永遠(yuǎn)對(duì)不上?？蹨p庫存的標(biāo)準(zhǔn)寫法應(yīng)該是帶條件的UPDATEUPDATE wms_inventory SET qty_available qty_available - #{qty}, qty_frozen qty_frozen #{qty} WHERE product_id #{productId} AND location_code #{locationCode} AND qty_available #{qty} AND status 1;這里的關(guān)鍵是WHERE條件里的qty_available #{qty}如果并發(fā)情況下可用庫存已經(jīng)被別人扣走這個(gè)UPDATE匹配0行返回值為0程序里據(jù)此判定“庫存不足分配失敗”。這就是防超賣的底線手段比先SELECT再UPDATE靠譜得多。后續(xù)看這份源碼時(shí)重點(diǎn)檢查出庫分配相關(guān)方法里有沒有這種帶條件的UPDATE有就說明作者考慮過并發(fā)沒有的話你二次開發(fā)時(shí)一定要自己補(bǔ)上。4. 把源碼跑起來數(shù)據(jù)庫初始化與Spring Boot啟動(dòng)排雷4.1 初始化數(shù)據(jù)庫SQL腳本執(zhí)行順序與核心表拿到源碼后先找sql目錄或doc/sql目錄通常會(huì)有按序號(hào)命名的腳本。常見做法是分三步執(zhí)行# 第一步建庫建表 mysql -u root -p 01_schema.sql # 第二步初始化字典數(shù)據(jù)貨主、倉(cāng)庫、庫區(qū)、庫位 mysql -u root -p 02_base_data.sql # 第三步導(dǎo)入演示數(shù)據(jù)商品、庫存、客戶、示例單據(jù) mysql -u root -p 03_demo_data.sql三條命令依次執(zhí)行注意MySQL執(zhí)行腳本時(shí)的字符集問題。我建議在登錄MySQL后先執(zhí)行一句SET NAMES utf8mb4;再導(dǎo)入腳本否則Windows下容易出現(xiàn)中文亂碼——這是很多新手第一次跑通后頁面顯示“口口口”的根本原因。執(zhí)行完可以用下面這句驗(yàn)證基礎(chǔ)表是否建全SHOW TABLES LIKE wms_%;正常情況下能看到wms_warehouse、wms_location、wms_product、wms_inventory這些核心表。如果一張都沒有檢查是不是腳本里帶了CREATE DATABASE語句但你用錯(cuò)了連接目標(biāo)庫。數(shù)據(jù)庫名一般叫wms字符集建議用utf8mb4而不是utf8因?yàn)橐嫒萆唐访Q里的生僻字和特殊符號(hào)。4.2 application.yml數(shù)據(jù)源、Redis、日志三處必須改拿到源碼后application.yml是最先要?jiǎng)拥兜奈募?。默認(rèn)配置多半是localhost和root/123456不改的話啟動(dòng)即報(bào)錯(cuò)。三處必須改server: port: 8080 servlet: context-path: /wms spring: datasource: url: jdbc:mysql://localhost:3306/wms?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai username: root password: your_password driver-class-name: com.mysql.cj.jdbc.Driver redis: host: 127.0.0.1 port: 6379 database: 0 mybatis-plus: mapper-locations: classpath:mapper/**/*.xml configuration: map-underscore-to-camel-case: true log-impl: org.apache.ibatis.logging.stdout.StdOutImpl幾個(gè)關(guān)鍵點(diǎn)展開說一下。第一serverTimezoneAsia/Shanghai必須加。MySQL驅(qū)動(dòng)8.x版本默認(rèn)使用UTC時(shí)區(qū)不加這個(gè)參數(shù)數(shù)據(jù)庫連接會(huì)直接報(bào)Server returns invalid timezone就算連上也多半會(huì)導(dǎo)致時(shí)間字段差8小時(shí)這個(gè)參數(shù)同時(shí)把數(shù)據(jù)庫時(shí)區(qū)和服務(wù)端時(shí)區(qū)對(duì)齊了。第二context-path: /wms意味著所有接口都帶/wms前綴。如果你后面接Postman或者前端代理請(qǐng)求路徑要記成http://localhost:8080/wms/xxx漏掉這個(gè)前綴會(huì)報(bào)404而且很難排查。第三log-impl這一行會(huì)開啟SQL日志打印建議本地開發(fā)環(huán)境打開線上環(huán)境務(wù)必關(guān)掉否則高并發(fā)下日志量會(huì)把磁盤打滿。配置里的map-underscore-to-camel-case設(shè)置的是數(shù)據(jù)庫下劃線字段與Java駝峰屬性的自動(dòng)映射這個(gè)要保留刪掉后所有實(shí)體映射都會(huì)錯(cuò)位。4.3 啟動(dòng)與驗(yàn)證從JAR打包到第一個(gè)接口返回配置改完后建議先用Maven打包驗(yàn)證整個(gè)工程能通過編譯# 確認(rèn)JDK與Maven環(huán)境 java -version mvn -version # 打包 mvn clean package -DskipTests打包成功后target目錄下會(huì)生成wms-admin.jar用下面命令啟動(dòng)java -jar target/wms-admin.jar如果想指定配置文件用--spring.profiles.activeprod切換如果發(fā)現(xiàn)默認(rèn)內(nèi)存參數(shù)不夠可以顯式指定堆大小java -Xms256m -Xmx512m -jar target/wms-admin.jarWMS這種單體應(yīng)用512M堆內(nèi)存對(duì)演示環(huán)境綽綽有余不要一上來就給2G反而拖慢本機(jī)。啟動(dòng)日志里看到Started Application in x.xxx seconds基本就成功了。這時(shí)候用Postman或Swagger打一個(gè)登錄接口驗(yàn)證curl -X POST http://localhost:8080/wms/api/auth/login \ -H Content-Type: application/json \ -d {username:admin,password:admin123}返回體里帶token字段就是通了。如果這里報(bào)連接超時(shí)優(yōu)先檢查Redis起沒起——很多JAVA版WMS源碼登錄態(tài)都掛在Redis上Redis沒啟動(dòng)登錄接口會(huì)一直報(bào)錯(cuò)而且日志里帶的異常信息五花八門有些看起來像數(shù)據(jù)庫問題其實(shí)根因在Redis。這正是Java環(huán)境變量配置之外第二個(gè)讓人卡住的黑匣子。5. 避坑與常見問題復(fù)現(xiàn)這套源碼時(shí)踩過的坑每個(gè)都值得記一筆5.1 接口404前端頁面能打開列表永遠(yuǎn)空現(xiàn)象npm run dev啟動(dòng)前端后登錄頁正常但登錄完跳轉(zhuǎn)首頁所有列表數(shù)據(jù)加載不出來控制臺(tái)一片404。原因前后端分離部署時(shí)端口不同前端請(qǐng)求沒走代理或者后端配了context-path但前端沒帶前綴請(qǐng)求落在錯(cuò)誤路徑上。解決開發(fā)環(huán)境給前端腳手架配置代理把/wms前綴轉(zhuǎn)發(fā)到http://localhost:8080。如果你用的是Vue CLI在vue.config.js里加devServer: { proxy: { /wms: { target: http://localhost:8080, changeOrigin: true } } }如果上線部署更建議用Nginx統(tǒng)一轉(zhuǎn)發(fā)后端不再暴露端口前端只訪問Nginx的80端口。這種“頁面能開但接口全掛”的問題本質(zhì)是前后端聯(lián)調(diào)的基礎(chǔ)路徑?jīng)]對(duì)齊排查順序先看瀏覽器Network里的完整URL再對(duì)配置。5.2 并發(fā)出庫庫存變負(fù)血淚教訓(xùn)里的頭號(hào)翻車現(xiàn)場(chǎng)現(xiàn)象壓測(cè)并發(fā)創(chuàng)建出庫單時(shí)同一商品同時(shí)被多張單分配到超出庫存的數(shù)量庫存表出現(xiàn)負(fù)數(shù)。原因代碼用的是“先查庫存數(shù)量再在Java里判斷夠不夠夠就UPDATE”的經(jīng)典錯(cuò)誤寫法。兩個(gè)請(qǐng)求同時(shí)查到庫存還剩10件各自判斷都?jí)蛳群罂蹨p后庫存變成負(fù)數(shù)。解決把判斷邏輯下沉到SQL里用帶條件的UPDATE。前面3.3節(jié)那段SQL就是標(biāo)準(zhǔn)解法WHERE qty_available #{qty}保證只有庫存真正夠的時(shí)候才扣得動(dòng)。如果源碼里沒這么寫你二次開發(fā)時(shí)必須全局替換這種扣減邏輯這是WMS并發(fā)場(chǎng)景里優(yōu)先級(jí)最高的問題沒有之一。很多java面試題也會(huì)拿這個(gè)問“庫存超賣怎么解決”答案就是條件更新或加鎖但條件更新性能更好。5.3 時(shí)間差8小時(shí)所有單據(jù)時(shí)間都比本地時(shí)間慢現(xiàn)象錄一張入庫單創(chuàng)建時(shí)間顯示的是前一天22點(diǎn)而本機(jī)時(shí)間已經(jīng)是早上8點(diǎn)。原因MySQL連接參數(shù)沒配時(shí)區(qū)驅(qū)動(dòng)默認(rèn)用UTC或者服務(wù)器系統(tǒng)時(shí)區(qū)是UTC應(yīng)用和數(shù)據(jù)庫之間的時(shí)區(qū)沒對(duì)齊。解決JDBC URL里加serverTimezoneAsia/Shanghai同時(shí)檢查服務(wù)器date命令輸出如果系統(tǒng)時(shí)區(qū)不對(duì)用timedatectl set-timezone Asia/Shanghai修正。還有一個(gè)容易被忽略的地方Jackson序列化時(shí)也要指定時(shí)區(qū)在application.yml里給Spring Boot的JSON序列化統(tǒng)一配spring: jackson: time-zone: GMT8 date-format: yyyy-MM-dd HH:mm:ss不配這個(gè)的話數(shù)據(jù)庫對(duì)了但接口返回給前端的JSON字符串時(shí)間還是不對(duì)前端展示出來照樣差8小時(shí)。5.4 MyBatis Plus分頁不生效單頁查詢返回全表數(shù)據(jù)現(xiàn)象列表接口返回的數(shù)據(jù)總數(shù)total永遠(yuǎn)是0或者每頁條數(shù)不生效一次性返回幾百條。原因MyBatis Plus的分頁功能需要注冊(cè)分頁插件新版MP如果不加PaginationInnerInterceptorPage對(duì)象當(dāng)普通參數(shù)傳給SQL根本不會(huì)拼接LIMIT語句。解決在配置類里手動(dòng)注冊(cè)MybatisPlusInterceptorConfiguration public class MybatisPlusConfig { Bean public MybatisPlusInterceptor mybatisPlusInterceptor() { MybatisPlusInterceptor interceptor new MybatisPlusInterceptor(); interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL)); return interceptor; } }這段代碼是MP分頁的標(biāo)配。加了之后重啟分頁參數(shù)才真正生效。判斷是不是這個(gè)坑的最快方法看日志里SQL末尾有沒有LIMIT關(guān)鍵字沒有就是插件沒注冊(cè)。5.5 Redis掛了或序列化不一致登錄狀態(tài)時(shí)好時(shí)壞現(xiàn)象某些接口能通某些接口提示未登錄重啟后問題隨機(jī)出現(xiàn)。原因登錄狀態(tài)存在Redis里但實(shí)體類沒實(shí)現(xiàn)Serializable默認(rèn)的JdkSerializationRedisSerializer序列化失敗或者Redis連接池配置了超時(shí)Redis一卡接口就報(bào)錯(cuò)。解決給緩存對(duì)象統(tǒng)一加implements Serializable并在RedisConfig里指定Jackson2JsonRedisSerializer做序列化避免Java原生序列化的類型兼容問題。對(duì)于中小項(xiàng)目Redis掛了不應(yīng)該導(dǎo)致核心查詢接口不可用常見做法是在業(yè)務(wù)代碼里加降級(jí)緩存取不到就讀數(shù)據(jù)庫而不是直接拋異常。這五個(gè)坑每一個(gè)都在我復(fù)現(xiàn)這套源碼時(shí)真實(shí)發(fā)生過。最耗時(shí)間的不是第一個(gè)404而是第二個(gè)并發(fā)扣減——那是在數(shù)據(jù)層面出了問題界面完全看不出來只有查庫存流水才發(fā)現(xiàn)負(fù)數(shù)。從那以后我每拆一套WMS源碼第一件事就是搜所有直接UPDATE庫存表的地方數(shù)清有多少處“裸扣”。6. 把源碼變成自己的系統(tǒng)報(bào)表優(yōu)化與盤點(diǎn)閉環(huán)的兩個(gè)習(xí)慣源碼跑通只是開始真正讓這套WMS從“演示版”變成“能用版”至少還要補(bǔ)兩件事報(bào)表查詢優(yōu)化和盤點(diǎn)差異閉環(huán)。先看報(bào)表。收發(fā)存匯總、庫齡分析這類統(tǒng)計(jì)如果直接查wms_inventory和wms_stock_flow的大表數(shù)據(jù)量到幾十萬條后接口會(huì)明顯變慢。常見做法是做一張匯總表wms_report_daily每天凌晨由定時(shí)任務(wù)重算一次。核心思路就一句話報(bào)表查詢只讀匯總表不碰流水表。定時(shí)任務(wù)用Spring的Scheduled注解實(shí)現(xiàn)固定cron在凌晨?jī)牲c(diǎn)執(zhí)行避開白天業(yè)務(wù)高峰。匯總表里加一個(gè)report_date字段前端按天查即可響應(yīng)時(shí)間從秒級(jí)降到毫秒級(jí)。這是投入最小、收益最明顯的優(yōu)化。再看盤點(diǎn)閉環(huán)。新手改盤點(diǎn)功能時(shí)最容易圖省事盤點(diǎn)差異算出來之后直接改庫存表把賬抹平。這在倉(cāng)庫管理里是事故財(cái)務(wù)要求追溯的時(shí)候拿不出依據(jù)。正確做法是狀態(tài)機(jī)驅(qū)動(dòng)盤點(diǎn)單狀態(tài)從草稿到進(jìn)行中錄入實(shí)盤數(shù)后系統(tǒng)計(jì)算差異量生成差異單進(jìn)入待審批狀態(tài)審批通過才更新庫存表同時(shí)寫入庫存流水表。對(duì)應(yīng)字段一般是status用0草稿、1進(jìn)行中、2待審批、3已調(diào)整、4作廢五個(gè)狀態(tài)串起整個(gè)流程。改這套源碼時(shí)優(yōu)先把狀態(tài)機(jī)補(bǔ)完整比加任何花哨頁面都更有價(jià)值。說個(gè)我自己的教訓(xùn)。早期給一家電子元件倉(cāng)做盤點(diǎn)改造我貪快差異確認(rèn)后直接調(diào)庫存表一個(gè)UPDATE把數(shù)量和金額全改了。上線第二周財(cái)務(wù)對(duì)賬發(fā)現(xiàn)系統(tǒng)庫存和ERP庫存有出入追到我這里時(shí)我拿不出任何一條差異審批記錄被拉著開了三次會(huì)才把賬對(duì)上。從那以后我每次動(dòng)WMS的盤點(diǎn)邏輯都強(qiáng)制走一遍“盤點(diǎn)單→差異單→審批→庫存流水”的閉環(huán)哪怕只調(diào)一個(gè)字段的庫存也必須留痕。這個(gè)習(xí)慣幫我擋掉了后續(xù)至少兩次潛在的生產(chǎn)事故希望也能幫到你。本文還有配套的精品資源點(diǎn)擊獲取