简介基于SSH框架的百货中心供应链管理系统Java Web项目是一套适合毕业设计、课程设计及SSH初学者参考的完整源码包。系统围绕管理员登录、合作公司管理、采购管理、数据统计四大功能模块实现合作公司信息增改查、采购信息维护以及业务数据的统计汇总能够覆盖中小型百货中心供应链管理的常见需求。7z压缩包共包含16个文件整体大小约64.24MB内附源代码压缩包、MySQL数据库脚本、毕业设计说明书文档、10张项目截图以及2段辅导视频其中一段演示项目部署与启动另一段针对数据统计、采购管理、合作公司管理等核心模块进行操作讲解。目前已有221人学习下载全套资料既可用于论文撰写与答辩准备也能帮助读者快速搭建运行环境深入理解SSH整合、MySQL数据操作和前端页面交互的具体实现。1. 先说结论javaEE-SSH 老项目源码为什么现在还要装一遍“javaEE-SSH 新百货中心供应链管理系统”这类标题在源码检索里一直是高频词。一个反直觉的现实是SSHStruts2 Spring Hibernate已经是十年前的组合但每年做 JavaWeb 课程设计、毕业设计的人翻来覆去找的还是这批项目。它带 mysql 源码和数据库 sql 脚本意味着拿到的不是一个空壳 demo而是可以直接建库、导入数据、启动 Tomcat 后前后台联调的小型供应链系统。这套东西适合三类人需要交课设或毕设的在校生、刚接手老进销存系统的维护者、想在一个真实业务里看懂 SSH 三层整合的 Java 初学者。它解决的问题只有一个在一台普通电脑上把一个带商品、采购、库存、销售完整链路的系统跑起来并且改得动、讲得清。2. 拆业务与技术栈新百货中心供应链系统在管哪些数据SSH 三兄弟各管哪一层2.1 供应链系统的八大基础模块与单据流转百货中心的供应链管的是“进—存—销”三条线供应商送来多少货、仓库收了多少、现在还剩多少、卖出去多少。源码包里的模块基本围绕这三条线展开再加一套权限和会员体系。下面这八类模块是大多数百货/超市/连锁门店系统的标配模块典型数据表一句话职责商品管理product维护商品编码、名称、条码、单位、进价、售价、预警库存供应商管理supplier维护供应商编码、名称、联系人、电话、结算周期采购管理purchase_order / purchase_item采购主单 明细单据状态要流转入库管理stock_in验收入库单入库后增加库存库存管理inventory当前库存、锁定库存、预警下限零售出库sale_order / sale_item销售订单和销售明细会员管理member办卡、积分、余额系统管理sys_user / sys_role / sys_menu登录账号、角色、菜单权限单据流转的核心链路是supplier → purchase_order → stock_in → inventory → sale_order。这里面最容易忽略的是采购主表和明细表的设计。purchase_order 存“单号、供应商、审核状态、总金额”purchase_item 存“哪张单、哪个商品、数量、单价”中间靠 order_id 外键关联。设计上必须让主单先落库拿到自增 ID明细再逐条写 order_id否则一对多关系会断掉。状态字段决定业务流程能不能往下走。我见过太多源码把 status 用 Int 直接写死在代码里0 草稿、1 已审核、2 已入库、3 已作废。调通一个采购单的完整状态流转比调十个 CRUD 页面更能说明你理解这套供应链系统。2.2 Struts2、Spring、Hibernate 的职责边界与配置文件骨架SSH 三个框架的分工要记牢Struts2 管 Web 层负责接收请求、封装参数、跳转页面Spring 管对象装配和事务用它把所有 Bean 串起来Hibernate 管持久化用映射文件把 Java 对象翻译成 SQL。三层边界一旦清楚后续排查问题就知道该翻哪个配置文件。先看 Struts2 的路由配置一般叫 struts.xml。一个最简 action 是这样的struts package namedefault namespace/product extendsstruts-default action namelist classproductAction methodlist result namesuccess/product/list.jsp/result /action /package /struts逻辑说明namespace 定义了访问路径前缀浏览器请求/product/list.action会命中这个 actionclass 指向 Spring 容器里的 Bean 名称method 指定调哪个方法返回值是字符串 success 时跳转到 list.jsp。这里有个细节老项目通常把 Struts2 的 Action 对象交给 Spring 管理class 属性不再是完整类名而是 Spring 里的 Bean id写错 Bean 名启动时不报错请求一到直接空指针。再看 Spring 管的数据源和 SessionFactory 配置这是决定系统能不能连上 MySQL 的关键bean iddataSource classorg.apache.commons.dbcp.BasicDataSource destroy-methodclose property namedriverClassName valuecom.mysql.jdbc.Driver/ property nameurl valuejdbc:mysql://127.0.0.1:3306/mall?useUnicodetrueamp;characterEncodingutf8/ property nameusername valueroot/ property namepassword value123456/ /bean bean idsessionFactory classorg.springframework.orm.hibernate3.LocalSessionFactoryBean property namedataSource refdataSource/ property namemappingResources list valuecom/mall/entity/product.hbm.xml/value /list /property property namehibernateProperties props prop keyhibernate.dialectorg.hibernate.dialect.MySQLDialect/prop prop keyhibernate.show_sqltrue/prop /props /property /bean参数说明url 里我写的是127.0.0.1不是localhost。前者强制走 TCP 连接后者在部分 MySQL 客户端工具里会去连 unix socket 文件服务没启动时直接报错。useUnicodetruecharacterEncodingutf8是中文不乱码的第一道保险注意在 XML 文件里必须写成amp;在 .properties 文件里写单个就行。hibernate.dialect 决定了 Hibernate 生成什么样的分页和查询语句MySQL 5.x 用这个值没问题切换到 MySQL 8.0 建议确认方言版本。Hibernate 的映射文件是源码里最容易被忽略的一环。实体类加了一个字段但 product.hbm.xml 里没加 property运行期 Hibernate 生成的 SQL 就不会带这个字段而且这种错误启动时不报往往要等跑具体功能才暴露。后面第 6 章会专门演示改字段的完整链路。3. 用 JDK Tomcat MySQL 把源码跑起来本地复现最小步骤3.1 环境版本组合与三条验证命令跑老 SSH 项目环境版本是第一道坎。很多人一上来装最新的 JDK 21 和 Tomcat 10结果项目怎么都起不来其实是版本不兼容。这个源码包是基于 Servlet 3.1 和 JDK 8 时代的技术写的最常见的做法是 JDK 1.8 Tomcat 8.5 MySQL 5.7 三件套能覆盖绝大多数源码包组件推荐版本原因与备注JDK1.8jdk8u202 之后的版本即可老 CGLIB 代理、反射在高版本 JDK 上容易踩 IllegalAccessErrorTomcat8.5.x支持 Servlet 3.1跑 Spring/Struts2 老项目稳定MySQL5.7.x对 sql 脚本兼容性最好8.0 需要额外调驱动和时区IDEEclipse 或 IntelliJ IDEA重点是能把 WEB-INF/lib 下的 jar 正确加载进构建路径装完环境不要急着开 IDE先在命令行把三件套的状态摸清楚java -version javac -version echo $JAVA_HOME mysqld --version mysql -uroot -p -e select version();逻辑说明java 和 javac 版本不一致会直接导致源码编译报错echo 检查 JAVA_HOME 是为了确认 Tomcat 启动时能找到正确的 JVMmysql 客户端能连上才说明数据库服务在运行。我见过不少人在 IDE 里折腾半天最后发现是 JDK 没配 JAVA_HOMETomcat 起不来。IDE 导入这一步注意不要选错项目类型。源码包里通常自带 .classpath 和 .project 文件Eclipse 直接 Import Existing Projects into WorkspaceIDEA 选 Open 后让它识别为 Web 项目。如果源码包没有这些文件就新建 Web 项目再把 src 目录标记为 Sources Root把 WEB-INF/lib 下的 jar 全选 Add as Library。lib 目录里一般有几十个 jar缺一个启动就报 ClassNotFoundException尽量别用 Maven 重新引依赖老项目的依赖坐标未必全在中央仓库里。3.2 改数据源、导入 sql、发布到 Tomcat 的完整操作源码包拿到手先找数据库连接配置通常位于WEB-INF/classes下的 jdbc.properties 或 applicationContext.xml。修改数据库名、用户名、密码三个值其他别乱动jdbc.drivercom.mysql.jdbc.Driver jdbc.urljdbc:mysql://127.0.0.1:3306/mall?useUnicodetruecharacterEncodingutf8useSSLfalse jdbc.usernameroot jdbc.password123456参数说明mall 是数据库名与 sql 脚本里建的库保持一致useSSLfalse 避免 MySQL 5.7 连接时输出大量 SSL 警告MySQL 8.0 还得另加 serverTimezoneAsia/Shanghai。如果你用 IDEA 导入后改了配置不生效多半是 classes 目录被 IDEA 重新编译覆盖了改完记得删掉 target 目录里的旧 class 再重启。接下来导入数据库脚本。先从命令行建库再把 sql 文件灌进去mysql -uroot -p -e create database if not exists mall default charset utf8mb4; mysql -uroot -p mall /path/to/db_mall.sql mysql -uroot -p -e update mall.sys_user set passwordmd5(123456) where user_nameadmin;三条命令的用途第一条建库指定 utf8mb4 字符集比 utf8 能存更多生僻字和 emoji第二条把表结构和初始化数据导入第三条重置管理员密码因为老系统初始化数据里通常写死一个已知密码或者密码字段是明文统一刷成 md5 方便登录验证。md5 不是安全做法但老系统就这么设的你做课设讲清算旧账即可。启动 Tomcat 用命令行比 IDE 里的隐藏控制台直观日志全在文件里cd /usr/local/tomcat/bin ./startup.sh tail -f ../logs/catalina.out启动后浏览器访问http://localhost:8080/项目上下文路径/如果看到首页但跳转 404检查两件事web.xml 里的欢迎页配置以及 Struts2 的 Filter 是否拦截了.action后缀。老项目经常在 web.xml 里把 Struts2 的过滤路径写成/*静态资源被拦掉导致页面光秃秃。3.3 用 SSH 工具把系统推到 Linux 服务器远程部署命令序列本地跑通只是第一步很多人的最终交付是把项目部署到一台 CentOS 服务器上。这里的 ssh 命令是 OpenSSH 远程连接工具和项目标题里的 SSH 框架是完完全全两码事别搞混。实际部署无非是传 war 包、导入 sql、启 Tomcat 三个动作# 打包成 war 后上传到服务器的 webapps 目录 scp target/mall.war root192.168.1.10:/usr/local/tomcat/webapps/ # 远程执行建库、导数据、启动服务 ssh root192.168.1.10 mysql -uroot -p mall /tmp/db_mall.sql /usr/local/tomcat/bin/startup.sh参数说明scp 走的是 22 端口如果服务器改了端口要用-P 端口号参数每次输密码麻烦可以在本地生成密钥对把公钥追加到服务器的 authorized_keys 文件里后续免密登录。如果你习惯用 vscode 的 Remote-SSH 插件连服务器可以直接打开 catalina.out 日志排查。Windows 用户用 ssh 命令时容易踩一个权限坑报Bad owner or permissions on C:\Users\名字\.ssh/config原因是 OpenSSH 要求 config 文件不能被其他用户读写。解决方法是右键 config 文件属性 → 安全 → 禁用继承只保留当前用户的完全控制权限然后重连。这类问题服务器本身没毛病纯属客户端环境不给力。4. 吃透 mysql 数据库脚本建库建表、字典初始化和两类高频查询4.1 数据库脚本的阅读顺序先建库再建表最后埋数据拿到 sql 脚本别急着整库导入先按顺序读一遍。大多数源码包的脚本结构是drop 旧库、create 新库、use 库、逐张建表、插入初始化数据。建表脚本里能看到设计者对数据类型的取舍这也是答辩时最常被问到的地方。下面是一份常见的初始化片段drop database if exists mall; create database mall default charset utf8mb4; use mall; create table sys_user ( id int primary key auto_increment, user_name varchar(32) not null unique, password varchar(64) not null, real_name varchar(32), status tinyint default 1, create_time datetime ) engineInnoDB default charsetutf8mb4; create table product ( id int primary key auto_increment, product_no varchar(32) not null unique, name varchar(128) not null, barcode varchar(32), unit varchar(8) default 件, purchase_price decimal(10,2) default 0.00, sale_price decimal(10,2) default 0.00, warn_stock int default 0, status tinyint default 1 ) engineInnoDB default charsetutf8mb4;字段设计的三处习惯要能说清楚。第一金额一律用 decimal(10,2)float/double 存金额会产生精度漂移对账对不上。第二status 用 tinyint 默认 1语义是可用/停用这就是热词里常搜的“mysql 设置默认值为 0”的变体默认值写 0 还是 1 取决于业务约定但必须显示声明 default不能留空。第三外键约束我建议不在建表语句里写老项目普遍用程序保证关联数据一致性建表只保留 id 和唯一索引后续导数据能少踩不少顺序坑。表名和字段名全部用小写是 Linux 部署的前置条件。Windows 上 MySQL 默认不区分大小写Linux 上表名严格区分。如果脚本里 product 和 Product 混着写Windows 能跑发到 Linux 直接报“表不存在”后面第 5 章会细说。4.2 初始化数据的三处细节默认管理员、字段默认值、状态字典初始化数据是整个脚本里最容易被忽略但最要命的部分。建完表没有数据系统登录都进不去有数据但状态字典对不上页面下拉框全是空的。第一处细节是管理员账号老系统特别喜欢直接用明文密码插库我通常拿到手第一件事是把它刷成 md5。insert into sys_user (user_name, password, real_name, status, create_time) values (admin, md5(123456), 系统管理员, 1, now());逻辑说明md5 函数是 MySQL 内置的不用额外处理。如果你改完密码用 admin 登录还是失败大概率是系统登录逻辑里加了盐或者源码里对密码做了二次加密这时直接看源码里的登录方法比猜快得多。第二处细节是字段默认值。老脚本里很多字段不写 default插入时 Java 实体类又设了默认值两套默认值不一致页面显示和数据库存储就会打架。用 Navicat 打开表结构逐个检查 status、type、create_time 这类字段确认默认值和代码里的常量对齐。第三处细节是状态字典。有的系统单独建 dict_type 和 dict_item 表有的系统直接在代码里用常量类定义。如果脚本里有字典表导完数据要重点查这两张表有没有记录因为采购单状态、商品上下架、订单类型全部依赖字典翻译。字典表为空页面上全是数字编号系统看起来就像没做完。4.3 业务上最常用的两类 SQL采购汇总与低库存预警供应链系统的答辩和二次开发绕不开两类 SQL一是某个时间段内采购了多少钱的货二是哪些商品库存已经低于预警线。第一类要拆到明细用两张表 join 再加聚合select p.product_no as 商品编码, p.name as 商品名称, sum(pi.qty) as 采购总量, sum(pi.qty * pi.price) as 采购金额 from purchase_item pi join product p on pi.product_id p.id join purchase_order po on pi.order_id po.id where po.status 1 and po.create_time 2024-01-01 group by p.id order by 采购金额 desc;参数说明status 1 表示只统计已审核的采购单草稿单不能进报表create_time 按业务需要调整起始日期如果要按月份统计用date_format(po.create_time, %Y-%m)做分组条件。这个语句在源码里通常对应一个统计报表 Action底层用 Hibernate 的 HQL 写但面试或答辩时直接用 SQL 讲逻辑更清晰。第二类是低库存预警难点在于处理“还没有库存记录”的商品。新商品建档后没入过库inventory 表里根本没有对应行用内连接会漏掉这些最需要补货的商品。正确写法用左连接加空值判断select p.product_no, p.name, p.warn_stock as 预警下限, ifnull(inv.stock_qty, 0) as 当前库存 from product p left join inventory inv on inv.product_id p.id where inv.stock_qty is null or inv.stock_qty p.warn_stock;逻辑说明ifnull 把 null 转成 0让页面展示更友好where 条件里 is null 和 用 or 连接覆盖“从未入库”和“已低于阈值”两类情况。这段 SQL 写好后面做库存预警功能的二次开发就有了核心查询。5. 启动与部署避坑5 个高频翻车现场还原5.1 启动即 ClassNotFoundException缺 jar 包或 JDK 版本太新现象Tomcat 启动到一半catalina.out 里刷出几十条 ClassNotFoundException页面访问直接 404 或 500。原因多半是两个WEB-INF/lib 下的 jar 没有被类加载器扫到或者 JDK 版本太新导致老框架启动失败。解决先用命令确认 lib 下的 jar 数量再检查 IDE 是否把 lib 目录加入了构建路径如果 jar 数量正常把 JDK 换回 1.8 重新跑一遍。老 SSH 项目最怕的不是代码而是 JDK 17 之后的模块化限制CGLIB 代理经常静默失败报错还特别隐蔽。5.2 mysql.sock 连不上localhost 与 TCP 的差异现象命令行执行mysql -uroot -p报ERROR 2002 (HY000): Cant connect to local MySQL server through socket /tmp/mysql.sock。第一次见这个错的人会以为是 MySQL 没装好其实大部分时候是 MySQL 服务根本没启动或者 my.cnf 里 socket 路径改了但客户端还在默认位置找。解决先service mysqld start或mysqld_safe 把服务拉起来如果服务已经在跑但还报错检查 my.cnf 的 socket 配置或者干脆改用 TCP 方式连接mysql -h 127.0.0.1 -P 3306 -uroot -p。Java 项目的 JDBC 驱动走的是 TCP不受 socket 影响这个错主要拦在导入 sql 脚本那一步。5.3 Linux 下表名大小写导致“表不存在”现象在 Windows 上 Navicat 能看到 product 表程序跑得好好的war 包部署到 Linux 后请求商品列表页报Table mall.Product doesnt exist。原因Windows 的 MySQL 默认 lower_case_table_names1 不区分大小写Linux 默认是 0 严格区分脚本里建表是小写 product代码或 Hibernate 映射里却写成了 ProductWindows 帮你兜底Linux 直接翻车。解决查一下建表语句里的表名统一成小写同时检查 hbm.xml 里的 table 属性和 SQL 里的表名全部改成小写。最稳妥的做法是在 MySQL 配置里加lower_case_table_names1但这属于修改数据库行为课设答辩时不一定说得清不如改代码来得干净。5.4 中文乱码“能跑但全是问号”的连锁反应现象页面能打开但商品名称、供应商名字全是问号往数据库插中文后Navicat 里看也是乱码。原因不是单点问题而是三处编码不一致页面 JSP 的 charset、MySQL 连接 URL 的 characterEncoding、数据库表和字段的 charset有一个不对就乱。解决JSP 头部统一pageEncodingUTF-8JDBC URL 加上useUnicodetruecharacterEncodingutf8建表语句统一default charsetutf8mb4。改完这三处后清理浏览器缓存删掉 Tomcat work 目录下的临时文件再重启否则页面里残留的旧 class 编码还会继续捣乱。5.5 数据“写不进去也不报错”事务没提交的假象现象新增商品、保存采购单时页面提示操作成功刷新列表数据却没了后台也不报任何异常。原因大概率是 Spring 事务没生效。检查顺序是applicationContext.xml 里有没有配置事务管理器service 方法上有没有加 Transactional 或事务切面事务管理器有没有被 AOP 切到对应的 service 类。Hibernate 的 flushMode 也要看如果设成 manual数据一直攒在 session 里不落库只有事务提交时才 flush。解决在事务配置正确的前提下故意在 service 方法末尾抛一个 RuntimeException看数据是否回滚能回滚说明事务生效不回滚说明配置是摆设。这是验证事务边界最快的方法比翻日志管用。6. 二次开发演练给商品表加库存预警字段并验证 Hibernate 映射与事务6.1 一条完整链路ALTER TABLE、hbm 映射、页面展示假设要给商品档案增加一个“预警天数”字段用于后续按天算补货周期。这个需求不大但能完整走一遍 SSH 改功能的标准步骤按顺序来alter table product add column warn_days int not null default 7 comment 库存预警天数;第一步是数据库加字段执行完用desc product;确认字段已存在。第二步改实体类在 Product.java 里加一个 warnDays 的 Integer 属性补上 getter/setter。第三步改 Hibernate 映射文件这是老 SSH 项目最容易漏的一步property namewarnDays columnwarn_days typejava.lang.Integer/映射文件里 property 的 name 对应 Java 属性column 对应数据库字段type 用包装类型避免基本类型默认值问题。改完映射JSP 页面的表单加一个输入框列表页加一列展示这个功能就算串起来了。6.2 验证改造生效的三个信号show_sql、预热调用与事务回滚功能改完怎么确认它真的生效第一个信号是启动日志。把 hibernate.show_sql 设为 true启动 Tomcat 后第一次访问商品列表控制台打印的 SQL 里应包含warn_days字段。没有它说明映射文件没改对或改完没重新编译。第二个信号是持久化验证。新建一个商品填上预警天数 7保存后直接查数据库确认值写进去了。第三个信号是回滚验证。故意在保存商品的 Service 方法里抛一个 RuntimeException页面应该报错数据库里不该出现这条商品记录。这套源码真正值钱的地方不在代码写得多漂亮而在它把 SSH 三层拆得足够清楚。我做过一次课设在 Product 实体里加字段忘了改 hbm.xml启动不报错一保存就报“字段不存在”最后一行一行对比映射文件才发现漏了配置。那种对着黑匣子猜问题的感觉特别磨人后来学乖了改字段必过三关数据库字段、Java 属性、hbm 映射少一个都不往下走。这个习惯帮我少加了不少班也希望帮到你。本文还有配套的精品资源点击获取 javaEE SSH新百货中心供应链系统部署与二次开发实战
简介基于SSH框架的百货中心供应链管理系统Java Web项目是一套适合毕业设计、课程设计及SSH初学者参考的完整源码包。系统围绕管理员登录、合作公司管理、采购管理、数据统计四大功能模块实现合作公司信息增改查、采购信息维护以及业务数据的统计汇总能够覆盖中小型百货中心供应链管理的常见需求。7z压缩包共包含16个文件整体大小约64.24MB内附源代码压缩包、MySQL数据库脚本、毕业设计说明书文档、10张项目截图以及2段辅导视频其中一段演示项目部署与启动另一段针对数据统计、采购管理、合作公司管理等核心模块进行操作讲解。目前已有221人学习下载全套资料既可用于论文撰写与答辩准备也能帮助读者快速搭建运行环境深入理解SSH整合、MySQL数据操作和前端页面交互的具体实现。1. 先说结论javaEE-SSH 老项目源码为什么现在还要装一遍“javaEE-SSH 新百货中心供应链管理系统”这类标题在源码检索里一直是高频词。一个反直觉的现实是SSHStruts2 Spring Hibernate已经是十年前的组合但每年做 JavaWeb 课程设计、毕业设计的人翻来覆去找的还是这批项目。它带 mysql 源码和数据库 sql 脚本意味着拿到的不是一个空壳 demo而是可以直接建库、导入数据、启动 Tomcat 后前后台联调的小型供应链系统。这套东西适合三类人需要交课设或毕设的在校生、刚接手老进销存系统的维护者、想在一个真实业务里看懂 SSH 三层整合的 Java 初学者。它解决的问题只有一个在一台普通电脑上把一个带商品、采购、库存、销售完整链路的系统跑起来并且改得动、讲得清。2. 拆业务与技术栈新百货中心供应链系统在管哪些数据SSH 三兄弟各管哪一层2.1 供应链系统的八大基础模块与单据流转百货中心的供应链管的是“进—存—销”三条线供应商送来多少货、仓库收了多少、现在还剩多少、卖出去多少。源码包里的模块基本围绕这三条线展开再加一套权限和会员体系。下面这八类模块是大多数百货/超市/连锁门店系统的标配模块典型数据表一句话职责商品管理product维护商品编码、名称、条码、单位、进价、售价、预警库存供应商管理supplier维护供应商编码、名称、联系人、电话、结算周期采购管理purchase_order / purchase_item采购主单 明细单据状态要流转入库管理stock_in验收入库单入库后增加库存库存管理inventory当前库存、锁定库存、预警下限零售出库sale_order / sale_item销售订单和销售明细会员管理member办卡、积分、余额系统管理sys_user / sys_role / sys_menu登录账号、角色、菜单权限单据流转的核心链路是supplier → purchase_order → stock_in → inventory → sale_order。这里面最容易忽略的是采购主表和明细表的设计。purchase_order 存“单号、供应商、审核状态、总金额”purchase_item 存“哪张单、哪个商品、数量、单价”中间靠 order_id 外键关联。设计上必须让主单先落库拿到自增 ID明细再逐条写 order_id否则一对多关系会断掉。状态字段决定业务流程能不能往下走。我见过太多源码把 status 用 Int 直接写死在代码里0 草稿、1 已审核、2 已入库、3 已作废。调通一个采购单的完整状态流转比调十个 CRUD 页面更能说明你理解这套供应链系统。2.2 Struts2、Spring、Hibernate 的职责边界与配置文件骨架SSH 三个框架的分工要记牢Struts2 管 Web 层负责接收请求、封装参数、跳转页面Spring 管对象装配和事务用它把所有 Bean 串起来Hibernate 管持久化用映射文件把 Java 对象翻译成 SQL。三层边界一旦清楚后续排查问题就知道该翻哪个配置文件。先看 Struts2 的路由配置一般叫 struts.xml。一个最简 action 是这样的struts package namedefault namespace/product extendsstruts-default action namelist classproductAction methodlist result namesuccess/product/list.jsp/result /action /package /struts逻辑说明namespace 定义了访问路径前缀浏览器请求/product/list.action会命中这个 actionclass 指向 Spring 容器里的 Bean 名称method 指定调哪个方法返回值是字符串 success 时跳转到 list.jsp。这里有个细节老项目通常把 Struts2 的 Action 对象交给 Spring 管理class 属性不再是完整类名而是 Spring 里的 Bean id写错 Bean 名启动时不报错请求一到直接空指针。再看 Spring 管的数据源和 SessionFactory 配置这是决定系统能不能连上 MySQL 的关键bean iddataSource classorg.apache.commons.dbcp.BasicDataSource destroy-methodclose property namedriverClassName valuecom.mysql.jdbc.Driver/ property nameurl valuejdbc:mysql://127.0.0.1:3306/mall?useUnicodetrueamp;characterEncodingutf8/ property nameusername valueroot/ property namepassword value123456/ /bean bean idsessionFactory classorg.springframework.orm.hibernate3.LocalSessionFactoryBean property namedataSource refdataSource/ property namemappingResources list valuecom/mall/entity/product.hbm.xml/value /list /property property namehibernateProperties props prop keyhibernate.dialectorg.hibernate.dialect.MySQLDialect/prop prop keyhibernate.show_sqltrue/prop /props /property /bean参数说明url 里我写的是127.0.0.1不是localhost。前者强制走 TCP 连接后者在部分 MySQL 客户端工具里会去连 unix socket 文件服务没启动时直接报错。useUnicodetruecharacterEncodingutf8是中文不乱码的第一道保险注意在 XML 文件里必须写成amp;在 .properties 文件里写单个就行。hibernate.dialect 决定了 Hibernate 生成什么样的分页和查询语句MySQL 5.x 用这个值没问题切换到 MySQL 8.0 建议确认方言版本。Hibernate 的映射文件是源码里最容易被忽略的一环。实体类加了一个字段但 product.hbm.xml 里没加 property运行期 Hibernate 生成的 SQL 就不会带这个字段而且这种错误启动时不报往往要等跑具体功能才暴露。后面第 6 章会专门演示改字段的完整链路。3. 用 JDK Tomcat MySQL 把源码跑起来本地复现最小步骤3.1 环境版本组合与三条验证命令跑老 SSH 项目环境版本是第一道坎。很多人一上来装最新的 JDK 21 和 Tomcat 10结果项目怎么都起不来其实是版本不兼容。这个源码包是基于 Servlet 3.1 和 JDK 8 时代的技术写的最常见的做法是 JDK 1.8 Tomcat 8.5 MySQL 5.7 三件套能覆盖绝大多数源码包组件推荐版本原因与备注JDK1.8jdk8u202 之后的版本即可老 CGLIB 代理、反射在高版本 JDK 上容易踩 IllegalAccessErrorTomcat8.5.x支持 Servlet 3.1跑 Spring/Struts2 老项目稳定MySQL5.7.x对 sql 脚本兼容性最好8.0 需要额外调驱动和时区IDEEclipse 或 IntelliJ IDEA重点是能把 WEB-INF/lib 下的 jar 正确加载进构建路径装完环境不要急着开 IDE先在命令行把三件套的状态摸清楚java -version javac -version echo $JAVA_HOME mysqld --version mysql -uroot -p -e select version();逻辑说明java 和 javac 版本不一致会直接导致源码编译报错echo 检查 JAVA_HOME 是为了确认 Tomcat 启动时能找到正确的 JVMmysql 客户端能连上才说明数据库服务在运行。我见过不少人在 IDE 里折腾半天最后发现是 JDK 没配 JAVA_HOMETomcat 起不来。IDE 导入这一步注意不要选错项目类型。源码包里通常自带 .classpath 和 .project 文件Eclipse 直接 Import Existing Projects into WorkspaceIDEA 选 Open 后让它识别为 Web 项目。如果源码包没有这些文件就新建 Web 项目再把 src 目录标记为 Sources Root把 WEB-INF/lib 下的 jar 全选 Add as Library。lib 目录里一般有几十个 jar缺一个启动就报 ClassNotFoundException尽量别用 Maven 重新引依赖老项目的依赖坐标未必全在中央仓库里。3.2 改数据源、导入 sql、发布到 Tomcat 的完整操作源码包拿到手先找数据库连接配置通常位于WEB-INF/classes下的 jdbc.properties 或 applicationContext.xml。修改数据库名、用户名、密码三个值其他别乱动jdbc.drivercom.mysql.jdbc.Driver jdbc.urljdbc:mysql://127.0.0.1:3306/mall?useUnicodetruecharacterEncodingutf8useSSLfalse jdbc.usernameroot jdbc.password123456参数说明mall 是数据库名与 sql 脚本里建的库保持一致useSSLfalse 避免 MySQL 5.7 连接时输出大量 SSL 警告MySQL 8.0 还得另加 serverTimezoneAsia/Shanghai。如果你用 IDEA 导入后改了配置不生效多半是 classes 目录被 IDEA 重新编译覆盖了改完记得删掉 target 目录里的旧 class 再重启。接下来导入数据库脚本。先从命令行建库再把 sql 文件灌进去mysql -uroot -p -e create database if not exists mall default charset utf8mb4; mysql -uroot -p mall /path/to/db_mall.sql mysql -uroot -p -e update mall.sys_user set passwordmd5(123456) where user_nameadmin;三条命令的用途第一条建库指定 utf8mb4 字符集比 utf8 能存更多生僻字和 emoji第二条把表结构和初始化数据导入第三条重置管理员密码因为老系统初始化数据里通常写死一个已知密码或者密码字段是明文统一刷成 md5 方便登录验证。md5 不是安全做法但老系统就这么设的你做课设讲清算旧账即可。启动 Tomcat 用命令行比 IDE 里的隐藏控制台直观日志全在文件里cd /usr/local/tomcat/bin ./startup.sh tail -f ../logs/catalina.out启动后浏览器访问http://localhost:8080/项目上下文路径/如果看到首页但跳转 404检查两件事web.xml 里的欢迎页配置以及 Struts2 的 Filter 是否拦截了.action后缀。老项目经常在 web.xml 里把 Struts2 的过滤路径写成/*静态资源被拦掉导致页面光秃秃。3.3 用 SSH 工具把系统推到 Linux 服务器远程部署命令序列本地跑通只是第一步很多人的最终交付是把项目部署到一台 CentOS 服务器上。这里的 ssh 命令是 OpenSSH 远程连接工具和项目标题里的 SSH 框架是完完全全两码事别搞混。实际部署无非是传 war 包、导入 sql、启 Tomcat 三个动作# 打包成 war 后上传到服务器的 webapps 目录 scp target/mall.war root192.168.1.10:/usr/local/tomcat/webapps/ # 远程执行建库、导数据、启动服务 ssh root192.168.1.10 mysql -uroot -p mall /tmp/db_mall.sql /usr/local/tomcat/bin/startup.sh参数说明scp 走的是 22 端口如果服务器改了端口要用-P 端口号参数每次输密码麻烦可以在本地生成密钥对把公钥追加到服务器的 authorized_keys 文件里后续免密登录。如果你习惯用 vscode 的 Remote-SSH 插件连服务器可以直接打开 catalina.out 日志排查。Windows 用户用 ssh 命令时容易踩一个权限坑报Bad owner or permissions on C:\Users\名字\.ssh/config原因是 OpenSSH 要求 config 文件不能被其他用户读写。解决方法是右键 config 文件属性 → 安全 → 禁用继承只保留当前用户的完全控制权限然后重连。这类问题服务器本身没毛病纯属客户端环境不给力。4. 吃透 mysql 数据库脚本建库建表、字典初始化和两类高频查询4.1 数据库脚本的阅读顺序先建库再建表最后埋数据拿到 sql 脚本别急着整库导入先按顺序读一遍。大多数源码包的脚本结构是drop 旧库、create 新库、use 库、逐张建表、插入初始化数据。建表脚本里能看到设计者对数据类型的取舍这也是答辩时最常被问到的地方。下面是一份常见的初始化片段drop database if exists mall; create database mall default charset utf8mb4; use mall; create table sys_user ( id int primary key auto_increment, user_name varchar(32) not null unique, password varchar(64) not null, real_name varchar(32), status tinyint default 1, create_time datetime ) engineInnoDB default charsetutf8mb4; create table product ( id int primary key auto_increment, product_no varchar(32) not null unique, name varchar(128) not null, barcode varchar(32), unit varchar(8) default 件, purchase_price decimal(10,2) default 0.00, sale_price decimal(10,2) default 0.00, warn_stock int default 0, status tinyint default 1 ) engineInnoDB default charsetutf8mb4;字段设计的三处习惯要能说清楚。第一金额一律用 decimal(10,2)float/double 存金额会产生精度漂移对账对不上。第二status 用 tinyint 默认 1语义是可用/停用这就是热词里常搜的“mysql 设置默认值为 0”的变体默认值写 0 还是 1 取决于业务约定但必须显示声明 default不能留空。第三外键约束我建议不在建表语句里写老项目普遍用程序保证关联数据一致性建表只保留 id 和唯一索引后续导数据能少踩不少顺序坑。表名和字段名全部用小写是 Linux 部署的前置条件。Windows 上 MySQL 默认不区分大小写Linux 上表名严格区分。如果脚本里 product 和 Product 混着写Windows 能跑发到 Linux 直接报“表不存在”后面第 5 章会细说。4.2 初始化数据的三处细节默认管理员、字段默认值、状态字典初始化数据是整个脚本里最容易被忽略但最要命的部分。建完表没有数据系统登录都进不去有数据但状态字典对不上页面下拉框全是空的。第一处细节是管理员账号老系统特别喜欢直接用明文密码插库我通常拿到手第一件事是把它刷成 md5。insert into sys_user (user_name, password, real_name, status, create_time) values (admin, md5(123456), 系统管理员, 1, now());逻辑说明md5 函数是 MySQL 内置的不用额外处理。如果你改完密码用 admin 登录还是失败大概率是系统登录逻辑里加了盐或者源码里对密码做了二次加密这时直接看源码里的登录方法比猜快得多。第二处细节是字段默认值。老脚本里很多字段不写 default插入时 Java 实体类又设了默认值两套默认值不一致页面显示和数据库存储就会打架。用 Navicat 打开表结构逐个检查 status、type、create_time 这类字段确认默认值和代码里的常量对齐。第三处细节是状态字典。有的系统单独建 dict_type 和 dict_item 表有的系统直接在代码里用常量类定义。如果脚本里有字典表导完数据要重点查这两张表有没有记录因为采购单状态、商品上下架、订单类型全部依赖字典翻译。字典表为空页面上全是数字编号系统看起来就像没做完。4.3 业务上最常用的两类 SQL采购汇总与低库存预警供应链系统的答辩和二次开发绕不开两类 SQL一是某个时间段内采购了多少钱的货二是哪些商品库存已经低于预警线。第一类要拆到明细用两张表 join 再加聚合select p.product_no as 商品编码, p.name as 商品名称, sum(pi.qty) as 采购总量, sum(pi.qty * pi.price) as 采购金额 from purchase_item pi join product p on pi.product_id p.id join purchase_order po on pi.order_id po.id where po.status 1 and po.create_time 2024-01-01 group by p.id order by 采购金额 desc;参数说明status 1 表示只统计已审核的采购单草稿单不能进报表create_time 按业务需要调整起始日期如果要按月份统计用date_format(po.create_time, %Y-%m)做分组条件。这个语句在源码里通常对应一个统计报表 Action底层用 Hibernate 的 HQL 写但面试或答辩时直接用 SQL 讲逻辑更清晰。第二类是低库存预警难点在于处理“还没有库存记录”的商品。新商品建档后没入过库inventory 表里根本没有对应行用内连接会漏掉这些最需要补货的商品。正确写法用左连接加空值判断select p.product_no, p.name, p.warn_stock as 预警下限, ifnull(inv.stock_qty, 0) as 当前库存 from product p left join inventory inv on inv.product_id p.id where inv.stock_qty is null or inv.stock_qty p.warn_stock;逻辑说明ifnull 把 null 转成 0让页面展示更友好where 条件里 is null 和 用 or 连接覆盖“从未入库”和“已低于阈值”两类情况。这段 SQL 写好后面做库存预警功能的二次开发就有了核心查询。5. 启动与部署避坑5 个高频翻车现场还原5.1 启动即 ClassNotFoundException缺 jar 包或 JDK 版本太新现象Tomcat 启动到一半catalina.out 里刷出几十条 ClassNotFoundException页面访问直接 404 或 500。原因多半是两个WEB-INF/lib 下的 jar 没有被类加载器扫到或者 JDK 版本太新导致老框架启动失败。解决先用命令确认 lib 下的 jar 数量再检查 IDE 是否把 lib 目录加入了构建路径如果 jar 数量正常把 JDK 换回 1.8 重新跑一遍。老 SSH 项目最怕的不是代码而是 JDK 17 之后的模块化限制CGLIB 代理经常静默失败报错还特别隐蔽。5.2 mysql.sock 连不上localhost 与 TCP 的差异现象命令行执行mysql -uroot -p报ERROR 2002 (HY000): Cant connect to local MySQL server through socket /tmp/mysql.sock。第一次见这个错的人会以为是 MySQL 没装好其实大部分时候是 MySQL 服务根本没启动或者 my.cnf 里 socket 路径改了但客户端还在默认位置找。解决先service mysqld start或mysqld_safe 把服务拉起来如果服务已经在跑但还报错检查 my.cnf 的 socket 配置或者干脆改用 TCP 方式连接mysql -h 127.0.0.1 -P 3306 -uroot -p。Java 项目的 JDBC 驱动走的是 TCP不受 socket 影响这个错主要拦在导入 sql 脚本那一步。5.3 Linux 下表名大小写导致“表不存在”现象在 Windows 上 Navicat 能看到 product 表程序跑得好好的war 包部署到 Linux 后请求商品列表页报Table mall.Product doesnt exist。原因Windows 的 MySQL 默认 lower_case_table_names1 不区分大小写Linux 默认是 0 严格区分脚本里建表是小写 product代码或 Hibernate 映射里却写成了 ProductWindows 帮你兜底Linux 直接翻车。解决查一下建表语句里的表名统一成小写同时检查 hbm.xml 里的 table 属性和 SQL 里的表名全部改成小写。最稳妥的做法是在 MySQL 配置里加lower_case_table_names1但这属于修改数据库行为课设答辩时不一定说得清不如改代码来得干净。5.4 中文乱码“能跑但全是问号”的连锁反应现象页面能打开但商品名称、供应商名字全是问号往数据库插中文后Navicat 里看也是乱码。原因不是单点问题而是三处编码不一致页面 JSP 的 charset、MySQL 连接 URL 的 characterEncoding、数据库表和字段的 charset有一个不对就乱。解决JSP 头部统一pageEncodingUTF-8JDBC URL 加上useUnicodetruecharacterEncodingutf8建表语句统一default charsetutf8mb4。改完这三处后清理浏览器缓存删掉 Tomcat work 目录下的临时文件再重启否则页面里残留的旧 class 编码还会继续捣乱。5.5 数据“写不进去也不报错”事务没提交的假象现象新增商品、保存采购单时页面提示操作成功刷新列表数据却没了后台也不报任何异常。原因大概率是 Spring 事务没生效。检查顺序是applicationContext.xml 里有没有配置事务管理器service 方法上有没有加 Transactional 或事务切面事务管理器有没有被 AOP 切到对应的 service 类。Hibernate 的 flushMode 也要看如果设成 manual数据一直攒在 session 里不落库只有事务提交时才 flush。解决在事务配置正确的前提下故意在 service 方法末尾抛一个 RuntimeException看数据是否回滚能回滚说明事务生效不回滚说明配置是摆设。这是验证事务边界最快的方法比翻日志管用。6. 二次开发演练给商品表加库存预警字段并验证 Hibernate 映射与事务6.1 一条完整链路ALTER TABLE、hbm 映射、页面展示假设要给商品档案增加一个“预警天数”字段用于后续按天算补货周期。这个需求不大但能完整走一遍 SSH 改功能的标准步骤按顺序来alter table product add column warn_days int not null default 7 comment 库存预警天数;第一步是数据库加字段执行完用desc product;确认字段已存在。第二步改实体类在 Product.java 里加一个 warnDays 的 Integer 属性补上 getter/setter。第三步改 Hibernate 映射文件这是老 SSH 项目最容易漏的一步property namewarnDays columnwarn_days typejava.lang.Integer/映射文件里 property 的 name 对应 Java 属性column 对应数据库字段type 用包装类型避免基本类型默认值问题。改完映射JSP 页面的表单加一个输入框列表页加一列展示这个功能就算串起来了。6.2 验证改造生效的三个信号show_sql、预热调用与事务回滚功能改完怎么确认它真的生效第一个信号是启动日志。把 hibernate.show_sql 设为 true启动 Tomcat 后第一次访问商品列表控制台打印的 SQL 里应包含warn_days字段。没有它说明映射文件没改对或改完没重新编译。第二个信号是持久化验证。新建一个商品填上预警天数 7保存后直接查数据库确认值写进去了。第三个信号是回滚验证。故意在保存商品的 Service 方法里抛一个 RuntimeException页面应该报错数据库里不该出现这条商品记录。这套源码真正值钱的地方不在代码写得多漂亮而在它把 SSH 三层拆得足够清楚。我做过一次课设在 Product 实体里加字段忘了改 hbm.xml启动不报错一保存就报“字段不存在”最后一行一行对比映射文件才发现漏了配置。那种对着黑匣子猜问题的感觉特别磨人后来学乖了改字段必过三关数据库字段、Java 属性、hbm 映射少一个都不往下走。这个习惯帮我少加了不少班也希望帮到你。本文还有配套的精品资源点击获取