企业官网建设流程全解析

简介：本资源是一套完整的Java Web毕设级车辆维修管理系统源码，面向计算机专业学生、Java初学者及需要SSM框架实战项目的开发者，解决汽车服务企业中车辆信息、维修订单、配件库存与多角色协同管理等核心业务场景。压缩包共3个文件（2个ZIP源码包+1个SQL数据库脚本），总大小24.72MB，涵盖可直接运行的SSM项目源码、建库建表脚本及详细项目说明文档，结构清晰、模块完整。已有190人学习下载，适合作为课程设计、毕业设计或Spring+MyBatis技术栈入门实践范例。读者可获得含用户/员工/管理员三端功能的完整B/S系统：支持车辆全生命周期管理、故障登记与派单、配件采购与仓库调度、多维度统计分析，并附带Eclipse/IDEA兼容开发环境配置说明与MySQL部署指引，开箱即调、调试通过。

1. 这不是又一个“增删改查”Demo：SSM+JSP车辆维修管理系统，为什么毕设答辩老师会多问三句？

你手里的毕设选题写着“Java车辆维修管理系统”，但心里清楚——它大概率会被归类为“Web基础课设合集”里最不起眼的那一行。可当某高校计算机系导师连续三年在答辩现场对同一套SSM+JSP结构的系统追问“维修工单状态机怎么流转？”“配件库存扣减如何防超卖？”“历史维修记录导出时Excel样式怎么动态适配车型字段？”，你就该意识到：这套看似传统的技术栈，正在成为检验工程落地能力的隐形标尺。它不考你是否能写出Spring Boot自动装配，而考你能否用MyBatis写好一条带事务边界的SQL、用JSP标签库处理好分页参数透传、用Filter拦截未登录用户却放行静态资源。这不是复古，是回归——回归到“业务逻辑能不能稳稳跑在Tomcat里”的原始命题。适合正在赶毕设DDL、需要可演示+可讲解+可延展的Java Web项目的学生，也适合想补全传统企业级开发链路（非云原生场景）的一线开发者。它不炫技，但每一步都踩在真实交付的边界上。

2. 从零搭起SSM骨架：不是复制pom.xml，而是理解三层之间谁该信任谁

2.1 为什么坚持用SSM而非Spring Boot？——兼容性与教学穿透力的权衡

很多同学看到“SSM”第一反应是“过时”，但实际在某高校实验室的模拟项目X中，我们刻意保留了XML配置方式：一是确保学生能看清Spring容器如何加载MyBatis的SqlSessionFactoryBean，而不是被@MapperScan黑盒掩盖；二是为后续接入国产中间件（如达梦数据库驱动）预留XML级替换入口。pom.xml核心依赖必须锁定版本号，避免Maven传递依赖引发的NoSuchMethodError：

<!-- spring-context 必须与 spring-webmvc 版本严格一致 --> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-context</artifactId> <version>4.3.29.RELEASE</version> </dependency> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-webmvc</artifactId> <version>4.3.29.RELEASE</version> </dependency> <!-- MyBatis 3.4.6 是兼容JDK7+Tomcat7的最后稳定版 --> <dependency> <groupId>org.mybatis</groupId> <artifactId>mybatis</artifactId> <version>3.4.6</version> </dependency>

提示：spring-core和spring-beans版本必须由spring-context传递引入，手动声明低版本会导致ClassCastException——这是某同学在部署到学校机房Tomcat7时翻车的第一步。

2.2 web.xml：Servlet容器的“宪法”，每个filter-mapping顺序都是业务逻辑

SSM项目的启动入口不在main()方法，而在web.xml。这里定义了整个请求生命周期的控制权交接：

