从原型到数据库：手把手跑通水果库存管理系统Java课设

简介在 Java Web 工程实践中一个完整的业务系统通常由原型设计、数据库设计与源码实现三部分组成。Axure 原型用于梳理页面字段与交互逻辑MySQL 建表脚本定义数据结构Spring Boot 源码则承载业务逻辑与并发控制。以水果库存管理系统为例库存扣减需要采用条件更新 SQL如 stock quantity保证原子性避免并发下出现负数或丢失更新。这类“源码原型数据库”的资源包在 Java 课程设计、毕业设计中非常常见掌握正确的导入、配置与避坑方法能将现有工程改造成可演示、可讲解的个人作品同时深入理解 CRUD 之外的事务与数据一致性。围绕这一整套资源包文章梳理了从 Axure 原型核对、数据库初始化到项目部署与排障的完整路径。1. 拿“源码原型数据库”做水果库存管理到底在做什么这类资源包在大学课程设计里很常见解压后一个叫“源码”的文件夹、一个叫“原型”的文件夹、一个叫“数据库”的文件夹。很多人第一反应是双击里面的可执行文件结果发现压根没有 exe于是来问“水果库存管理系统怎么运行”。实际上这三部分各司其职源码是后端和前端页面的实现原型是 Axure 画的页面设计稿数据库是建表 SQL 和初始数据。把它们合起来才是一套完整的课程设计交付物。你不需要从零写代码但需要把它“驯服”成自己的东西。文章会按原型、源码、数据库的顺序拆解最后给你一套避坑清单和演示方法。适合正在做 Java 课程设计、毕业设计或者想找一个完整增删改查案例练手的人——你能从这套资源里学到的不只是库存系统而是“怎么把一个草稿版页面变成跑得起来的程序”。下面直接动手。2. 先用 Axure 把原型跑通水果库存管理系统的页面与字段逻辑拿到资源包别急着看代码。先打开原型目录——那是整个系统的“需求文档”。源码可能写得很烂数据库可能缺字段但原型往往完整保留了设计意图。看懂原型你才能判断手里这套源码到底全不全。2.1 打开原型文件先画页面清单登录页、主菜单、入库出库、预警报表原型目录里一般有两种形态.rp源文件或者已经导出的 HTML 文件夹。.rp需要 Axure 打开HTML 版本直接用浏览器就能看。无论哪种第一步都是把页面层级摸清楚。水果库存管理系统的原型结构基本是固定的登录页、主菜单、水果列表、入库登记、出库登记、库存预警、统计报表。用一张表把这些页面和关键字段列出来后面核对源码时就是一张地图。页面关键输入/展示项对应数据表登录页用户名、密码user水果列表名称、分类、单位、库存、预警下限fruit入库登记水果下拉框、数量、单价、供应商、日期stock_in出库登记水果下拉框、数量、领用人、日期stock_out库存预警筛选低于预警下限的水果红色高亮fruit.stock / alert_min统计报表按月汇总入库、出库数量视图或聚合 SQL这张表的价值在于原型上每一个输入框的 label最后都会变成数据库表里的字段名。比如原型上写“预警下限”表里大概率是alert_min“供应商”对应supplier。如果你发现某个输入框在源码里找不到对应字段那说明这套资源包的源码和原型不是同一个人写的——这种情况太常见了后面专门讲怎么收拾。2.2 用 Axure 做交互检查预览、动态面板和原型里的“假按钮”把.rp文件拖进 Axure推荐 9 或 10按 F5 就能在浏览器里预览。预览时重点测五个动作登录能不能跳转、列表页能不能点进详情、入库弹窗能不能打开、出库数量超库存有没有提示、预警列表能不能筛出来。这些是原型价值最大的部分也是答辩时老师最爱点的位置。一个最容易翻车的点原型里的按钮是“假的”。Axure 里如果用的是动态面板没给按钮设置交互事件点击就什么都不会发生。判断方法是选中按钮看右侧“交互”面板里有没有“单击时”的动作。没有动作说明作者只画了静态图没做交互。你可以在原型文件里补事件也可以只在答辩时说明“这是静态页”。但如果按钮对应的功能在源码里实现了我建议还是回 Axure 补一下交互保持原型和实现一致否则问起来很被动。另外HTML 版原型里的文件名也能透露信息。比如login.html、fruit_list.html、stock_in.html这些文件名的风格和源码 Controller 里的路由命名有关系。看到fruit_list.html时你大概能猜到后端会有一个/fruit/list或者FruitListServlet。用浏览器打开 HTML 原型后按 F12 看网络请求能发现作者连了什么接口——没有接口也没关系文件名本身就是线索。2.3 从原型反推数据库字段字段映射清单是最值得写的笔记这是原型环节最划算的一步把每个页面里的输入项、表格列、筛选条件全部列出来转成字段名和类型。不需要懂数据库先按中文意思猜比如“入库数量”就是quantity“入库时间”就是in_time。列完之后再跟源码里的实体类对比差异点就是你后续要补的坑。我这里给一个实际做过的映射示例。入库登记页通常有水果下拉选择入库数量单价供应商入库日期备注。对应设计成stock_in表的fruit_id、quantity、unit_price、supplier、in_time、remark。注意原型上显示的是“水果名称”但表里只存fruit_id名称要靠 JOIN 查询显示出来。如果源码里有实体类直接写了fruitName字段而不做 JOIN功能能跑但属于偷懒设计答辩时不要主动提。把映射清单写成三列表格页面位置、显示名称、字段名。这张表既是你的笔记也可以直接截图放进课设报告里的“需求分析”章节。老师看到你能把页面和数据库对上比看你背十页代码管用得多。2.4 原型和 demo 不是一回事缺页时怎么补才不掉链子资源包里的原型往往是“演示版”常见缺漏是修改密码、分页控件、搜索框、重置密码这些边角功能。老师要是点了搜索框发现没反应你不能说“原作者没画”。常见做法是至少补一个“列表搜索”的交互让页面看起来完整。在 Axure 里给搜索框加过滤动作不需要写代码。选中搜索框在右侧“交互”面板添加“单击时—设置列表筛选”然后把筛选列指定为表格里的名称列即可。前提是列表必须是“中继器”组件如果你发现表格是普通表格需要先右键转成中继器否则没有筛选功能。这个操作别拖到答辩前夜做因为中继器的列名和单元格引用一旦对不上筛选出来的结果就是空的。补完交互后把 HTML 原型重新导出一次。之后的核对逻辑就简单了以源码能跑的页面为准原型里缺的页面在报告里标注“已按实现补充”。这么处理既保住了完整性又不会被问“原型和实现怎么不一致”时无话可说。原型环节到这里就可以收工下一章进入源码。3. 源码跑通第一步Spring Boot 项目的导入与数据库连接原型看懂了接下来解决“怎么跑起来”这个最大的玄学问题。这类资源包绝大多数是 Java 项目Spring Boot 最常见也可能是 SSM 甚至原生 Servlet。不管哪个流程都逃不开三步导入到 IDE、改数据库配置、初始化 SQL。别指望双击一个start.bat就能完事能跑通的都是手工调过的。3.1 解压后先认目录pom.xml 没在最外层后面全是坑源码压缩包最常见的坑是“套娃”目录解压出fruit-stock-master进去还有一个fruit-stock再进去才是pom.xml。如果直接把内层目录导入 IDEAMaven 依赖也能拉但资源包里附带的说明文档里写的路径就全对不上了。先打开资源管理器确认根目录标准 Maven 结构长这样fruit-stock/ ├── pom.xml ├── src/ │ ├── main/ │ │ ├── java/com/example/fruit │ │ └── resources/application.yml │ └── test/ └── README.md如果pom.xml不在根目录把外层多余文件夹删掉只保留这一层结构。接着打开pom.xml看两件事packaging是jar还是war以及 Spring Boot 的版本号。jar用java -jar或 IDE 直接跑war要放到外部 Tomcat。版本号决定你本地 JDKSpring Boot 2.x 用 JDK 8 最稳3.x 需要 JDK 17。资源包如果写的是 2.2.5 而你装了 JDK 17启动会报UnsupportedClassVersionError这时候要么换 JDK 8要么把 Spring Boot 版本升到 2.7。我一般优先换 JDK因为这不会引入新的依赖冲突。IDEA 导入路径是File - Open选择根目录等右下角 Maven 加载完。加载慢或超时多半是中央仓库网络问题改一下 Maven 镜像就好。在用户目录~/.m2/settings.xml里写入!-- 阿里云镜像 -- mirror idaliyun/id urlhttps://maven.aliyun.com/repository/public/url mirrorOfcentral/mirrorOf /mirrormirrorOf写成central表示只镜像 Maven 中央仓库不影响项目里用的其他仓库。URL 用阿里云公共库下载spring-boot-starter-web这类基础依赖一般几十秒就能完。改完这个配置原来卡住的依赖会开始走动这一步解决了大量“卡在 download 半天没反应”的问题。3.2 改数据源配置application.yml 里五个参数对照本地环境找src/main/resources/application.yml或.properties文件。老项目可能是application.properties但内容差不远。打开后盯着五个参数全部改成你本机真实值参数示例必须改的原因urljdbc:mysql://localhost:3306/fruit_stock端口、库名要和本地一致usernameroot本地 MySQL 用户password123456本地密码别用资源包里的server.port8080被占用时改 8081注意前端请求也要跟着改context-path/fruit和前端页面里写的请求前缀保持一致这里最容易翻车的是 MySQL 驱动类。老资源包写的是com.mysql.jdbc.Driver这是 MySQL 5 的驱动本地如果装的是 MySQL 8启动直接报ClassNotFoundException。改成com.mysql.cj.jdbc.Driver同时 URL 要带上时区参数。下面是我跑课设项目时常用的一段干净配置server: port: 8080 # 后端端口 servlet: context-path: /fruit # 统一请求前缀 spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/fruit_stock?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai username: root password: 123456serverTimezone不写MySQL 8 驱动会报The server time zone value的时区错误或者字段时间整体偏移 8 小时。characterEncodingutf8解决中文乱码——别嫌老生常谈十个有八个课设项目乱码都出在没写这个参数。context-path加/fruit后页面地址变成http://localhost:8080/fruit/login.html所有静态资源和 AJAX 请求都要带这个前缀。改之前先全局搜一下源码里有没有写死/fruit/list这类路径有的话要统一调整。3.3 初始化数据库先建库再导表最后用 Maven 启动数据库脚本通常在“数据库”文件夹里可能是一个fruit_stock.sql。先手动建一个空库再导入脚本别让脚本里的CREATE DATABASE和 Navicat 的连接配置打架。命令行操作最干净# 创建数据库并指定 utf8mb4 字符集 mysql -u root -p -e CREATE DATABASE fruit_stock DEFAULT CHARACTER SET utf8mb4; # 导入表结构和数据 mysql -u root -p fruit_stock /path/to/fruit_stock.sql第一句指定utf8mb4字符集因为 MySQL 8 默认utf8mb4而老脚本可能是latin1导入后中文全变问号。第二句把表结构和数据导进刚建的库。如果脚本里自带USE fruit_stock;不影响但若脚本有DROP DATABASE语句建议删掉再执行否则可能把别的库干掉。导入完成后执行SHOW TABLES;看一眼表清单再SELECT COUNT(*) FROM fruit;确认数据行数不是 0。启动项目优先用 IDE找到Application.java主类右键 Run。命令行验证则执行mvn clean spring-boot:run。clean会清掉旧的target目录避免编译残留引起怪问题。运行日志里看到Started且没有ERROR再用浏览器访问登录页。如果端口被占用会报Port 8080 was already in use这时改server.port或者在命令行用mvn spring-boot:run -Dspring-boot.run.arguments--server.port8081临时覆盖端口。启动成功的标志是页面能打开、登录能走通——不是日志打完就算完。4. 数据库设计水果库存管理的建表语句与库存扣减事务源码跑通后别急着截图。数据库是答辩提问的重灾区尤其是“库存扣减怎么保证不错”这种问题。这一章把核心表结构、扣减逻辑和 Mapper 落地说清楚。4.1 三张核心表水果表、入库流水、出库流水字段这么设计资源包的 SQL 脚本经常是一大坨全是INSERT INTO看不出表结构。先找到CREATE TABLE部分把核心表理顺。水果库存管理系统最少需要三张表fruit存水果信息和当前库存stock_in存入库流水stock_out存出库流水。下面是整理后的建表语句可以直接参考CREATE TABLE fruit ( id int NOT NULL AUTO_INCREMENT, fruit_name varchar(50) NOT NULL COMMENT 水果名称, category varchar(20) DEFAULT NULL COMMENT 分类如柑橘类/浆果类, unit varchar(10) DEFAULT 斤 COMMENT 单位, stock int NOT NULL DEFAULT 0 COMMENT 当前库存, alert_min int DEFAULT 10 COMMENT 预警下限, update_time datetime DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, PRIMARY KEY (id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT水果信息表; CREATE TABLE stock_in ( id int NOT NULL AUTO_INCREMENT, fruit_id int NOT NULL, quantity int NOT NULL COMMENT 入库数量, unit_price decimal(10,2) DEFAULT NULL COMMENT 入库单价, supplier varchar(100) DEFAULT NULL COMMENT 供应商, in_time datetime DEFAULT CURRENT_TIMESTAMP COMMENT 入库时间, remark varchar(255) DEFAULT NULL, PRIMARY KEY (id), KEY idx_fruit_id (fruit_id), CONSTRAINT fk_in_fruit FOREIGN KEY (fruit_id) REFERENCES fruit (id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT入库流水表; CREATE TABLE stock_out ( id int NOT NULL AUTO_INCREMENT, fruit_id int NOT NULL, quantity int NOT NULL COMMENT 出库数量, out_time datetime DEFAULT CURRENT_TIMESTAMP COMMENT 出库时间, receiver varchar(50) DEFAULT NULL COMMENT 领用人, remark varchar(255) DEFAULT NULL, PRIMARY KEY (id), KEY idx_out_fruit_id (fruit_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT出库流水表;fruit.stock是一个冗余汇总字段——理论上库存可以从流水表SUM出来但课设系统直接维护一个字段更直观。alert_min是预警下限查询条件写成stock alert_min就是预警列表。外键fk_in_fruit保证不会插入一个不存在的水果但有个代价是删除水果时会被约束挡住。如果导入脚本报外键错误通常是导表顺序不对先导fruit再导两个流水表。想清空重来用SET FOREIGN_KEY_CHECKS0;临时关闭外键检查清完再打开。提示stock_out表其实也应该加外键这里故意不加是为了展示“流水表不一定要物理外键”的设计取舍。实际课设中加不加都行答辩时能说清理由就好。4.2 出库扣减不能用“先查再减”为什么库存会变成负数看源码里的出库逻辑很多写的是先SELECT stock FROM fruit WHERE id1然后在 Java 里stock - quantity再UPDATE回去。单用户测没毛病但开两个浏览器窗口同时出库库存就乱了。A 和 B 都查到库存 10A 减 3 后写回 7B 减 5 时还拿着旧的 10写回 5最终丢了 2 件。更极端的情况是两个人各减 8写回结果变成 2 或 10而不是正确的 -6。这个问题叫“丢失更新”不是数学算错是并发下读写没做保护。正确写法是把查和减合并成一条原子 SQL-- 条件更新防止库存扣成负数 UPDATE fruit SET stock stock - #{quantity} WHERE id #{fruitId} AND stock #{quantity};SET stock stock - #{quantity}让数据库在行级别做减法同一时刻只有一个事务能改这一行AND stock #{quantity}保证库存不足时影响行数变成 0。代码里的判断逻辑是affectedRows 1说明扣减成功接着插入一条stock_out流水affectedRows 0说明库存不足直接抛出提示不再往下走。这两步必须放在同一个事务里否则扣了库存但流水没插上或者流水插了但库存没扣。如果要讲得更深可以提“版本号乐观锁”在fruit表加一个version字段更新时带上WHERE version #{oldVersion}版本变了自己再重试。课设里用条件更新已经足够但答辩时能对比两种方案显得你真的理解并发问题。重点是别用“先查再减”那种写法应付问两句就露馅了。4.3 Mapper 层补一个“带条件查询”搜索、分类、预警一次搞定资源包自带的 DAO 通常只有selectById和selectAll但页面原型里有搜索框和分类筛选。如果不想改后端结构在 MyBatis 的 Mapper XML 里扩一个查询方法是最快的。下面这一段覆盖了按分类筛选、按名称模糊搜索、只查预警三条需求!-- 水果列表动态查询支持分类、关键字、预警筛选 -- select idselectFruitList resultTypemap SELECT f.id, f.fruit_name, f.category, f.unit, f.stock, f.alert_min FROM fruit f where if testcategory ! null and category ! AND f.category #{category} /if if testkeyword ! null and keyword ! AND f.fruit_name LIKE CONCAT(%, #{keyword}, %) /if if testalertOnly AND f.stock lt; f.alert_min /if /where ORDER BY f.id DESC /selectwhere标签会自动把第一个多余的AND去掉防止拼出WHERE AND的语法错误。lt;是 XML 转义直接写会被当成标签。alertOnly传true时这个查询就是“库存预警列表”对应原型里的预警页面。返回类型用map而不是实体类是为了避免字段映射报错但要注意 MySQL 在 Linux 下查询出的字段别名是区分大小写的fruit_name不能写成Fruit_Name否则 JSON 里会丢字段。如果项目是 JDBC 直连把这个查询改成PreparedStatement拼条件就行核心还是那三个if。数据库这块搞定后整个系统已经从“能跑”变成“能讲”。接下来是实战中每天都会碰到的排坑环节。5. 避坑实录资源包跑不起来、库存对不上、原型和实现脱节这一章是踩坑血泪经验按“现象→原因→解决”写每条都能直接对着你的报错信息查。5.1 现象导入 .sql 脚本时报错倒在文件中间Navicat 双击打开.sql直接执行跑到一半弹出[Err] 1064后面全部停掉。原因一般是脚本里混了可视化工具生成的特殊注释、DELIMITER $$这种存储过程分隔符或者某个字段有CHARSETlatin1和当前库默认字符集不一致。还有可能是脚本开头有DROP TABLE IF EXISTS没注意把已有表删了又重建失败。解决不要整文件执行。用 mysql 命令行分步导入能正确处理DELIMITER# 用客户端内建 source 命令导入 mysql -u root -p --default-character-setutf8mb4 -e source /path/to/fruit_stock.sql--default-character-set必须放在命令前部作用是让客户端按utf8mb4解释脚本里的中文。source是客户端内建命令逐行执行脚本比 Navicat 的批量提交更接近真实执行环境。如果报错位置在某条INSERT把那行的中文值看一眼多半是引号没转义——这是 CSV 转 SQL 时常见的问题。导入后用SELECT COUNT(*) FROM fruit;核对行数和 README 里写的不一致就说明中途跳过了数据。5.2 现象登录页能打开登录后 404 或跳回登录页浏览器能打开/fruit/login.html但提交登录后地址变成/fruit/fruit/fruit/list或者直接白屏。原因基本是context-path和 Controller 路由重复叠加。资源包作者写 Controller 时路由是/fruit/list但application.yml里又配了context-path: /fruit运行时实际映射变成/fruit/fruit/list。登录成功后代码里写了redirect:/fruit/list再叠加 context-path 就成了三节路径肯定 404。解决打开开发者工具 Network 面板看登录请求发去的完整 URL。如果路径里fruit出现了两次把application.yml里的context-path改成/或删掉这行按 Controller 原始路由访问。另一个常见情况是登录成功后应该跳/index而不是/login.html如果模板是 Thymeleaf 或 JSP页面地址不能写成.html需要访问模板映射。找不到原因时先直接访问http://localhost:8080/fruit/看有没有默认页再一层层去掉路径前缀定位是前端还是后端的锅。5.3 现象出库后库存不减反而增加或者变成负数业务里明明写的是stock - quantity但执行后fruit.stock变大。原因往往是前端传参字段名对不上比如表单里nametotal后端RequestParam(quantity)取不到值Java 里默认给 00 - 0不做任何修改。另一种是后端取的是-quantity的绝对值把减号丢了。库存变负数则是没有加stock quantity条件两个请求同时扣各写各的负值就出现了。解决先在stock_out表查最近一条出库记录看quantity是几。如果是 0 或负数前端传参绝对是错的。用浏览器的 Network 面板看 Request Payload跟后端字段名逐一比对。后端扣减 SQL 必须带上AND stock #{quantity}然后用int rows update(...)判断rows 1才提交。如果还要再稳一点把 Service 方法加上Transactional扣库存和插流水同生共死。至于并发压测导致的负数条件更新已经能挡住大部分真的遇到极端场景再考虑给(fruit_id)加锁或者用版本号。5.4 现象数据库里中文正常页面和接口返回的中文是问号表数据没问题但浏览器里显示“”。这种不一致最典型的原因是 JDBC 连接串没带字符集参数MySQL 驱动按操作系统默认编码Windows 下是 GBK把 Unicode 数据转坏了。另一个隐蔽位置是 Spring Boot 的 JSON 响应头里没写charsetutf-8浏览器按猜测解码。解决先改 JDBC URL把它补成jdbc:mysql://localhost:3306/fruit_stock?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai。改完重启还乱查 MySQL 服务端字符集SHOW VARIABLES LIKE character_set_server;如果结果是latin1去my.ini改character-set-serverutf8mb4再重启 MySQL。最后再检查 Spring Boot 配置可以在application.yml里加spring: http: encoding: charset: UTF-8 # 强制请求和响应使用 UTF-8 enabled: true force: trueforce: true会强制所有 HTTP 请求和响应用 UTF-8 编解码覆盖掉容器默认的 ISO-8859-1。这三级依次排查乱码问题基本能根治。还有一个冷门坑如果页面是 JSP需要在web.xml或页面顶部设置pageEncoding但水果库存课设一般不用 JSP遇到再处理。5.5 现象原型里的页面和源码页面长得完全不一样这种资源包通常是从“毕业设计合集”里拆出来的画原型的人和写代码的人不是同一个甚至数据库脚本是第三个人补的。你在原型里看到“入库”按钮是绿色的源码里却是普通链接原型里有“供应商管理”源码里直接没有这个模块。老师问起来你不能说“资源包本来就不完整”那样等于承认自己做的是搬运工。解决以源码能跑的功能为准把原型当成“初版需求”。答辩前花半天逐页核对整理一张差异清单原型的哪个页面对应源码的哪个路由原型有而源码没有的功能要么在报告里写“因时间原因裁剪”要么用 Axure 把原型补成和源码一致。最稳妥的做法是补一个“登录后主页面”的静态页把源码里实际有的菜单画上去这样至少主看一眼不会对不上。实际操作时可以用浏览器搜索 HTML 原型里的文字比如搜“出库”找到对应页面再去源码 Controller 里搜out或stock_out几分钟就能定位一个差异点。6. 把资源包变成你的作品演示数据与验收清单跑通系统只算完成了 50%。剩下的一半是“让老师相信你是真做了”这靠两样东西贴合的演示数据、可复现的运行步骤。演示数据不要用默认的几行测试数据太干巴巴。水果库存应该有真实感的名字——红富士、库尔勒香梨、海南香蕉进货价要合理不能所有水果都是 20 元/斤。我习惯先插二十条水果再插对应入库流水让库存数字有出处。如果你用的数据库脚本里已经有数据先用TRUNCATE清掉业务表再按自己的数据插入保证账目干净。演示前一定要准备好一套“刚好够扣”的数据比如苹果库存 100 斤出库 80 斤剩余 20就能触发预警再出库 21 斤系统必须提示库存不足。如果演示时只想着“随便点一点”很可能出现出库 100 但库存只有 12 的尴尬——我翻过这个车接下来的动作全乱老师会觉得系统有 bug。正确的验收顺序是登录→查列表→入库→出库→触发预警→看统计每一步截图存档同时在草稿纸上写好预期结果和实际结果。最后说一个习惯下载的资源包最终要变成你自己的文件夹结构。我一般重新建三个目录源码、原型、数据库把原作者没用的.idea、.git、target删掉再写一个三行 README技术栈、数据库名、启动命令。这样三个月后你想重新演示一次不用再靠回忆是哪份配置。整个过程不复杂但能从“能跑”变成“能讲”。希望这份完整路径能帮到你别把宝贵时间浪费在反复踩同一个坑上。本文还有配套的精品资源点击获取