简介面向Java毕业设计及课程设计学生的SSM物流管理系统完整项目资源包基于SSM架构、MySQL5.7与B/S三层结构开发适用于期末大作业、毕设项目或课程设计的实际场景尤其适合需要快速完成一套可演示后台管理系统的计算机专业学生。资源包约15.91MB内含完整可运行源码含关键注释、万字报告文档、部署说明与答辩PPT覆盖客户信息、物流信息、快递信息、留言信息等后台管理模块具体包含管理员对客户资料的增删改查、物流与快递信息的条件查询和状态维护、用户留言的回复与删除等常见业务操作。源码均经严格测试下载后按部署说明简单配置JDK1.8与Eclipse/IDEA即可运行项目结构清晰、注释规范便于二次开发与功能扩展。目前已有68人学习浏览报告文档亦可作为毕业论文或课程设计报告撰写的核心参考适合需要快速交付完整方案的学生直接使用。1. 基于SSM的物流管理系统部署一次没看版本就动手的翻车实录某开发者接手一套基于ssm架构的物流管理系统java源码准备作为java毕业设计交差。他以为用IDEA打开、点个运行就能看到登录页结果半小时后卡在Tomcat日志里一行ClassNotFoundException: com.mysql.jdbc.Driver。原因很现实这台机器装的是MySQL 8而项目里db.properties写的还是MySQL 5.7那套驱动和连接参数。这种“版本不对就让你白忙一下午”的坑在Java课程设计和Java毕业设计里太常见了。JDK1.8、MySQL5.7、SSM框架这套组合是高校课设项目里出现频率最高的老搭档但正因为老每一步都藏着兼容性问题。这篇文章从环境准备、数据库导入、框架配置到验证跑通按完整流程拆给你看正在做Java课程设计或毕业设计、想直接复用这套系统的人可以照着走。2. 环境准备JDK1.8、MySQL5.7与Tomcat的固定搭配2.1 版本选择为什么这套SSM项目吃定JDK1.8和MySQL5.7SSM是Spring、SpringMVC、MyBatis三个框架的合称。大部分课程设计和毕业设计项目pom.xml里依赖的还是Spring 4.x、MyBatis 3.x这一代它们对JDK的兼容范围基本停在JDK8。换成JDK9以上模块化机制会影响框架的反射调用换成JDK17这种带强封装的高版本MyBatis运行时直接抛IllegalAccessError项目连启动都过不去。数据库那边同样卡版本。MySQL 8默认认证插件是caching_sha2_password而SSM老项目里用的com.mysql.jdbc.Driver驱动只认老式的mysql_native_password。强行连接时最常见的报错是Public Key Retrieval is not allowed你换JDBC连接串、改密码策略都救不回来唯一的省事办法就是把数据库装回5.7。所以拿到一套SSM老项目第一件事不是点运行而是看三个关键文件pom.xml确认依赖版本db.properties确认数据库连接参数部署说明确认JDK和服务器版本要求。这三处全部对上号后面的部署才有意义。2.2 安装JDK1.8并确认JAVA_HOMEJDK1.8的安装包在Oracle存档页能找到下载Windows x64版本安装时记得记下安装路径比如C:\Program Files\Java\jdk1.8.0_202。装完打开命令行验证java -version javac -version echo %JAVA_HOME%如果java -version显示1.8但JAVA_HOME为空说明环境变量没配JAVA_HOME需要指向JDK安装根目录并且把%JAVA_HOME%\bin加到Path变量最前面。java -version和javac -version分别验证JRE和编译器后者缺失会导致IDEA里Maven编译直接失败。我一般还会加一句where java检查系统里是不是存在多个JDK——如果机器上装过其他版本Path列表里靠前的那个会抢先生效这才是很多环境变量配置完仍然报错17、18版本的真凶。2.3 安装MySQL5.7并初始化root密码MySQL 5.7官方下载页放在历史版本存档里选5.7.x的Windows ZIP归档版解压后以管理员身份打开命令行进入bin目录执行mysqld --initialize-insecure mysqld --install MySQL57 net start MySQL57 mysql -uroot--initialize-insecure会创建一个无密码的root用户这是5.7之后推荐的做法老版本用mysql_install_db的方式在5.7里已经废弃。安装为Windows服务后通过net start启动。进入命令行后立刻改密码ALTER USER rootlocalhost IDENTIFIED BY 你的密码; FLUSH PRIVILEGES;如果安装时报缺少MSVCR120.dll那是系统里缺Visual C 2013运行库属于环境依赖问题补装运行库再重新执行就行。值得注意的是5.7的root账号默认只允许localhost登录后续如果要把数据库连接放到其他机器上需要另外授权本地开发则不用管这一条。环境对照参考如下部署前先逐项确认组件推荐版本说明JDK1.8.x必须JDK8高于此版本可能出现框架兼容问题MySQL5.7.x项目驱动与认证插件均按5.7配置Tomcat8.5.x与JDK8和Servlet规范匹配度最好Maven3.6.x与JDK8兼容新版Maven对JDK8支持不稳定IDEIDEA 或 Eclipse两种IDE均可导入见部署说明3. 导入SQL与SSM核心配置四个关键文件决定项目能不能启动3.1 创建数据库并导入物流管理系统的SQL脚本拿到项目压缩包后先翻目录正常情况下会有一个.sql文件名字可能是logistics.sql或db_logistics.sql这就是数据库初始化脚本。用命令行创建数据库再导入比用Navicat直接跑脚本更可控因为字符集可以一并指定mysql -uroot -p -e CREATE DATABASE logistics DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; mysql -uroot -p logistics db_logistics.sql第一句创建数据库时指定utf8mb4字符集物流管理系统里客户姓名、快递地址这类字段难免有生僻字utf8mb4比utf8多覆盖了四字节字符能少一类乱码问题。第二句把SQL脚本导入到logistics库中。导入完成后用mysql -uroot -p -e USE logistics; SHOW TABLES;看一眼表数量如果为空或只有一两张表说明脚本路径不对或导入被报错中断。3.2 db.properties数据库账号、端口、时区怎么配SSM项目里数据库连接信息集中在jdbc.properties或db.properties改动前先备份原文件。打开后通常是这样的结构jdbc.drivercom.mysql.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/logistics?useUnicodetruecharacterEncodingutf8useSSLfalseserverTimezoneAsia/Shanghai jdbc.usernameroot jdbc.password123456jdbc.driver如果是5.7就用com.mysql.jdbc.Driver不要改成MySQL 8的com.mysql.cj.jdbc.Driver除非你同时把驱动jar包升级了。jdbc.url里3306是MySQL默认端口安装时改过端口要同步改这里characterEncodingutf8控制应用到数据库的中文编码useSSLfalse是本地开发常用配置避免SSL握手阶段额外报错serverTimezone必须设置否则连接会报时区无法识别。jdbc.username和jdbc.password换成实际的数据库账号密码注意MySQL 5.7的root密码认证方式要对应上。3.3 applicationContext.xml与spring-mvc.xml数据源、注解扫描与视图解析Spring的配置文件决定整个SSM能不能联动起来。applicationContext.xml里重点看数据源和MyBatis整合部分spring-mvc.xml里重点看Controller扫描和视图解析器前缀后缀。下面是常见的配置片段先对着检查再改context:property-placeholder locationclasspath:db.properties / bean iddataSource classorg.springframework.jdbc.datasource.DriverManagerDataSource property namedriverClassName value${jdbc.driver}/ property nameurl value${jdbc.url}/ property nameusername value${jdbc.username}/ property namepassword value${jdbc.password}/ /bean bean idsqlSessionFactory classorg.mybatis.spring.SqlSessionFactoryBean property namedataSource refdataSource/ property namemapperLocations valueclasspath:mapper/*.xml/ /beancontext:component-scan base-packagecom.logistics.controller/ bean classorg.springframework.web.servlet.view.InternalResourceViewResolver property nameprefix value/WEB-INF/jsp// property namesuffix value.jsp/ /beancontext:property-placeholder把db.properties里的占位符解析成实际值${jdbc.url}写错一个字符启动日志只会提示数据库连接失败不会告诉你哪里拼错了。mapperLocations指定XML映射文件路径如果项目里Mapper接口和XML不是同名同包这里需要确认base-package必须扫到Controller实际所在的包包名写错的结果是页面404且Tomcat日志没有任何报错。视图解析器的prefix是JSP所在目录suffix是扩展名前后缀配置后return index会拼成/WEB-INF/jsp/index.jsp不少404就是前后缀和实际目录不一致造成的。如果数据源用的是Druid配置结构会多一个DruidDataSource的初始化参数块但核心的url、username、password三样不变。检查原则是先确保db.properties里的四要素正确再确认XML占位符没拼错最后看mapper扫描路径这三层都对齐项目基本就具备了启动条件。4. 用IDEA跑通项目从导入到Tomcat启动4.1 导入Maven工程三种方式里选对那一种这套SSM项目的源码结构通常有两种形态一种是完整Maven项目带pom.xml一种是把jar包放进WEB-INF/lib的传统Web工程。IDEA导入方式不同后果也不同。最稳妥的做法是在IDEA欢迎页选择Open直接定位到项目根目录IDEA检测到pom.xml会自动识别为Maven项目并下载依赖。如果下载依赖时卡住多半是国内网络访问Maven中央仓库慢这时候去settings.xml里配阿里云镜像mirror idaliyun/id mirrorOfcentral/mirrorOf urlhttps://maven.aliyun.com/repository/central/url /mirror我这里习惯把mirrorOf写成central只对中央仓库走镜像不干扰其他私有仓库配置。配完镜像后重新导入一次看到右侧Maven面板里依赖列表不再报红说明这一步过了。依赖下载完成后先执行一次mvn clean compile确认源码能编译通过再继续配置Tomcat这一步能提前暴露JDK版本不匹配和依赖缺失问题。4.2 配置Tomcat运行环境与DeploymentIDEA里点Run - Edit Configurations左上角加号选Tomcat Server - Local然后在Application server里选择Tomcat 8.5的安装目录。关键点在Deployment标签页要把项目打包成war包挂到Tomcat上点击Deployment下的加号选Artifact再选择项目名的war exploded。war exploded表示解压目录模式IDEA会把编译后的class和资源文件直接发布到Tomcat支持热更新调试JSP的时候不用反复重启Tomcat。不建议选war包模式每次改Java代码都要重新打包开发效率太低。启动前在Server标签页留意Open browser后面的URL它由端口和Application context两部分组成。项目如果没显式设置context path部署进去的路径就是根路径/如果部署说明里写了context path比如项目名则需要改成/项目名。这里填错浏览器打开的地址就是错的。4.3 启动后URL路径context path写错就404启动Tomcat后控制台日志会输出访问地址比如Using CATALINA_BASE: C:\Users\xxx\.intellij_2019\system\tomcat\Tomcat_8_5_xxx 信息 [main] org.apache.catalina.startup.Catalina.start Server startup in 812 ms看到Server startup in xxx ms才算启动成功然后手动在浏览器访问完整地址。以下是一份可直接照抄的参数参考参数配置位置常见错误context pathIDEA Deployment标签页多写一层目录导致404端口默认8080Tomcat配置被其他程序占用时选择8081启动前Maven编译Maven面板跳过compile导致class缺失第一次启动如果浏览器打开的是默认Tomcat首页而不是登录页不要慌把URL改成http://localhost:8080/项目context/再试。端口访问不通时优先检查Tomcat控制台有没有端口被占用的红字日志而不是改代码。5. 部署避坑数据库连不上、404、乱码的排查手册5.1 数据库连接失败Access denied 与 Public Key Retrieval 两条高频报错现象Tomcat启动时报Access denied for user rootlocalhost (using password: YES)或者Public Key Retrieval is not allowed。前者是密码不匹配原因多半是db.properties里的密码和MySQL实际密码不一致或者密码里带了特殊字符没有转义。解决先到MySQL命令行用root登录执行ALTER USER重置为简单密码再同步到db.properties里也可以在MySQL里新建一个专用账号单独授权给logistics库。后者是版本错配MySQL 8的服务端用了新认证插件老驱动无法完成公钥交换。解决换MySQL 5.7的服务器或者把驱动和连接串都升级到MySQL 8配套写法——但考虑到整套项目是按5.7配置的我建议直接换数据库版本别在驱动上折腾。5.2 页面404Context Path、视图前缀、注解扫描三个方向现象Tomcat启动成功登录页显示404但Tomcat首页能打开。第一反应不是看代码而是看浏览器地址栏的context path对不对。IDEA里Application context配的是/logistics访问时就该写http://localhost:8080/logistics/。如果路径对还404去IDEA控制台看有没有No mapping found for HTTP request出现这句说明Controller没被扫描到检查spring-mvc.xml里的base-package以及Controller类上有没有Controller注解。还有一种情况是视图解析器前缀配的WEB-INF/jsp/而JSP实际在/web/WEB-INF/pages/前后缀不匹配时页面同样404但日志里不会报任何Java异常。5.3 中文字符乱码三处编码要一致现象登录进去后客户姓名、快递地址里的中文全部显示成问号或乱码。乱码是一个经典的链式问题请求到Tomcat、Tomcat到数据库、数据库到页面任何一环编码不一致都会出乱码。快速检查路径是先确认MySQL数据库和表是utf8mb4不是latin1再确认db.properties里characterEncodingutf8最后确认JSP页面每个文件头部都有pageEncodingUTF-8。三个位置全部对齐后重新启动Tomcat再测试。注意修改数据库字符集后要重启MySQL服务单纯改表结构不生效的情况我碰到过不止一次。5.4 端口被占用与内存溢出启动失败的另外两类原因现象Tomcat启动到一半报Port 8080 was already in use或者项目启动后操作了几个页面就报java.lang.OutOfMemoryError: PermGen space。端口占用最常见谁的机器上都有几个不死的Java进程。Windows下用netstat -ano | findstr 8080查出占用进程PID任务管理器结束对应进程完事——如果是别的Tomcat占着建议留着自己在IDEA里把端口改成8081。PermGen空间是JDK8及以前的典型问题解决方式是在Tomcat启动参数里加-XX:PermSize128M -XX:MaxPermSize256M同时把IDEA的VM options里的-Xmx改为至少512M。这两个参数不是优化项是保命项加完一般就不会再碰到内存溢出了。症状排查方向常见原因Access denieddb.properties密码密码不一致或特殊字符未转义Public Key RetrievalMySQL版本服务端MySQL 8与老驱动不兼容页面404无日志Spring扫描与视图解析base-package或prefix拼写错误中文问号字符集链三处编码未统一为UTF-8端口占用netstat残留Java进程占用8080内存溢出Tomcat启动参数PermSize设置过小6. 装完怎么验证管理员四模块全流程走查6.1 登录并核对首页菜单部署完成的第一件事不是直接点菜单而是核对登录身份。使用系统管理员账号登录观察首页左侧菜单是否完整展示四类功能客户信息管理、物流信息管理、快递信息管理、留言信息管理。四缺一的情况下优先怀疑模块权限配置或导航栏缓存强制刷新页面后若仍然缺失检查Controller层有没有被拦截器拦截掉部分请求。6.2 快递信息新增、检索、修改、作废的CRUD闭环登录之后选择快递信息管理模块按顺序完成一组CRUD操作新增一条快递记录单号建议用一个能记住的测试值比如K20240601保存后在查询区按快递单号检索确认记录能查出来修改该记录的快递状态从“待揽收”改为“运输中”保存后重新查询确认变更生效最后把这条测试记录标记作废再查询确认状态已被更新。这一套走完系统核心逻辑基本得到验证。客户信息管理部分測试新增一个客户后修改其联系方式再删除该客户物流信息管理部分发布一条物流信息再执行作废留言信息管理部分给一条用户留言写回复确认回复时间被写入。每一组操作都回到列表页刷新确认不要只看跳转提示成功就直接关掉。验证通过后清理测试期间产生的假数据保留库内数据干净提交给答辩或演示时就不会露怯。6.3 一份可以直接抄的“验证通过”清单下面这份清单是我每次装完SSM项目强制走一遍的流程照着敲一遍就够了# 1. 确认服务全部启动 netstat -ano | findstr :8080 netstat -ano | findstr :3306 # 2. 确认数据库表就位 mysql -uroot -p -e USE logistics; SHOW TABLES; # 3. 确认登录跳转 curl -I http://localhost:8080/logistics/login.jsp第一条命令同时看到8080和3306端口处于监听状态说明Tomcat和MySQL都在线第二条命令看到表清单说明SQL导入完整第三条命令返回HTTP/1.1 200说明Web应用可访问。三条全过这套SSM物流管理系统才算真正部署成功。自从有一次在答辩现场发现客户信息列表是空的才知道生产前没验证数据渲染的尴尬从那以后每次装完环境都强制把四模块的CRUD走一遍再收工。希望这套流程也能帮到你省去现场翻车的风险。本文还有配套的精品资源点击获取 
长河君 · 2026/10/18 10:32:27 · 阅读 1.2k SSM物流管理系统部署全流程：JDK1.8+MySQL5.7版本匹配避坑指南
简介面向Java毕业设计及课程设计学生的SSM物流管理系统完整项目资源包基于SSM架构、MySQL5.7与B/S三层结构开发适用于期末大作业、毕设项目或课程设计的实际场景尤其适合需要快速完成一套可演示后台管理系统的计算机专业学生。资源包约15.91MB内含完整可运行源码含关键注释、万字报告文档、部署说明与答辩PPT覆盖客户信息、物流信息、快递信息、留言信息等后台管理模块具体包含管理员对客户资料的增删改查、物流与快递信息的条件查询和状态维护、用户留言的回复与删除等常见业务操作。源码均经严格测试下载后按部署说明简单配置JDK1.8与Eclipse/IDEA即可运行项目结构清晰、注释规范便于二次开发与功能扩展。目前已有68人学习浏览报告文档亦可作为毕业论文或课程设计报告撰写的核心参考适合需要快速交付完整方案的学生直接使用。1. 基于SSM的物流管理系统部署一次没看版本就动手的翻车实录某开发者接手一套基于ssm架构的物流管理系统java源码准备作为java毕业设计交差。他以为用IDEA打开、点个运行就能看到登录页结果半小时后卡在Tomcat日志里一行ClassNotFoundException: com.mysql.jdbc.Driver。原因很现实这台机器装的是MySQL 8而项目里db.properties写的还是MySQL 5.7那套驱动和连接参数。这种“版本不对就让你白忙一下午”的坑在Java课程设计和Java毕业设计里太常见了。JDK1.8、MySQL5.7、SSM框架这套组合是高校课设项目里出现频率最高的老搭档但正因为老每一步都藏着兼容性问题。这篇文章从环境准备、数据库导入、框架配置到验证跑通按完整流程拆给你看正在做Java课程设计或毕业设计、想直接复用这套系统的人可以照着走。2. 环境准备JDK1.8、MySQL5.7与Tomcat的固定搭配2.1 版本选择为什么这套SSM项目吃定JDK1.8和MySQL5.7SSM是Spring、SpringMVC、MyBatis三个框架的合称。大部分课程设计和毕业设计项目pom.xml里依赖的还是Spring 4.x、MyBatis 3.x这一代它们对JDK的兼容范围基本停在JDK8。换成JDK9以上模块化机制会影响框架的反射调用换成JDK17这种带强封装的高版本MyBatis运行时直接抛IllegalAccessError项目连启动都过不去。数据库那边同样卡版本。MySQL 8默认认证插件是caching_sha2_password而SSM老项目里用的com.mysql.jdbc.Driver驱动只认老式的mysql_native_password。强行连接时最常见的报错是Public Key Retrieval is not allowed你换JDBC连接串、改密码策略都救不回来唯一的省事办法就是把数据库装回5.7。所以拿到一套SSM老项目第一件事不是点运行而是看三个关键文件pom.xml确认依赖版本db.properties确认数据库连接参数部署说明确认JDK和服务器版本要求。这三处全部对上号后面的部署才有意义。2.2 安装JDK1.8并确认JAVA_HOMEJDK1.8的安装包在Oracle存档页能找到下载Windows x64版本安装时记得记下安装路径比如C:\Program Files\Java\jdk1.8.0_202。装完打开命令行验证java -version javac -version echo %JAVA_HOME%如果java -version显示1.8但JAVA_HOME为空说明环境变量没配JAVA_HOME需要指向JDK安装根目录并且把%JAVA_HOME%\bin加到Path变量最前面。java -version和javac -version分别验证JRE和编译器后者缺失会导致IDEA里Maven编译直接失败。我一般还会加一句where java检查系统里是不是存在多个JDK——如果机器上装过其他版本Path列表里靠前的那个会抢先生效这才是很多环境变量配置完仍然报错17、18版本的真凶。2.3 安装MySQL5.7并初始化root密码MySQL 5.7官方下载页放在历史版本存档里选5.7.x的Windows ZIP归档版解压后以管理员身份打开命令行进入bin目录执行mysqld --initialize-insecure mysqld --install MySQL57 net start MySQL57 mysql -uroot--initialize-insecure会创建一个无密码的root用户这是5.7之后推荐的做法老版本用mysql_install_db的方式在5.7里已经废弃。安装为Windows服务后通过net start启动。进入命令行后立刻改密码ALTER USER rootlocalhost IDENTIFIED BY 你的密码; FLUSH PRIVILEGES;如果安装时报缺少MSVCR120.dll那是系统里缺Visual C 2013运行库属于环境依赖问题补装运行库再重新执行就行。值得注意的是5.7的root账号默认只允许localhost登录后续如果要把数据库连接放到其他机器上需要另外授权本地开发则不用管这一条。环境对照参考如下部署前先逐项确认组件推荐版本说明JDK1.8.x必须JDK8高于此版本可能出现框架兼容问题MySQL5.7.x项目驱动与认证插件均按5.7配置Tomcat8.5.x与JDK8和Servlet规范匹配度最好Maven3.6.x与JDK8兼容新版Maven对JDK8支持不稳定IDEIDEA 或 Eclipse两种IDE均可导入见部署说明3. 导入SQL与SSM核心配置四个关键文件决定项目能不能启动3.1 创建数据库并导入物流管理系统的SQL脚本拿到项目压缩包后先翻目录正常情况下会有一个.sql文件名字可能是logistics.sql或db_logistics.sql这就是数据库初始化脚本。用命令行创建数据库再导入比用Navicat直接跑脚本更可控因为字符集可以一并指定mysql -uroot -p -e CREATE DATABASE logistics DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; mysql -uroot -p logistics db_logistics.sql第一句创建数据库时指定utf8mb4字符集物流管理系统里客户姓名、快递地址这类字段难免有生僻字utf8mb4比utf8多覆盖了四字节字符能少一类乱码问题。第二句把SQL脚本导入到logistics库中。导入完成后用mysql -uroot -p -e USE logistics; SHOW TABLES;看一眼表数量如果为空或只有一两张表说明脚本路径不对或导入被报错中断。3.2 db.properties数据库账号、端口、时区怎么配SSM项目里数据库连接信息集中在jdbc.properties或db.properties改动前先备份原文件。打开后通常是这样的结构jdbc.drivercom.mysql.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/logistics?useUnicodetruecharacterEncodingutf8useSSLfalseserverTimezoneAsia/Shanghai jdbc.usernameroot jdbc.password123456jdbc.driver如果是5.7就用com.mysql.jdbc.Driver不要改成MySQL 8的com.mysql.cj.jdbc.Driver除非你同时把驱动jar包升级了。jdbc.url里3306是MySQL默认端口安装时改过端口要同步改这里characterEncodingutf8控制应用到数据库的中文编码useSSLfalse是本地开发常用配置避免SSL握手阶段额外报错serverTimezone必须设置否则连接会报时区无法识别。jdbc.username和jdbc.password换成实际的数据库账号密码注意MySQL 5.7的root密码认证方式要对应上。3.3 applicationContext.xml与spring-mvc.xml数据源、注解扫描与视图解析Spring的配置文件决定整个SSM能不能联动起来。applicationContext.xml里重点看数据源和MyBatis整合部分spring-mvc.xml里重点看Controller扫描和视图解析器前缀后缀。下面是常见的配置片段先对着检查再改context:property-placeholder locationclasspath:db.properties / bean iddataSource classorg.springframework.jdbc.datasource.DriverManagerDataSource property namedriverClassName value${jdbc.driver}/ property nameurl value${jdbc.url}/ property nameusername value${jdbc.username}/ property namepassword value${jdbc.password}/ /bean bean idsqlSessionFactory classorg.mybatis.spring.SqlSessionFactoryBean property namedataSource refdataSource/ property namemapperLocations valueclasspath:mapper/*.xml/ /beancontext:component-scan base-packagecom.logistics.controller/ bean classorg.springframework.web.servlet.view.InternalResourceViewResolver property nameprefix value/WEB-INF/jsp// property namesuffix value.jsp/ /beancontext:property-placeholder把db.properties里的占位符解析成实际值${jdbc.url}写错一个字符启动日志只会提示数据库连接失败不会告诉你哪里拼错了。mapperLocations指定XML映射文件路径如果项目里Mapper接口和XML不是同名同包这里需要确认base-package必须扫到Controller实际所在的包包名写错的结果是页面404且Tomcat日志没有任何报错。视图解析器的prefix是JSP所在目录suffix是扩展名前后缀配置后return index会拼成/WEB-INF/jsp/index.jsp不少404就是前后缀和实际目录不一致造成的。如果数据源用的是Druid配置结构会多一个DruidDataSource的初始化参数块但核心的url、username、password三样不变。检查原则是先确保db.properties里的四要素正确再确认XML占位符没拼错最后看mapper扫描路径这三层都对齐项目基本就具备了启动条件。4. 用IDEA跑通项目从导入到Tomcat启动4.1 导入Maven工程三种方式里选对那一种这套SSM项目的源码结构通常有两种形态一种是完整Maven项目带pom.xml一种是把jar包放进WEB-INF/lib的传统Web工程。IDEA导入方式不同后果也不同。最稳妥的做法是在IDEA欢迎页选择Open直接定位到项目根目录IDEA检测到pom.xml会自动识别为Maven项目并下载依赖。如果下载依赖时卡住多半是国内网络访问Maven中央仓库慢这时候去settings.xml里配阿里云镜像mirror idaliyun/id mirrorOfcentral/mirrorOf urlhttps://maven.aliyun.com/repository/central/url /mirror我这里习惯把mirrorOf写成central只对中央仓库走镜像不干扰其他私有仓库配置。配完镜像后重新导入一次看到右侧Maven面板里依赖列表不再报红说明这一步过了。依赖下载完成后先执行一次mvn clean compile确认源码能编译通过再继续配置Tomcat这一步能提前暴露JDK版本不匹配和依赖缺失问题。4.2 配置Tomcat运行环境与DeploymentIDEA里点Run - Edit Configurations左上角加号选Tomcat Server - Local然后在Application server里选择Tomcat 8.5的安装目录。关键点在Deployment标签页要把项目打包成war包挂到Tomcat上点击Deployment下的加号选Artifact再选择项目名的war exploded。war exploded表示解压目录模式IDEA会把编译后的class和资源文件直接发布到Tomcat支持热更新调试JSP的时候不用反复重启Tomcat。不建议选war包模式每次改Java代码都要重新打包开发效率太低。启动前在Server标签页留意Open browser后面的URL它由端口和Application context两部分组成。项目如果没显式设置context path部署进去的路径就是根路径/如果部署说明里写了context path比如项目名则需要改成/项目名。这里填错浏览器打开的地址就是错的。4.3 启动后URL路径context path写错就404启动Tomcat后控制台日志会输出访问地址比如Using CATALINA_BASE: C:\Users\xxx\.intellij_2019\system\tomcat\Tomcat_8_5_xxx 信息 [main] org.apache.catalina.startup.Catalina.start Server startup in 812 ms看到Server startup in xxx ms才算启动成功然后手动在浏览器访问完整地址。以下是一份可直接照抄的参数参考参数配置位置常见错误context pathIDEA Deployment标签页多写一层目录导致404端口默认8080Tomcat配置被其他程序占用时选择8081启动前Maven编译Maven面板跳过compile导致class缺失第一次启动如果浏览器打开的是默认Tomcat首页而不是登录页不要慌把URL改成http://localhost:8080/项目context/再试。端口访问不通时优先检查Tomcat控制台有没有端口被占用的红字日志而不是改代码。5. 部署避坑数据库连不上、404、乱码的排查手册5.1 数据库连接失败Access denied 与 Public Key Retrieval 两条高频报错现象Tomcat启动时报Access denied for user rootlocalhost (using password: YES)或者Public Key Retrieval is not allowed。前者是密码不匹配原因多半是db.properties里的密码和MySQL实际密码不一致或者密码里带了特殊字符没有转义。解决先到MySQL命令行用root登录执行ALTER USER重置为简单密码再同步到db.properties里也可以在MySQL里新建一个专用账号单独授权给logistics库。后者是版本错配MySQL 8的服务端用了新认证插件老驱动无法完成公钥交换。解决换MySQL 5.7的服务器或者把驱动和连接串都升级到MySQL 8配套写法——但考虑到整套项目是按5.7配置的我建议直接换数据库版本别在驱动上折腾。5.2 页面404Context Path、视图前缀、注解扫描三个方向现象Tomcat启动成功登录页显示404但Tomcat首页能打开。第一反应不是看代码而是看浏览器地址栏的context path对不对。IDEA里Application context配的是/logistics访问时就该写http://localhost:8080/logistics/。如果路径对还404去IDEA控制台看有没有No mapping found for HTTP request出现这句说明Controller没被扫描到检查spring-mvc.xml里的base-package以及Controller类上有没有Controller注解。还有一种情况是视图解析器前缀配的WEB-INF/jsp/而JSP实际在/web/WEB-INF/pages/前后缀不匹配时页面同样404但日志里不会报任何Java异常。5.3 中文字符乱码三处编码要一致现象登录进去后客户姓名、快递地址里的中文全部显示成问号或乱码。乱码是一个经典的链式问题请求到Tomcat、Tomcat到数据库、数据库到页面任何一环编码不一致都会出乱码。快速检查路径是先确认MySQL数据库和表是utf8mb4不是latin1再确认db.properties里characterEncodingutf8最后确认JSP页面每个文件头部都有pageEncodingUTF-8。三个位置全部对齐后重新启动Tomcat再测试。注意修改数据库字符集后要重启MySQL服务单纯改表结构不生效的情况我碰到过不止一次。5.4 端口被占用与内存溢出启动失败的另外两类原因现象Tomcat启动到一半报Port 8080 was already in use或者项目启动后操作了几个页面就报java.lang.OutOfMemoryError: PermGen space。端口占用最常见谁的机器上都有几个不死的Java进程。Windows下用netstat -ano | findstr 8080查出占用进程PID任务管理器结束对应进程完事——如果是别的Tomcat占着建议留着自己在IDEA里把端口改成8081。PermGen空间是JDK8及以前的典型问题解决方式是在Tomcat启动参数里加-XX:PermSize128M -XX:MaxPermSize256M同时把IDEA的VM options里的-Xmx改为至少512M。这两个参数不是优化项是保命项加完一般就不会再碰到内存溢出了。症状排查方向常见原因Access denieddb.properties密码密码不一致或特殊字符未转义Public Key RetrievalMySQL版本服务端MySQL 8与老驱动不兼容页面404无日志Spring扫描与视图解析base-package或prefix拼写错误中文问号字符集链三处编码未统一为UTF-8端口占用netstat残留Java进程占用8080内存溢出Tomcat启动参数PermSize设置过小6. 装完怎么验证管理员四模块全流程走查6.1 登录并核对首页菜单部署完成的第一件事不是直接点菜单而是核对登录身份。使用系统管理员账号登录观察首页左侧菜单是否完整展示四类功能客户信息管理、物流信息管理、快递信息管理、留言信息管理。四缺一的情况下优先怀疑模块权限配置或导航栏缓存强制刷新页面后若仍然缺失检查Controller层有没有被拦截器拦截掉部分请求。6.2 快递信息新增、检索、修改、作废的CRUD闭环登录之后选择快递信息管理模块按顺序完成一组CRUD操作新增一条快递记录单号建议用一个能记住的测试值比如K20240601保存后在查询区按快递单号检索确认记录能查出来修改该记录的快递状态从“待揽收”改为“运输中”保存后重新查询确认变更生效最后把这条测试记录标记作废再查询确认状态已被更新。这一套走完系统核心逻辑基本得到验证。客户信息管理部分測试新增一个客户后修改其联系方式再删除该客户物流信息管理部分发布一条物流信息再执行作废留言信息管理部分给一条用户留言写回复确认回复时间被写入。每一组操作都回到列表页刷新确认不要只看跳转提示成功就直接关掉。验证通过后清理测试期间产生的假数据保留库内数据干净提交给答辩或演示时就不会露怯。6.3 一份可以直接抄的“验证通过”清单下面这份清单是我每次装完SSM项目强制走一遍的流程照着敲一遍就够了# 1. 确认服务全部启动 netstat -ano | findstr :8080 netstat -ano | findstr :3306 # 2. 确认数据库表就位 mysql -uroot -p -e USE logistics; SHOW TABLES; # 3. 确认登录跳转 curl -I http://localhost:8080/logistics/login.jsp第一条命令同时看到8080和3306端口处于监听状态说明Tomcat和MySQL都在线第二条命令看到表清单说明SQL导入完整第三条命令返回HTTP/1.1 200说明Web应用可访问。三条全过这套SSM物流管理系统才算真正部署成功。自从有一次在答辩现场发现客户信息列表是空的才知道生产前没验证数据渲染的尴尬从那以后每次装完环境都强制把四模块的CRUD走一遍再收工。希望这套流程也能帮到你省去现场翻车的风险。本文还有配套的精品资源点击获取