简介基于IDEAMavenSSM框架实现的超市管理系统是一份面向Java学习者、毕业设计及期末大作业的完整项目源码。系统围绕超市日常经营管理设计了用户管理、供应商管理、订单管理、账单管理等核心功能模块采用JSPServletSpringSpringMVCMyBatis经典技术栈包含登录验证、增删改查、分页搜索等典型业务场景前后端交互与分层架构清晰可帮助读者理解SSM整合流程、Spring容器管理、MyBatis映射及事务处理等关键知识点。压缩包共335个文件主要包含Java后端源码、JSP视图页面、XML与properties配置文件、JavaScript与CSS前端脚本以及项目所需的JAR依赖库和运行日志等整体大小约29.28MB目录按功能模块组织便于按需查阅。目前已有174人学习浏览适合用来对照练习、二次开发也可作为课程设计或求职作品的基础模板。1. 一个 .zip 里藏着的 SSM 超市管理系统导入前先看清三件事拿到一个名为IDEAMAVENSSM框架 超市管理系统.zip的压缩包先看目录结构。里面通常有pom.xml、src/main/java、src/main/resources和一份.sql脚本说明是标准 Maven 工程。这个标题把技术栈列齐了IDEA 负责开发调试Maven 管依赖和构建SSM 由 Spring、Spring MVC、MyBatis 三层组成业务围绕超市的商品、库存、订单展开。要做的就是让这套超市管理系统在本地 IDEA 里跑起来涵盖 Maven 环境配置、SSM 依赖整合、数据库初始化和请求链路调试。课程设计、毕业设计或老项目维护场景下都能用这套思路。2. 导入前先定好地基Maven 环境配置与 IDEA 侧绑定2.1 先理清 Maven 是干嘛的坐标、仓库与依赖管理Maven 解决的并不只是“自动下载 jar”而是把 SSM 三件套的版本关系和传递依赖统一收编到pom.xml。没有 Maven 时你要手工整理 spring-core、spring-webmvc、mybatis、mybatis-spring、mysql-connector-java 这一串 jar还要自己去适配版本组合一旦某个 jar 的传递依赖覆盖了另一个 jar 里的类错误往往要等 Tomcat 启动时才以ClassNotFoundException的形式爆发。Maven 的核心机制可以拆成三个词坐标、仓库、生命周期。坐标用groupId:artifactId:version唯一定位依赖仓库分本地仓库和远程仓库坐标写好后 Maven 先查本地仓库没有再去远程下载生命周期负责编译、测试、打包这串动作。很多人搜索“maven是干嘛的”本质上就是没搞清这三个词之间的关系把 Maven 误当成一种“能下载 jar 的插件”。SSM 项目的依赖管理还牵扯到容器粒度。Spring 的 jar 如果出现 4.x 和 5.x 并存Spring MVC 的DispatcherServlet和 Spring 根容器会各自加载一份 Class导致 AOP 注解不生效。Maven 里的properties和dependencyManagement就是为了在根 POM 锁住版本让每个dependency都继承同一个版本号。2.2 用 settings.xml 配置阿里云镜像与本地仓库路径settings.xml是 Maven 的全局配置文件开发机上的所有项目都会读它。我一般会把默认的conf/settings.xml复制到~/.m2/settings.xml避免升级 Maven 时配置被覆盖。这个文件里有两个地方最值得先改本地仓库路径和远程镜像。尤其在国内网络下从中央仓库拉 Spring 依赖经常卡到 10 分钟以上换阿里云镜像后能压缩到 1 分钟内。!-- 位于用户主目录下的 .m2/settings.xml所有 Maven 项目全局生效 -- settings xmlnshttp://maven.apache.org/SETTINGS/1.0.0 xmlns:xsihttp://www.w3.org/2001/XMLSchema-instance xsi:schemaLocationhttp://maven.apache.org/SETTINGS/1.0.0 https://maven.apache.org/xsd/settings-1.0.0.xsd !-- 本地仓库优先放在数据盘避免系统盘重装后依赖全部失效 -- localRepositoryD:/repo/maven_repo/localRepository mirrors mirror !-- id 不能与仓库 id 重复否则会报 conflict -- idaliyun-central/id nameAliyun Central/name urlhttps://maven.aliyun.com/repository/public/url !-- 只镜像 central 仓库保留第三方仓库直连能力 -- mirrorOfcentral/mirrorOf /mirror /mirrors /settings这段配置里localRepository决定了依赖最终落在哪个目录。mirrorOf的取值很讲究写central时只有中央仓库走镜像写*时所有远程仓库都走这一个地址会连带把某些私有 Maven 仓库地址也替换掉。对 SSM 项目来说只镜像central就够了Spring、MyBatis、MySQL 驱动都在 Aliyun 的 public 仓库里。配置项示例值说明localRepositoryD:/repo/maven_repo全局依赖缓存地址路径中避免中文和空格mirror.idaliyun-central唯一标识与仓库 id 相同会解析失败mirrorOfcentral*会拦截全部仓库导致私有源不可用mirror.urlmaven.aliyun.com/repository/publicpublic 聚合了常用中央依赖2.3 在 IDEA 里把 Maven 绑定到本地并执行一次编译验证配置完 settings.xml还要让 IDEA 读到这份文件否则 IDEA 会用内置 Maven 构建和命令行mvn的行为不一致。打开 IDEA 的File Settings Build, Execution, Deployment Build Tools Maven分别设置 Maven home path、User settings file、Local repository。Maven home path 指向本地安装的 Apache Maven 目录不建议选 IDEA 自带的 bundled Maven版本可能滞后。User settings file 勾选 Override 后填入~/.m2/settings.xml。Local repository 勾选 Override 后填入D:/repo/maven_repo。点击 Maven 工具窗口的刷新按钮触发一次 reimport。# 命令行验证 Maven 环境 mvn -v # 只编译不打包验证 SSM 项目依赖是否全部就绪 mvn clean compile -Umvn -v会打印 Maven 版本和 Java 版本JDK 版本不一致时Spring 5 编译会报invalid target release。mvn clean compile只做编译不会生成可部署的 war因此是导入阶段最安全的验证命令。-U强制检查远程仓库更新适合刚切换镜像后的依赖补拉。提示Maven 下载失败时不要反复删仓库。先看本地仓库里有没有.lastUpdated后缀文件有就说明镜像地址或网络有问题优先检查 settings.xml。3. SSM 框架整合的依赖核心与三层配置版本冲突先死在这里3.1 从 pom.xml 看 SSM 依赖版本属性和三组核心坐标先从pom.xml里看 SSM 项目的最小依赖集合。Spring 与 Spring MVC 都在org.springframework.*下MyBatis 是独立坐标org.mybatis。注意要额外引入spring-jdbc没有它拿不到DataSourceTransactionManagerTransactional会静默失效。!-- pom.xml 的核心依赖片段版本号用属性统一管理 -- properties !-- 5.3.x 是适配 JDK 8 到 17 的常用区间 -- spring.version5.3.x/spring.version mybatis.version3.5.x/mybatis.version /properties dependencies dependency groupIdorg.springframework/groupId artifactIdspring-webmvc/artifactId version${spring.version}/version /dependency dependency groupIdorg.springframework/groupId artifactIdspring-jdbc/artifactId version${spring.version}/version /dependency dependency groupIdorg.mybatis/groupId artifactIdmybatis/artifactId version${mybatis.version}/version /dependency dependency groupIdorg.mybatis/groupId artifactIdmybatis-spring/artifactId version2.1.x/version /dependency dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId version8.0.x/version /dependency /dependencies用${spring.version}这类属性能让所有 Spring 相关依赖保持同一版本避免出现“容器 jar 是 5.0、webmvc 是 5.3”的半新不旧组合。mybatis-spring是 MyBatis 和 Spring 之间的桥接包负责把SqlSessionFactory交给 Spring 容器管理它和 Spring 版本有对应关系2.1.x 配 Spring 5.3.x 很常见。mysql-connector-java高版本驱动类名是com.mysql.cj.jdbc.Driver如果从旧项目拷贝依赖只改了版本号没改驱动类名连数据库时直接报ClassNotFoundException。依赖坐标配套关系常见坑spring-webmvc与 spring-jdbc 版本一致多版本 jar 并存会报 NoClassDefFoundErrormybatis-spring2.x 适配 Spring 5版本不匹配时 Mapper 扫描无声失败mysql-connector-java8.0.x 驱动类带 cj旧驱动类 com.mysql.jdbc.Driver 抛异常javax.servlet-api应在 pom 里配置 provided不打进 war否则与 Tomcat 冲突3.2 用 applicationContext.xml 把数据源、Mapper 和事务绑定在一起SSM 整合通常拆成多个配置文件分别管理根容器、MVC 子容器和 MyBatis 会话工厂。最常见的误配是根容器把 Controller 也扫了造成事务在 Controller 上不生效或者Autowired出现循环依赖。!-- applicationContext.xml根上下文管理数据源、事务、DAO、Service -- context:component-scan base-packagecom.supermarket !-- Controller 组件交给 spring-mvc.xml 扫描 -- context:exclude-filter typeannotation expressionorg.springframework.stereotype.Controller/ /context:component-scan bean iddataSource classcom.alibaba.druid.pool.DruidDataSource init-methodinit destroy-methodclose property namedriverClassName valuecom.mysql.cj.jdbc.Driver/ property nameurl valuejdbc:mysql://localhost:3306/supermarket?useUnicodetrueamp;characterEncodingutf8amp;serverTimezoneAsia/Shanghai/ property nameusername valueroot/ property namepassword value123456/ property namemaxActive value20/ property nameinitialSize value5/ /bean bean idsqlSessionFactory classorg.mybatis.spring.SqlSessionFactoryBean property namedataSource refdataSource/ property namemapperLocations valueclasspath:mapper/*.xml/ /bean bean classorg.mybatis.spring.mapper.MapperScannerConfigurer property namebasePackage valuecom.supermarket.dao/ /beancontext:component-scan用 exclude-filter 排除 Controller是 SSM 整合的关键设置。数据源 url 里的useUnicode和characterEncoding决定中文是否乱码serverTimezone不写时 MySQL 8 启动时大概率报时区异常。SqlSessionFactoryBean的mapperLocations指向 XML Mapper如果压缩包里没有mapper目录而是注解式 SQL就要去掉这行。MapperScannerConfigurer会把com.supermarket.dao包下的所有接口动态生成代理对象放进 Spring 容器。配置文件扫描范围主要职责applicationContext.xmlservice、dao、数据源事务、AOP、业务 Beanspring-mvc.xmlcontroller、视图解析器、静态资源HandlerMapping、JSON 转换mybatis-config.xml全局设置非必须驼峰映射、日志实现3.3 拿到现成压缩包后如何快速判断 SSM 版本组合是否可用拿到陌生人给的 zip 包我一般先做三件事第一看pom.xml里的版本区间和当前 JDK 是否匹配第二看 Mapper XML 中的 SQL 写法和数据库列是否对得上第三执行依赖树命令确认没有解析出多个 Spring 版本。# 只看 spring 相关依赖检查是否存在版本冲突 mvn dependency:tree -Dincludesorg.springframework如果dependency:tree结果里出现两个不同版本的spring-core说明某个间接依赖强行传递了旧版本要在对应依赖里用exclusions排除旧包。这个命令同样适用于mysql-connector-java可以帮你快速判断是 pom 里的版本覆盖失败还是镜像仓库里根本没有对应版本。4. 超市管理系统跑通的最小闭环初始化数据库、启动 Tomcat 并核对请求链路4.1 执行 SQL 脚本看清超市业务的最小表集合超市管理系统里最常见的数据表就是商品分类表、商品表、会员表、订单主表和订单明细表。SQL 脚本多数放在db/supermarket.sql或项目根目录。执行脚本前先确认文件编码Windows 下用记事本另存为 UTF-8 再执行否则中文注释进库后就是乱码。-- 初始化超市商品表 CREATE DATABASE IF NOT EXISTS supermarket DEFAULT CHARSET utf8mb4; USE supermarket; DROP TABLE IF EXISTS product; CREATE TABLE product ( id INT PRIMARY KEY AUTO_INCREMENT COMMENT 商品ID, name VARCHAR(64) NOT NULL COMMENT 商品名称, price DECIMAL(10,2) NOT NULL COMMENT 销售单价, stock INT NOT NULL DEFAULT 0 COMMENT 库存数量, category_id INT COMMENT 商品分类ID, create_time DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT 入库时间 ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT商品表;AUTO_INCREMENT由数据库维护自增主键DECIMAL(10,2)存金额禁止用 float 或 double二进制浮点会累积精度误差utf8mb4比utf8多覆盖 emoji 和生僻字。stock字段一般还要配合应用层校验保证扣减库存后不会变成负数。表名业务职责核心字段category商品分类id, name, parent_idproduct商品基本信息与库存id, name, price, stock, category_idmember会员信息id, phone, balance, integralorder_master销售订单主表id, order_no, total_amount, pay_type, create_timeorder_detail销售订单明细id, order_id, product_id, quantity, price一个基础版超市系统先有这几张表就够了。在 SSM 代码里order_master主表插入和order_detail明细插入要包在同一个事务里也就是 Service 方法上标记Transactional保证订单主表写成功但明细失败时能整体回滚。4.2 在 IDEA 里配置 Tomcat 和 Artifact让 SSM 工程跑成 Web 应用SSM 跑 Web 的方式和 Spring Boot 不同需要手动配置一个 Tomcat Server。常见做法是在Run Edit Configurations里新增 Tomcat Server Local然后把项目挂到 Deployment 页。IDEA 社区版默认不带 Tomcat 集成需要装 Smart Tomcat 插件或者用tomcat7-maven-plugin插件启动。进入Project Structure Artifacts确认存在supermarket: war exploded。打开Run Edit Configurations新增一个 Tomcat Server Local。切到Deployment页点加号选择Artifact把war exploded添加进去。把Application context设置为/supermarket。在Server页把On Update action设为Update classes and resources实现开发期热部署。war exploded表示不解压的目录结构IDEA 会把编译后的classes和webapp资源直接当作 Web 应用根目录调试时不用反复打包。Application context决定访问路径启动后地址类似http://localhost:8080/supermarket/product/list。如果 Tomcat 启动后 404先检查这个 context 和 URL 是否一致。注意如果压缩包里没有web.xml要确认 Maven 是否配置了maven-war-plugin的failOnMissingWebXml为 false。没有 web.xml 也能运行但DispatcherServlet必须通过WebApplicationInitializer初始化。4.3 商品列表页从前端 AJAX 到 Controller 的参数链路排查请求链路是排查 SSM 项目最核心的切入点前端页面发 AJAX经过web.xml里映射到DispatcherServlet的拦截规则再落到Controller方法。超市系统最常改的就是商品管理浏览器控制台网络面板里出现 404基本是路径没对上。// 商品列表查询使用 jQuery 发起 AJAX $.ajax({ url: product/list, type: GET, data: { categoryId: selectedId, pageNo: 1, pageSize: 10 }, dataType: json, success: function (res) { renderProductRows(res.data); }, error: function (xhr, status, error) { console.log(status, error); } });Controller RequestMapping(/product) public class ProductController { Autowired private ProductService productService; /** 商品分页查询categoryId 可为空 */ RequestMapping(/list) ResponseBody public MapString, Object list(Integer categoryId, RequestParam(defaultValue 1) Integer pageNo, RequestParam(defaultValue 10) Integer pageSize) { return productService.pageQuery(categoryId, pageNo, pageSize); } }前端 url 写product/list后端方法返回的完整路径就是/product/list。注意RequestParam的页面参数名pageNo是驼峰前端 data 里的pageNo必须一字不差否则 Spring MVC 会当作缺参直接 400。categoryId没有设置 required所以可以传空值不传时是 nullMyBatis 动态 SQL 里要用if testcategoryId ! null做空判断。看到Controller类名后在 IDEA 里右键选择Diagrams Show Diagram Popup可以生成类图一眼看清ProductController依赖了哪些 Service 和 DAO。排查 NPE 或 Mapper 实现类找不到时这个图比逐个文件点开快很多。5. 进阶用 Maven Profile 把超市系统的开发配置和部署配置分离5.1 在 pom.xml 中定义 dev 和 prod 两个 profile并抽离资源目录项目本地跑通后真正交付时最怕把开发库的明文密码留在 war 里。Maven Profile 可以用来隔离环境参数这是比手动改配置更可靠的做法。最常见的形式是把配置目录拆成resources、resources-dev、resources-prod三份。!-- pom.xml 中定义两套 profile -- profiles profile iddev/id properties envdev/env /properties /profile profile idprod/id properties envprod/env /properties /profile /profiles build resources !-- 先加载公共资源再叠加环境特定资源 -- resource directorysrc/main/resources/directory /resource resource directorysrc/main/resources-${env}/directory /resource /resources /build执行mvn clean install -Pdev时${env}会被替换成devMaven 会把src/main/resources-dev追加到 classpath。公共配置如日志框架的log4j2.xml留在resources数据库地址、账号密码、图片上传路径这些和环境有关的内容放进resources-dev或resources-prod。两个目录里出现同名文件时后声明的resources-${env}优先级更高覆盖效果就是环境配置接管公共配置。5.2 用 Maven 命令行 clean install 动态切换环境# 开发环境打包跳过测试 mvn clean install -DskipTests -Pdev # 生产环境打包跳过测试并强制刷新快照 mvn clean package -DskipTests -Pprod -U-P后面跟的是profile的 id和 pom 里定义的dev、prod一一对应。-DskipTests跳过测试执行但测试类仍然会编译如果项目里有依赖本地环境的测试用例最好换成-Dmaven.test.skiptrue整个测试阶段都不执行。如果承接的 SSM 项目配置文件里写了${db.url}这类占位符还要在对应的 resource 上加filteringtrue/filteringMaven 才会在复制文件时执行变量替换否则打包到 war 里后字符串仍然是${db.url}的字面量启动时连数据库直接报错。5.3 验证构建出来的 war 里没有残留开发环境痕迹# 直接查看 war 中指定配置文件的真实内容 unzip -p target/supermarket.war WEB-INF/classes/jdbc.properties # 检索 war 中是否残留本地数据库地址 zipgrep localhost:3306 target/supermarket.warunzip -p会把文件内容输出到标准输出而不解压是验证 profile 是否生效最快的办法Windows 下没有 unzip 时可以把 war 后缀临时改成 zip用压缩软件打开查看。如果在jdbc.properties里还能看到localhost说明环境目录没有被 Maven 选中或者filtering没开启。验证通过后再把 war 改名或交给运维线上包就不会带上开发库的连接串和密码。本文还有配套的精品资源点击获取