<!-- 字符编码过滤器必须放在最前，否则POST中文参数乱码 --> <filter> <filter-name>encodingFilter</filter-name> <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class> <init-param> <param-name>encoding</param-name> <param-value>UTF-8</param-value> </init-param> </filter> <filter-mapping> <filter-name>encodingFilter</filter-name> <url-pattern>/*</url-pattern> </filter-mapping> <!-- Spring MVC前端控制器，匹配所有.do请求 --> <servlet> <servlet-name>dispatcher</servlet-name> <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class> <init-param> <param-name>contextConfigLocation</param-name> <param-value>classpath:spring-mvc.xml</param-value> </init-param> <load-on-startup>1</load-on-startup> </servlet> <servlet-mapping> <servlet-name>dispatcher</servlet-name> <url-pattern>*.do</url-pattern> </servlet-mapping>

关键点在于：CharacterEncodingFilter必须置于所有filter之前，否则HttpServletRequest.getParameter()拿到的是ISO-8859-1编码的乱码字符串；而servlet-mapping的url-pattern设为*.do而非/，是为了明确区分静态资源（CSS/JS直接由Tomcat处理）和动态请求（交由DispatcherServlet），避免JSP页面中<script src="js/common.js">被错误拦截。

2.3 Spring与MyBatis的“婚姻协议”：SqlSessionFactoryBean的三个生死参数

MyBatis不是Spring原生组件，二者集成靠SqlSessionFactoryBean这个“媒人”。它的配置直接决定DAO层是否可用：

<bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean"> <property name="dataSource" ref="dataSource"/> <!-- 指向MyBatis全局配置文件，此处必须显式指定 --> <property name="configLocation" value="classpath:mybatis-config.xml"/> <!-- 关键！Mapper XML文件位置，支持通配符 --> <property name="mapperLocations" value="classpath:mapper/*.xml"/> </bean>

• configLocation：若省略，MyBatis将使用默认配置（如logImpl=SLF4J），但无法启用二级缓存或自定义TypeHandler；
• mapperLocations：必须用classpath:前缀，且路径需与实际resources目录结构完全匹配。某同学把XML放在src/main/java/mapper/下却写classpath:mapper/*.xml，导致启动时No Mappers found；
• dataSource：必须是Spring管理的DataSourceBean，不能直接newBasicDataSource()——否则事务注解@Transactional失效。

3. 车辆与维修的核心建模：用ER图约束业务，而不是用代码硬编码规则

3.1 数据库设计的三个反直觉原则：从“能存”到“防错”

车辆维修系统的数据表看似简单，但某公司实际交付的同类系统中，73%的线上Bug源于初始建模缺陷。我们采用以下原则：

MySQL建表脚本关键片段（含外键与索引）：

CREATE TABLE `t_vehicle` ( `id` BIGINT NOT NULL AUTO_INCREMENT, `vin` CHAR(17) NOT NULL UNIQUE COMMENT '车辆VIN码', `brand` VARCHAR(20) NOT NULL COMMENT '品牌', `model` VARCHAR(30) NOT NULL COMMENT '车型', `mileage` INT NOT NULL DEFAULT 0 COMMENT '行驶里程', PRIMARY KEY (`id`), INDEX `idx_vin` (`vin`) -- VIN查询高频，单独建索引 ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4; CREATE TABLE `t_repair_order` ( `id` BIGINT NOT NULL AUTO_INCREMENT, `vehicle_id` BIGINT NOT NULL COMMENT '关联车辆ID', `order_no` VARCHAR(20) NOT NULL UNIQUE COMMENT '维修单号', `status` TINYINT NOT NULL DEFAULT 0 COMMENT '状态：0待接单,1维修中,2已完工,3已结算', `create_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (`id`), FOREIGN KEY (`vehicle_id`) REFERENCES `t_vehicle`(`id`) ON DELETE RESTRICT, INDEX `idx_vehicle_status` (`vehicle_id`, `status`) -- 车辆维修状态查询复合索引 ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

注意：ON DELETE RESTRICT而非CASCADE，防止误删车辆时连带清除历史维修记录——这是某汽车4S店系统曾发生的生产事故。

3.2 MyBatis映射的“脏数据”防御：ResultMap比自动映射更可靠

车辆信息中常含engine_type（发动机类型）、transmission（变速箱）等字典字段，若用<select * from t_vehicle>配合resultType="Vehicle"，一旦DB新增列而VO未同步，MyBatis抛Invalid bound statement异常。正确做法是显式定义ResultMap：

<!-- mapper/VehicleMapper.xml --> <resultMap id="VehicleResultMap" type="com.example.entity.Vehicle"> <id property="id" column="id"/> <result property="vin" column="vin"/> <result property="brand" column="brand"/> <result property="model" column="model"/> <result property="mileage" column="mileage"/> <!-- 显式声明，新增字段不影响旧映射 --> </resultMap> <select id="selectByVin" resultMap="VehicleResultMap"> SELECT id, vin, brand, model, mileage FROM t_vehicle WHERE vin = #{vin} </select>

resultMap还支持嵌套查询，例如维修单详情页需同时加载车辆信息和维修项目列表：

<resultMap id="RepairOrderDetailResultMap" type="com.example.entity.RepairOrder"> <id property="id" column="ro.id"/> <result property="orderNo" column="ro.order_no"/> <association property="vehicle" javaType="com.example.entity.Vehicle" resultMap="VehicleResultMap"/> <collection property="items" ofType="com.example.entity.RepairItem" column="ro.id" select="selectRepairItemsByOrderId"/> </resultMap>

这种“分步加载”模式虽增加一次SQL查询，但避免了N+1问题（<collection>的select属性会复用已有的RepairItemMapper），且各层VO可独立演进。

4. JSP页面的“老派智慧”：不用Vue也能做出现代交互体验

4.1 JSTL标签库的三个高阶用法：让页面逻辑不再散落成Scriptlet

JSP不是淘汰品，而是被低估的模板引擎。某导师在评审时特别指出：“能用<c:forEach>替代<% for(int i=0; i<list.size(); i++) { %>的同学，代码可读性提升50%”。关键技巧：

• 动态URL参数拼接：维修单列表页需保留搜索条件（如?brand=Toyota&status=1），用<c:url>自动编码：

<c:url var="searchUrl" value="/repair/list.do"> <c:param name="brand" value="${param.brand}"/> <c:param name="status" value="${param.status}"/> </c:url> <a href="${searchUrl}&page=${pageInfo.nextPage}">下一页</a>

• 空值安全渲染：车辆品牌可能为空，用<c:out>默认转义HTML字符防XSS：

<td><c:out value="${vehicle.brand}" default="未知品牌"/></td>

• 条件样式切换：维修单状态用不同颜色标识，避免冗长<% if(status==1){ %>style="color:green"<% } %>：

<tr class="${repairOrder.status == 1 ? 'status-processing' : repairOrder.status == 2 ? 'status-finished' : 'status-pending'}">

4.2 分页组件的“无感集成”：PageHelper插件的三处致命配置

MyBatis分页若手写LIMIT #{offset}, #{size}，需在Service层计算偏移量，极易出错。PageHelper是业界标准方案，但配置不当会导致全局分页污染：

// Controller层：必须在调用Mapper前执行startPage @RequestMapping("/list.do") public String list(@RequestParam(defaultValue = "1") Integer pageNum, @RequestParam(defaultValue = "10") Integer pageSize, Model model) { PageHelper.startPage(pageNum, pageSize); // 关键！必须在此处调用 List<RepairOrder> list = repairOrderService.listAll(); PageInfo<RepairOrder> pageInfo = new PageInfo<>(list); model.addAttribute("pageInfo", pageInfo); return "repair/list"; }

• PageHelper.startPage()必须在Mapper方法调用之前，否则无效；
• PageInfo构造后立即获取list，因为PageHelper的Page对象是ThreadLocal存储，后续调用其他Mapper会覆盖；
• 若项目有多个数据源，需在spring-mybatis.xml中为每个SqlSessionFactory单独配置PageHelper插件，否则跨库查询分页失效。

5. 避坑指南：那些让毕设答辩变成“救火现场”的5个血泪经验

5.1 现象：JSP页面显示中文乱码，但数据库和Java代码全是UTF-8

原因：Tomcat默认使用ISO-8859-1解码URL参数，request.getParameter("brand")返回乱码字符串，即使页面<%@ page contentType="text/html;charset=UTF-8"%>也无效。
解决：在web.xml中添加<filter>强制解码，或在Controller中手动转换：

String brand = new String(request.getParameter("brand").getBytes("ISO-8859-1"), "UTF-8");

但更彻底的方案是在server.xml的Connector节点添加URIEncoding="UTF-8"。

5.2 现象：@Transactional注解失效，维修单创建成功但配件库存未扣减

原因：事务管理器未正确配置，或Service方法被本类内部调用（绕过Spring代理）。某同学在RepairOrderService.createOrder()中直接调用this.updateStock()，导致updateStock()上的@Transactional不生效。
解决：

1. 检查spring-service.xml中<tx:annotation-driven transaction-manager="transactionManager"/>是否声明；
2. 将库存更新逻辑抽离为独立Service方法，并通过ApplicationContext.getBean(StockService.class)调用，或使用@EnableAspectJAutoProxy(exposeProxy=true)后((RepairOrderService) AopContext.currentProxy()).updateStock()。

5.3 现象：导出Excel时数字列显示为科学计数法（如132000000000显示为1.32E11）

原因：Apache POI默认将长数字识别为数值类型，Excel自动格式化。
解决：在设置单元格值时强制指定字符串类型：

Cell cell = row.createCell(0); cell.setCellStyle(stringStyle); // 预先定义的CellStyle，setAlignment(HorizontalAlignment.LEFT) cell.setCellValue(new XSSFRichTextString(vin)); // 用RichTextString包装

5.4 现象：登录后跳转回原页面失败，始终回到首页

原因：LoginInterceptor中savedRequestUrl未正确保存，或response.sendRedirect()的URL未包含上下文路径。
解决：

// Interceptor中保存原URL String requestUrl = request.getRequestURL().toString(); String queryString = request.getQueryString(); if (queryString != null) { requestUrl += "?" + queryString; } // 存入session，注意：必须用request.getContextPath()获取项目名 request.getSession().setAttribute("savedRequestUrl", request.getContextPath() + requestUrl);

5.5 现象：Tomcat启动报错java.lang.ClassNotFoundException: org.springframework.web.context.ContextLoaderListener

原因：Maven依赖范围错误，spring-web被声明为<scope>test</scope>，或IDE未将Maven依赖加入Deployment Assembly。
解决：

1. 检查pom.xml中所有Spring依赖<scope>是否为compile（默认值）；
2. Eclipse中右键项目 → Properties → Deployment Assembly → 确认Maven Dependencies已添加；
3. IntelliJ中File → Project Structure → Artifacts → 确保Available Elements中的jar包已拖入Output Layout。

6. 让系统“活”起来的三个验证技巧：不靠截图，靠日志和断点说话

6.1 用Log4j2验证事务边界：看懂那行“Committing JDBC Transaction”

很多同学以为加了@Transactional就万事大吉，但真正的事务控制点藏在日志里。在log4j2.xml中开启MyBatis-Spring日志：

<Logger name="org.springframework.jdbc.datasource.DataSourceTransactionManager" level="debug" additivity="false"> <AppenderRef ref="Console"/> </Logger> <Logger name="org.mybatis.spring.SqlSessionUtils" level="debug" additivity="false"> <AppenderRef ref="Console"/> </Logger>

当执行维修单创建时，控制台应输出：

DEBUG o.s.j.d.DataSourceTransactionManager - Creating new transaction with name [com.example.service.RepairOrderService.createOrder]: PROPAGATION_REQUIRED,ISOLATION_DEFAULT DEBUG o.m.s.SqlSessionUtils - Creating a new SqlSession DEBUG o.s.j.d.DataSourceTransactionManager - Acquired Connection [org.apache.commons.dbcp.PoolableConnection@1a2b3c] for JDBC transaction ... 执行SQL ... DEBUG o.s.j.d.DataSourceTransactionManager - Committing JDBC transaction on Connection [org.apache.commons.dbcp.PoolableConnection@1a2b3c]

如果看到Rolling back JDBC transaction或根本没有Committing日志，则事务未生效。这是比“页面有没有报错”更底层的验证。

6.2 用Chrome DevTools Network面板抓取“真·AJAX请求”

JSP页面常混用同步提交（form submit）和异步请求（jQuery.ajax）。答辩时老师可能要求：“演示一下不刷新页面修改维修单状态”。此时需确认：

• 请求URL是否为/repair/updateStatus.do（符合.do后缀规范）；
• Request Headers中Content-Type是否为application/x-www-form-urlencoded（表单提交）或application/json（JSON接口）；
• Response Body是否返回JSON格式{"success":true,"message":"状态更新成功"}，而非整页HTML。

某同学因未在Controller中添加@ResponseBody，返回的JSON被JSP视图解析器当成页面路径，导致404——用Network面板一眼识破。

6.3 用MySQL慢查询日志定位性能瓶颈：不是所有SQL都该加索引

在my.cnf中开启慢查询（某高校机房MySQL5.7默认关闭）：

slow_query_log = ON slow_query_log_file = /var/log/mysql/slow.log long_query_time = 1

运行维修单列表页（/repair/list.do?page=1&size=100），检查慢日志：

# Query_time: 2.345678 Lock_time: 0.000123 Rows_sent: 100 Rows_examined: 15000 SELECT * FROM t_repair_order WHERE status = 1 ORDER BY create_time DESC LIMIT 0,100;

Rows_examined: 15000远大于Rows_sent: 100，说明未走索引。此时需在status和create_time上建立联合索引：

ALTER TABLE t_repair_order ADD INDEX idx_status_ctime (status, create_time DESC);

我的习惯是：每次新增WHERE条件或ORDER BY字段，立刻用EXPLAIN分析执行计划；每次上线前，用mysqldumpslow扫描慢日志。这些不是“高级技巧”，而是让系统在答辩服务器上不卡顿的后悔药。希望帮到你。

本文还有配套的精品资源，点击获取