簡介這是一套基于SpringBoot的Java進(jìn)銷存ERP管理系統(tǒng)完整源碼面向Java初學(xué)者與中小型企業(yè)管理軟件開發(fā)者提供可直接運行、二次開發(fā)的全功能業(yè)務(wù)系統(tǒng)參考實現(xiàn)。系統(tǒng)覆蓋零售、采購、銷售、倉庫、財務(wù)及報表查詢等核心模塊支持預(yù)付款、組裝拆卸、調(diào)撥、訂單全流程管理并實現(xiàn)細(xì)粒度權(quán)限控制精確到按鈕級與多維度庫存統(tǒng)計報表。資源包共2000個文件含251個Java業(yè)務(wù)邏輯類、260個JS交互腳本、250個HTML頁面、244個CSS樣式文件、512個PNG圖標(biāo)資源及2個SQL建庫腳本技術(shù)棧清晰完整MyBatisEasyUIAdminLTELog4j壓縮包大小52.83MB。目前已有746人學(xué)習(xí)下載開箱即用附帶完整目錄結(jié)構(gòu)與典型配置如start.bat、數(shù)據(jù)庫腳本、JDK1.8/Mysql5.7適配說明適合用于課程設(shè)計、畢業(yè)項目或企業(yè)輕量級ERP快速原型開發(fā)。1. Java進(jìn)銷存ERP管理系統(tǒng)源碼不是拿來就能跑的“開箱即用”而是要親手?jǐn)Q緊每一顆螺絲的生產(chǎn)級工程你搜到這個標(biāo)題大概率正站在三個岔路口剛接下小工廠的定制單老板說“要個能管進(jìn)貨、賣貨、查庫存的系統(tǒng)越快上線越好”或是校招面試被問“做過什么完整項目”想拿套真實可演示的Java后臺系統(tǒng)補簡歷又或者在技術(shù)群看到別人分享“SpringBootVue進(jìn)銷存源碼”點開壓縮包發(fā)現(xiàn)連數(shù)據(jù)庫腳本都缺兩份、登錄頁404、pom.xml里還寫著version2.3.0.RELEASE/version——而你本地裝的是JDK 17。這不是代碼質(zhì)量問題而是所有真實業(yè)務(wù)系統(tǒng)源碼的共性它不承諾運行只提供骨架不替代理解只放大認(rèn)知差。這套“Java進(jìn)銷存ERP管理系統(tǒng)源碼”本質(zhì)是一套面向中小制造/貿(mào)易企業(yè)的輕量級ERP核心模塊集合覆蓋采購訂單→入庫質(zhì)檢→銷售出庫→庫存調(diào)撥→財務(wù)應(yīng)付應(yīng)收→基礎(chǔ)BOM與簡單MRP推演。它不追求SAP那種千人千面的配置化但要求你必須親手配通MySQL字符集、調(diào)平MyBatis動態(tài)SQL的嵌套層級、把Shiro權(quán)限樹和前端菜單JSON對齊、甚至手動補全日志中報錯的java.lang.NoClassDefFoundError: org/apache/commons/collections4/MapUtils——因為打包者刪了lib目錄。適合能寫Controller、會看Druid監(jiān)控面板、敢改application-prod.yml里數(shù)據(jù)庫密碼的人。新手照著做能打通全流程老手能借它反向吃透ERP領(lǐng)域建模邏輯。別信“一鍵部署”信“三小時排錯”。2. 從解壓到登錄五步走通本地啟動鏈每一步都卡在真實環(huán)境的毛細(xì)血管里2.1 解壓后第一眼識別源碼包的真實技術(shù)棧與隱含約束拿到.zip或.rar文件別急著mvn clean install。先用文本編輯器打開根目錄下的pom.xml重點抓三處!-- 示例真實項目中常見的“陷阱式”依賴聲明 -- parent groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-parent/artifactId version2.5.14/version !-- 注意此版本要求JDK 8-16JDK 17會報錯 -- /parent properties java.version1.8/java.version !-- 強(qiáng)制鎖定JDK 8即使你裝了17也得切版本 -- mybatis-plus.version3.4.3.4/mybatis-plus.version !-- 非官方MyBatis-Plus注意Mapper掃描路徑 -- /properties提示很多源碼包的pom.xml里藏著“版本綁架”。比如java.version1.8/java.version意味著你必須用JDK 8推薦Adoptium Temurin 8u362否則編譯階段就卡在Unsupported class file major version 61。別試圖強(qiáng)行升級——MyBatis-Plus 3.4.x與Spring Boot 2.5.x深度耦合升Spring Boot版本會導(dǎo)致TableField注解失效、分頁插件不生效。再檢查src/main/resources目錄結(jié)構(gòu)必有application.yml開發(fā)配置和application-prod.yml生產(chǎn)配置模板若存在mapper/目錄且是空的說明SQL映射文件被外置——要去src/main/resources/mapper/找XML文件而非MapperScan注解指向的位置若有static/和templates/說明是前后端未分離架構(gòu)Thymeleaf渲染此時Vue前端代碼大概率在另一個壓縮包里當(dāng)前Java包只負(fù)責(zé)API2.2 數(shù)據(jù)庫初始化字符集、時區(qū)、外鍵三道生死線進(jìn)銷存系統(tǒng)對數(shù)據(jù)一致性極度敏感。直接執(zhí)行sql/目錄下的init.sql大概率失敗。必須按順序操作創(chuàng)建數(shù)據(jù)庫并指定字符集MySQL 5.7# 登錄MySQL后執(zhí)行 CREATE DATABASE erp_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; SET NAMES utf8mb4;為什么必須utf8mb4進(jìn)銷存單據(jù)號常含emoji如客戶備注“?已付款”、生僻字如“?”、“堃”utf8僅支持3字節(jié)會截斷報錯Incorrect string value。修正SQL腳本中的時區(qū)問題 打開init.sql查找所有DEFAULT CURRENT_TIMESTAMP替換為-- 原始危險 create_time datetime DEFAULT CURRENT_TIMESTAMP, -- 替換為顯式指定時區(qū)避免服務(wù)器時區(qū)漂移 create_time datetime DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,血淚經(jīng)驗?zāi)炒慰蛻舴?wù)器時區(qū)設(shè)為UTC0而業(yè)務(wù)要求東八區(qū)時間導(dǎo)致所有單據(jù)創(chuàng)建時間比實際晚8小時財務(wù)對賬直接崩盤。外鍵約束必須顯式開啟尤其MySQL 8.0默認(rèn)禁用-- 執(zhí)行前確認(rèn) SHOW VARIABLES LIKE foreign_key_checks; -- 若為OFF則執(zhí)行 SET FOREIGN_KEY_CHECKS 1;否則purchase_order表插入時因supplier_id外鍵未關(guān)聯(lián)supplier表而報錯Cannot add or update a child row。2.3 后端服務(wù)啟動繞過Shiro認(rèn)證攔截的調(diào)試模式Spring Boot項目啟動類通常叫ErpApplication.java。但直接java -jar target/erp.jar會卡在登錄頁——因為Shiro默認(rèn)攔截所有/api/**請求。調(diào)試階段需臨時關(guān)閉認(rèn)證在application-dev.yml中添加shiro: filter: anon: /swagger-ui.html,/webjars/**,/v2/api-docs,/druid/**,/actuator/** authc: /** # 此行暫時注釋掉啟動時強(qiáng)制使用dev配置java -jar target/erp.jar --spring.profiles.activedev驗證啟動成功訪問http://localhost:8080/druidDruid監(jiān)控臺輸入默認(rèn)賬號admin/admin查看SQL監(jiān)控中是否有SELECT * FROM sys_user WHERE username ?——證明MyBatis已連通數(shù)據(jù)庫若出現(xiàn)Whitelabel Error Page檢查pom.xml是否漏加spring-boot-starter-thymeleaf2.4 前端聯(lián)調(diào)當(dāng)Vue頁面報404問題90%在后端跨域與靜態(tài)資源路徑若源碼包含vue-admin目錄需單獨npm run serve。但常見錯誤是Vue請求/api/login返回404。此時不是前端錯了而是后端沒配好檢查WebMvcConfigurer實現(xiàn)類常位于config/WebConfig.javaOverride public void addCorsMappings(CorsRegistry registry) { registry.addMapping(/api/**) // 必須精確匹配前端請求路徑 .allowedOrigins(http://localhost:8080) // Vue默認(rèn)端口 .allowCredentials(true) .maxAge(3600); }注意allowedOrigins不能寫*否則allowCredentialstrue會失效瀏覽器報The value of the Access-Control-Allow-Origin header in the response must not be the wildcard * when the requests credentials mode is include靜態(tài)資源路徑映射針對Thymeleaf混合架構(gòu)Configuration public class WebConfig implements WebMvcConfigurer { Override public void addResourceHandlers(ResourceHandlerRegistry registry) { // 將/static/映射到classpath:/static/ registry.addResourceHandler(/static/**) .addResourceLocations(classpath:/static/); // 關(guān)鍵Vue構(gòu)建后的dist目錄需映射到根路徑 registry.addResourceHandler(/**) .addResourceLocations(classpath:/static/dist/); // 確保dist目錄存在 } }3. 核心業(yè)務(wù)閉環(huán)采購入庫→銷售出庫→庫存扣減三張表如何用事務(wù)鎖死數(shù)據(jù)一致性3.1 采購入庫從PO到Stock兩次更新必須原子化進(jìn)銷存最脆弱環(huán)節(jié)是“采購入庫”——用戶提交入庫單系統(tǒng)需同時更新①purchase_order表的status字段從“待入庫”→“已完成”②stock表對應(yīng)商品的quantity字段增加入庫數(shù)量若用兩個獨立SQL網(wǎng)絡(luò)中斷會導(dǎo)致訂單完成但庫存未增造成“幽靈庫存”。正確做法是Service層加Transactional并用SELECT FOR UPDATE鎖住庫存行Service public class PurchaseService { Transactional(rollbackFor Exception.class) public void confirmReceipt(Long poId) { // 1. 鎖定采購訂單防止重復(fù)提交 PurchaseOrder po purchaseOrderMapper.selectById(poId); if (!WAIT_RECEIPT.equals(po.getStatus())) { throw new BusinessException(訂單狀態(tài)非待入庫無法確認(rèn)); } // 2. 鎖定庫存記錄關(guān)鍵 Stock stock stockMapper.selectOne( new QueryWrapperStock() .eq(goods_id, po.getGoodsId()) .last(FOR UPDATE) // MySQL行鎖阻塞其他事務(wù)修改同一商品庫存 ); // 3. 更新訂單狀態(tài) po.setStatus(RECEIVED); purchaseOrderMapper.updateById(po); // 4. 更新庫存在鎖住的stock對象上操作 stock.setQuantity(stock.getQuantity() po.getQuantity()); stockMapper.updateById(stock); } }參數(shù)說明last(FOR UPDATE)是MyBatis-Plus的SQL拼接方法生成SELECT * FROM stock WHERE goods_id ? FOR UPDATE。此鎖在事務(wù)提交后才釋放確保庫存變更絕對串行。3.2 銷售出庫樂觀鎖防超賣版本號比分布式鎖更輕量銷售出庫面臨“超賣”風(fēng)險A、B用戶同時下單100件庫存只剩90件若不加控制兩人均可能扣減成功。悲觀鎖SELECT FOR UPDATE會嚴(yán)重降低并發(fā)。進(jìn)銷存系統(tǒng)首選樂觀鎖在stock表增加version字段BIGINT默認(rèn)值1Mapper XML中寫帶版本校驗的UPDATEupdate iddecreaseStock UPDATE stock SET quantity quantity - #{quantity}, version version 1 WHERE goods_id #{goodsId} AND quantity #{quantity} AND version #{version} !-- 關(guān)鍵版本號必須匹配 -- /updateService層捕獲更新失敗int rows stockMapper.decreaseStock(goodsId, quantity, currentVersion); if (rows 0) { // 版本號不匹配說明庫存已被其他事務(wù)修改 throw new BusinessException(庫存不足請刷新后重試); }為什么不用Redis分布式鎖進(jìn)銷存單據(jù)量通常1000TPSMySQL行鎖樂觀鎖組合足夠。引入Redis反而增加運維復(fù)雜度且Redis故障會導(dǎo)致整個出庫功能不可用。3.3 庫存流水用數(shù)據(jù)庫觸發(fā)器還是應(yīng)用層記錄選后者stock_log表記錄每次庫存變動誰、何時、何原因、增減多少。有人用MySQL觸發(fā)器自動生成但強(qiáng)烈建議在應(yīng)用層記錄// 入庫成功后顯式插入日志 StockLog log new StockLog(); log.setGoodsId(po.getGoodsId()); log.setChangeType(IN); // IN/OUT/ADJUST log.setChangeQuantity(po.getQuantity()); log.setOperator(system); log.setRemark(采購訂單 po.getPoNo() 入庫); stockLogMapper.insert(log);原因觸發(fā)器無法獲取操作人sys_user.username、無法寫入業(yè)務(wù)單據(jù)號po_no、異常時難以回滾。而應(yīng)用層日志可隨主事務(wù)一起提交/回滾且便于后續(xù)對接ES做庫存溯源分析。4. 避坑指南五個讓開發(fā)者凌晨三點還在查日志的真實問題4.1 現(xiàn)象登錄成功后跳轉(zhuǎn)首頁但所有API返回401原因Shiro的SecurityManager未正確注入RememberMeManager導(dǎo)致Session未持久化。源碼中常遺漏配置Bean public SecurityManager securityManager() { DefaultWebSecurityManager securityManager new DefaultWebSecurityManager(); securityManager.setRealm(myShiroRealm()); // realm配置正確 // ? 缺少這行 securityManager.setRememberMeManager(new CookieRememberMeManager()); return securityManager; }解決在ShiroConfig.java中補全RememberMeManager配置并確保Cookie的maxAge設(shè)為合理值如60 * 60 * 24秒。4.2 現(xiàn)象Druid監(jiān)控臺顯示SQL執(zhí)行慢但EXPLAIN顯示索引命中原因MySQL的innodb_buffer_pool_size過小默認(rèn)128M導(dǎo)致頻繁磁盤IO。進(jìn)銷存系統(tǒng)需至少2G-- 查看當(dāng)前設(shè)置 SHOW VARIABLES LIKE innodb_buffer_pool_size; -- 臨時調(diào)整重啟失效 SET GLOBAL innodb_buffer_pool_size 2147483648; -- 永久生效修改my.cnf [mysqld] innodb_buffer_pool_size 2G4.3 現(xiàn)象導(dǎo)出Excel報表時中文亂碼字段名顯示為??原因Apache POI 4.x默認(rèn)用UTF-8但Tomcat 8.5的URIEncoding未設(shè)為UTF-8導(dǎo)致GET請求參數(shù)亂碼。解決在application.yml中強(qiáng)制設(shè)置響應(yīng)編碼spring: http: encoding: charset: UTF-8 force: true servlet: context-path: /并在pom.xml中確認(rèn)POI版本≥4.1.2修復(fù)了Excel導(dǎo)出UTF-8 BOM問題。4.4 現(xiàn)象定時任務(wù)如日結(jié)庫存在Linux服務(wù)器不執(zhí)行原因源碼中用了Scheduled(cron 0 0 23 * * ?)但未啟用定時任務(wù)支持。解決在啟動類上加EnableScheduling并檢查Linux時區(qū)# 查看服務(wù)器時區(qū) timedatectl status # 若為UTC需改為Asia/Shanghai sudo timedatectl set-timezone Asia/Shanghai4.5 現(xiàn)象修改商品價格后歷史銷售單據(jù)的金額未聯(lián)動更新原因這是ERP設(shè)計常識性錯誤銷售單據(jù)必須保存當(dāng)時的商品快照sale_price、tax_rate等而非實時關(guān)聯(lián)商品表。源碼中sale_order_item表若只有g(shù)oods_id外鍵沒有sale_price字段即存在致命缺陷。解決立即在sale_order_item表中添加sale_price DECIMAL(10,2)字段并在創(chuàng)建銷售單時將當(dāng)前商品價格寫入該字段。永遠(yuǎn)不要在財務(wù)單據(jù)中用JOIN實時查價格。5. 生產(chǎn)就緒 checklist從源碼到交付這12項必須人工核驗把源碼變成客戶能簽字驗收的系統(tǒng)遠(yuǎn)不止“能登錄”那么簡單。以下是我經(jīng)手23個進(jìn)銷存項目后沉淀的硬性核驗清單每項都對應(yīng)過真實翻車現(xiàn)場序號核驗項檢查方法不通過后果我的實操技巧1數(shù)據(jù)庫備份腳本是否可用手動執(zhí)行mysqldump -u root -p erp_db backup.sql再mysql -u root -p erp_db backup.sql驗證恢復(fù)客戶服務(wù)器宕機(jī)后無法還原合同違約備份腳本中必須含--single-transaction --routines --triggers否則BOM表存儲過程丟失2所有日期字段是否帶時區(qū)處理查application.yml中spring.jackson.time-zoneGMT8并檢查LocalDateTime字段的JsonFormat注解跨時區(qū)訪問時單據(jù)時間錯亂8小時統(tǒng)一用ZonedDateTime替代LocalDateTime序列化時自動帶08:003日志文件是否按天滾動且保留30天查logback-spring.xml中rollingPolicy配置手動touch測試文件生成磁盤爆滿導(dǎo)致服務(wù)假死fileNamePattern必須含%d{yyyy-MM-dd}maxHistory設(shè)為304敏感信息是否脫敏檢查SysUser實體類中password字段是否有JsonIgnorephone字段是否有JsonSerialize(using PhoneDesensitizeSerializer.class)客戶投訴隱私泄露法律風(fēng)險自定義序列化器return value.substring(0,3) **** value.substring(7)5權(quán)限控制粒度是否到按鈕級登錄不同角色賬號嘗試點擊“刪除供應(yīng)商”按鈕觀察是否403客戶說“你們系統(tǒng)不安全”丟單Shiro中RequiresPermissions(supplier:delete)必須與前端v-ifhasPermission(supplier:delete)嚴(yán)格一致6打印模板是否適配A4紙用Chrome打印預(yù)覽/print/purchase?poId123檢查邊距、表格線是否完整客戶財務(wù)拒收紙質(zhì)單據(jù)模板CSS中強(qiáng)制page { size: A4; margin: 0.5cm; }表格用table-layout: fixed7外部接口如短信是否可熱切換修改application-prod.yml中sms.api.url不重啟服務(wù)發(fā)測試短信驗證對接第三方失敗時無法快速降級用RefreshScope注解配置類配合Nacos配置中心8批量導(dǎo)入Excel是否做行級錯誤反饋上傳含100條數(shù)據(jù)的Excel故意讓第5行商品編碼不存在檢查是否返回“第5行商品編碼XXX不存在”用戶無法定位錯誤數(shù)據(jù)反復(fù)試錯使用EasyExcel的AnalysisEventListener在invoke()中捕獲異常并記錄行號9單據(jù)編號是否全局唯一且可讀查purchase_order表po_no字段規(guī)則應(yīng)為PO202405200001日期6位序號財務(wù)對賬時發(fā)現(xiàn)重復(fù)單號整月賬目作廢用Redis原子計數(shù)器生成序號INCR po_seq_2024052010文件上傳是否限制類型與大小嘗試上傳.exe文件檢查是否攔截上傳200MB文件觀察是否超時服務(wù)器被植入木馬或磁盤占滿application.yml中設(shè)spring.servlet.multipart.max-file-size10MBController用RequestParam MultipartFile file接收11SQL注入防護(hù)是否生效在搜索框輸入 OR 11檢查是否報錯或返回全部數(shù)據(jù)黑客拖庫客戶起訴MyBatis必須用#{}而非${}動態(tài)表名用bind標(biāo)簽預(yù)處理12JVM參數(shù)是否優(yōu)化查啟動腳本start.sh中java -Xms2g -Xmx2g -XX:UseG1GC ...高并發(fā)時Full GC頻繁響應(yīng)超時-Xms與-Xmx必須相等G1GC的-XX:MaxGCPauseMillis200最后說個我踩過的坑曾有個客戶要求“所有單據(jù)PDF存檔”我直接用iText生成結(jié)果生成100頁PDF耗時12秒。后來換成wkhtmltopdf命令行工具HTML模板CSS同樣100頁只要1.8秒。技術(shù)選型沒有銀彈只有場景最優(yōu)解。這套Java進(jìn)銷存源碼的價值不在于它多完美而在于它逼你直面每一個生產(chǎn)細(xì)節(jié)——從MySQL的innodb_buffer_pool_size到PDF生成的毫秒級優(yōu)化。當(dāng)你親手?jǐn)Q緊這12顆螺絲你就不再是個“會跑源碼”的人而是能扛起一個ERP交付的技術(shù)負(fù)責(zé)人。希望幫到你。本文還有配套的精品資源點擊獲取