简介这是一套完整的物流快递系统SpringBoot实战项目面向Java初学者与课程设计、毕业设计学习者覆盖前后端分离开发全流程帮助掌握MVC三层架构、SpringBoot核心组件及MySQL数据库应用。资源包共640个文件含61个Java业务类如OrdersController、DriversController、InvoiceServiceImpl等、113个XML配置文件、84个CSS与69个JS前端资源、88个PNG和69个JPG界面素材以及SQL建表脚本、演示MP4视频、IDEA工程配置文件等整体73.13MB结构清晰、模块完整。已有910人学习下载适合从零搭建并理解典型电商物流场景下的订单管理、司机调度、网点维护、投诉处理与电子发票生成等核心功能。配套演示视频直观展示系统运行效果源码注释规范Maven依赖明确兼容JDK 1.8、Tomcat 8.5与MySQL 5.7开箱即用是Java Web入门与项目实践的高价值学习材料。1. 一个能跑起来的物流快递系统为什么必须从 SpringBoot MVC 三层架构开始学刚接触 Java Web 开发的人常陷入一个误区直接照着“快递系统”需求文档堆功能结果两周后连登录接口都返回 404。真实情况是——没有清晰分层、不理解 Controller/Service/DAO 各层职责边界、没配对 Maven 依赖与 MySQL 表结构再完整的业务逻辑也跑不起来。这个标题里的“物流快递系统前、后端JavaSpringBootMVC三层架构mavenMysqlTomcat”不是功能罗列而是一套可验证的最小技术栈闭环前端页面发起请求 → SpringBoot 接收并路由 → Service 层编排业务如查运单、改状态→ DAO 层执行 SQL → MySQL 返回数据 → Tomcat 承载整个 Web 应用。它适合两类人一是刚学完 Java 基础、想把“类和对象”真正落地到 Web 场景的初学者二是准备 Java 面试题时需要手写可运行 demo 的求职者——因为面试官真会问“你这个运单查询接口SQL 是在 Service 还是 Mapper 里写的为什么”、“如果数据库连接失败异常是在哪一层捕获的”。本篇不讲抽象理论只带你用最简路径在本地 Windows 或 macOS 上5 分钟内启动一个带运单管理、用户登录、快递员派件的完整系统。2. 搭建 SpringBoot 物流系统骨架Maven 项目初始化与核心依赖配置2.1 用 Spring Initializr 创建标准 Maven 工程非 IDE 插件生成很多新手误以为用 IDEA “New Project → Spring Initializr” 就万事大吉但实际开发中必须手动校验 pom.xml 中的 dependency scope 和版本兼容性。物流系统对事务一致性要求高不能盲目升级 SpringBoot 版本。当前2024 年主流实践推荐使用 SpringBoot 2.7.18LTS 版本它与 MyBatis 3.4.6、MySQL Connector/J 8.0.33 兼容稳定避免出现java.lang.NoClassDefFoundError: org/springframework/boot/autoconfigure/jdbc/DataSourceProperties这类典型依赖冲突。提示不要用 SpringBoot 3.x基于 Jakarta EE 9它默认移除了 javax.servlet会导致 Tomcat 9 无法部署而物流系统教学环境普遍用 Tomcat 9/10强行升级会卡在容器启动阶段。2.1.1 手动创建 pom.xml 关键依赖块可直接复制?xml version1.0 encodingUTF-8? project xmlnshttp://maven.apache.org/POM/4.0.0 xmlns:xsihttp://www.w3.org/2001/XMLSchema-instance xsi:schemaLocationhttp://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd modelVersion4.0.0/modelVersion parent groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-parent/artifactId version2.7.18/version relativePath/ /parent groupIdcom.example/groupId artifactIdlogistics-system/artifactId version0.0.1-SNAPSHOT/version namelogistics-system/name properties java.version1.8/java.version mybatis.version3.4.6/mybatis.version mysql.version8.0.33/mysql.version /properties dependencies !-- Web 核心提供 DispatcherServlet 和 REST 支持 -- dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency !-- 数据访问整合 MyBatis -- dependency groupIdorg.mybatis.spring.boot/groupId artifactIdmybatis-spring-boot-starter/artifactId version${mybatis.version}/version /dependency !-- 数据库驱动 -- dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId version${mysql.version}/version scoperuntime/scope /dependency !-- 数据源连接池HikariCP 内置无需额外引入 -- dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-jdbc/artifactId /dependency !-- Lombok 简化实体类避免手写 getter/setter -- dependency groupIdorg.projectlombok/groupId artifactIdlombok/artifactId optionaltrue/optional /dependency !-- 测试支持 -- dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-test/artifactId scopetest/scope /dependency /dependencies build plugins plugin groupIdorg.springframework.boot/groupId artifactIdspring-boot-maven-plugin/artifactId /plugin /plugins /build /project这段配置的关键点在于scoperuntime/scope明确指定 MySQL 驱动仅在运行时加载编译时不参与避免 IDE 报红optionaltrue/optional声明 Lombok 为可选依赖防止被其他模块意外传递依赖spring-boot-starter-jdbc虽未显式写版本号但由 parent 的spring-boot-starter-parent统一管理确保与 SpringBoot 2.7.18 兼容。2.1.2 初始化目录结构严格遵循 MVC 三层物理分包SpringBoot 不强制目录结构但物流系统必须显式分离职责。在src/main/java/com/example/logistics下建立以下包├── controller // 接收 HTTP 请求只做参数校验和调用 Service ├── service // 业务逻辑编排如运单状态流转校验、派件时间计算 │ ├── impl // Service 接口实现类 ├── mapper // MyBatis Mapper 接口对应 DAO 层 ├── entity // 数据库表映射实体Data TableName ├── dto // 数据传输对象如 LoginDTO、WaybillQueryDTO └── LogisticsSystemApplication.java // 启动类含 SpringBootApplication注意mapper包不能放在controller或service下否则 MyBatis 扫描不到接口entity类必须用TableName(waybill)显式绑定表名避免大小写敏感导致 MySQL 查询失败尤其在 Linux 服务器上。2.2 配置 application.ymlMySQL 连接与 MyBatis 行为控制物流系统对数据库操作有强一致性要求application.yml必须显式配置事务行为和 SQL 日志。以下是最小可用配置非开发环境勿开启show-sqlserver: port: 8080 servlet: context-path: /logistics spring: datasource: url: jdbc:mysql://localhost:3306/logistics_db?useUnicodetruecharacterEncodingUTF-8serverTimezoneAsia/ShanghaiallowPublicKeyRetrievaltrueuseSSLfalse username: root password: your_password_here driver-class-name: com.mysql.cj.jdbc.Driver # MyBatis 配置关键 mybatis: mapper-locations: classpath:mapper/*.xml configuration: log-prefix: com.example.logistics.mapper. map-underscore-to-camel-case: true # 自动转换 user_name → userName # 开启二级缓存物流系统中运单状态变更频繁此处设为 false cache-enabled: false type-aliases-package: com.example.logistics.entity logging: level: com.example.logistics.mapper: DEBUG # 查看实际执行的 SQL参数说明server.servlet.context-path设为/logistics避免与本地其他项目端口冲突serverTimezoneAsia/Shanghai必须设置否则 MySQL 8.0 会报The server time zone value XXX is unrecognizedmap-underscore-to-camel-case: true让 MyBatis 自动将数据库字段receiver_phone映射到 Java 字段receiverPhone省去Results手动映射cache-enabled: false是物流系统的硬性要求运单状态如“已签收”一旦更新所有节点必须实时读取最新值不能走缓存。3. 实现 MVC 三层核心逻辑以“运单查询”为例贯穿 Controller-Service-Mapper3.1 Controller 层定义 RESTful 接口契约与参数校验物流系统接口必须明确输入输出格式。以“根据运单号查询运单详情”为例Controller 只做三件事接收参数、校验合法性、调用 Service。不处理任何 SQL 或业务规则。3.1.1 定义运单查询 DTO 与响应 VO// src/main/java/com/example/logistics/dto/WaybillQueryDTO.java Data public class WaybillQueryDTO { NotBlank(message 运单号不能为空) Pattern(regexp ^SF[0-9]{10}$, message 运单号格式错误SF10位数字) private String waybillNo; } // src/main/java/com/example/logistics/vo/WaybillDetailVO.java Data public class WaybillDetailVO { private String waybillNo; private String senderName; private String receiverName; private String status; // 已揽收, 运输中, 已签收 private LocalDateTime updateTime; }3.1.2 编写 Controller 方法含全局异常处理// src/main/java/com/example/logistics/controller/WaybillController.java RestController RequestMapping(/api/waybills) Slf4j public class WaybillController { Autowired private WaybillService waybillService; GetMapping(/{waybillNo}) public ResultWaybillDetailVO getWaybillDetail(PathVariable String waybillNo) { // 参数校验交由 Valid 完成需在方法参数加 Valid WaybillQueryDTO queryDTO new WaybillQueryDTO(); queryDTO.setWaybillNo(waybillNo); return Result.success(waybillService.getWaybillDetail(queryDTO)); } }提示PathVariable直接绑定 URL 路径变量比RequestParam更符合 REST 规范ResultT是自定义统一响应体含 code/msg/data避免前端反复解析不同结构 JSON。3.2 Service 层封装业务规则与事务边界物流系统的核心复杂度在 Service 层。例如“查询运单”看似简单但需校验运单号是否存在、用户是否有权限查看区分客户/快递员、是否触发风控拦截如高频查询。这些逻辑绝不能写在 Controller 或 Mapper 中。3.2.1 Service 接口与实现类// src/main/java/com/example/logistics/service/WaybillService.java public interface WaybillService { WaybillDetailVO getWaybillDetail(WaybillQueryDTO queryDTO); } // src/main/java/com/example/logistics/service/impl/WaybillServiceImpl.java Service Transactional(rollbackFor Exception.class) Slf4j public class WaybillServiceImpl implements WaybillService { Autowired private WaybillMapper waybillMapper; Override public WaybillDetailVO getWaybillDetail(WaybillQueryDTO queryDTO) { // 1. 校验运单号格式已在 DTO 注解校验此处为二次保险 if (!queryDTO.getWaybillNo().matches(^SF[0-9]{10}$)) { throw new BusinessException(运单号格式非法); } // 2. 查询数据库 WaybillEntity entity waybillMapper.selectByWaybillNo(queryDTO.getWaybillNo()); if (entity null) { throw new BusinessException(未找到运单 queryDTO.getWaybillNo()); } // 3. 构建 VO此处可加入业务计算如预估送达时间 WaybillDetailVO vo new WaybillDetailVO(); vo.setWaybillNo(entity.getWaybillNo()); vo.setSenderName(entity.getSenderName()); vo.setReceiverName(entity.getReceiverName()); vo.setStatus(entity.getStatus()); vo.setUpdateTime(entity.getUpdateTime()); return vo; } }关键点Transactional保证数据库操作原子性若后续加入“查询更新物流轨迹”操作事务自动生效BusinessException是自定义运行时异常被全局异常处理器捕获后返回Result.error()避免暴露堆栈信息所有业务判断如权限校验应在此处添加而非 Mapper 层——Mapper 只负责“增删改查”不负责“能不能查”。3.3 Mapper 层MyBatis XML 映射与 SQL 编写物流系统涉及多表关联运单、收发件人、物流轨迹纯注解方式难以维护。必须使用mapper/*.xml文件编写 SQL并启用resultMap处理复杂映射。3.3.1 创建 WaybillMapper 接口与 XML 文件// src/main/java/com/example/logistics/mapper/WaybillMapper.java Mapper public interface WaybillMapper { WaybillEntity selectByWaybillNo(Param(waybillNo) String waybillNo); }!-- src/main/resources/mapper/WaybillMapper.xml -- ?xml version1.0 encodingUTF-8? !DOCTYPE mapper PUBLIC -//mybatis.org//DTD Mapper 3.0//EN http://mybatis.org/dtd/mybatis-3-mapper.dtd mapper namespacecom.example.logistics.mapper.WaybillMapper resultMap idWaybillResultMap typecom.example.logistics.entity.WaybillEntity id propertyid columnid/ result propertywaybillNo columnwaybill_no/ result propertysenderName columnsender_name/ result propertyreceiverName columnreceiver_name/ result propertystatus columnstatus/ result propertyupdateTime columnupdate_time/ /resultMap select idselectByWaybillNo resultMapWaybillResultMap SELECT id, waybill_no, sender_name, receiver_name, status, update_time FROM waybill WHERE waybill_no #{waybillNo} /select /mapper注意resultMap中property是 Java 字段名column是数据库字段名二者通过map-underscore-to-camel-case: true自动转换但显式声明更安全#{waybillNo}使用预编译参数防止 SQL 注入绝不能写成${waybillNo}。4. 数据库建模与 Tomcat 部署从 MySQL 表结构到可访问的 Web 应用4.1 物流系统核心表设计ER 图关键字段教学用物流系统不必过度设计但必须包含基础实体关系。以下是logistics_db数据库中 3 张核心表的建表语句MySQL 8.0-- 运单主表 CREATE TABLE waybill ( id bigint NOT NULL AUTO_INCREMENT COMMENT 主键ID, waybill_no varchar(20) NOT NULL COMMENT 运单号唯一索引, sender_name varchar(50) NOT NULL COMMENT 寄件人姓名, receiver_name varchar(50) NOT NULL COMMENT 收件人姓名, status enum(已揽收,运输中,派件中,已签收,已拒收) DEFAULT 已揽收 COMMENT 运单状态, update_time datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT 最后更新时间, PRIMARY KEY (id), UNIQUE KEY uk_waybill_no (waybill_no) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT运单主表; -- 用户表区分客户、快递员、管理员 CREATE TABLE user ( id bigint NOT NULL AUTO_INCREMENT, username varchar(50) NOT NULL COMMENT 登录账号, password varchar(100) NOT NULL COMMENT BCrypt 加密密码, role enum(CUSTOMER,COURIER,ADMIN) NOT NULL COMMENT 角色, PRIMARY KEY (id), UNIQUE KEY uk_username (username) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; -- 物流轨迹表运单状态变更历史 CREATE TABLE track_log ( id bigint NOT NULL AUTO_INCREMENT, waybill_no varchar(20) NOT NULL COMMENT 运单号, status varchar(20) NOT NULL COMMENT 当前状态, operator varchar(50) NOT NULL COMMENT 操作人快递员工号, create_time datetime NOT NULL DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), KEY idx_waybill_no (waybill_no) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;关键设计说明waybill_no设为UNIQUE KEY避免重复运单status使用enum类型而非varchar由数据库约束状态值防止 Java 层传入非法字符串track_log表不设外键FOREIGN KEY教学系统为简化部署靠 Java 层逻辑保证数据一致性。4.2 启动 Tomcat 并验证接口可用性SpringBoot 内置 Tomcat但教学场景常需外置部署以理解容器原理。以下步骤验证系统是否真正就绪4.2.1 使用 Maven 打包并部署到独立 Tomcat# 在项目根目录执行 mvn clean package -Dmaven.test.skiptrue # 将 target/logistics-system-0.0.1-SNAPSHOT.jar 复制到 Tomcat webapps 目录 # 注意SpringBoot 默认打包为可执行 jar需修改打包方式才能部署到外置 Tomcat提示若要部署到外置 Tomcat需修改pom.xml将packagingjar/packaging改为packagingwar/packaging并添加spring-boot-starter-tomcat为provided依赖否则会因 Servlet API 冲突启动失败。4.2.2 用 curl 验证运单查询接口绕过前端直击后端# 启动应用后执行以下命令假设 MySQL 已插入测试数据 curl -X GET http://localhost:8080/logistics/api/waybills/SF1234567890 \ -H Content-Type: application/json # 预期返回HTTP 200 { code: 200, msg: success, data: { waybillNo: SF1234567890, senderName: 张三, receiverName: 李四, status: 已揽收, updateTime: 2024-06-15T10:30:00 } }若返回{code:500,msg:Internal Server Error}按以下顺序排查查看logs/spring.log中Caused by:后的异常类名若为SQLException: Access denied for user检查application.yml中 MySQL 用户名密码若为Invalid bound statement (not found): com.example.logistics.mapper.WaybillMapper.selectByWaybillNo确认WaybillMapper.xml文件路径是否为src/main/resources/mapper/且文件名与namespace一致。5. 学习进阶技巧用 MyBatis Generator 自动生成基础 CRUD 代码手工编写 Entity、Mapper、XML 对初学者效率极低且易出错。MyBatis GeneratorMBG可根据数据库表结构一键生成 70% 的基础代码让学习者聚焦业务逻辑而非样板代码。5.1 配置 MBG 插件并生成代码在pom.xml的buildplugins中添加plugin groupIdorg.mybatis.generator/groupId artifactIdmybatis-generator-maven-plugin/artifactId version1.4.2/version configuration configurationFilesrc/main/resources/generatorConfig.xml/configurationFile verbosetrue/verbose overwritetrue/overwrite /configuration /plugin创建src/main/resources/generatorConfig.xml?xml version1.0 encodingUTF-8? !DOCTYPE generatorConfiguration PUBLIC -//mybatis.org//DTD MyBatis Generator Configuration 1.0//EN http://mybatis.org/dtd/mybatis-generator-config_1_0.dtd generatorConfiguration context idDB2Tables targetRuntimeMyBatis3 jdbcConnection driverClasscom.mysql.cj.jdbc.Driver connectionURLjdbc:mysql://localhost:3306/logistics_db userIdroot passwordyour_password/ javaModelGenerator targetPackagecom.example.logistics.entity targetProjectsrc/main/java/ sqlMapGenerator targetPackagemapper targetProjectsrc/main/resources/ javaClientGenerator typeXMLMAPPER targetPackagecom.example.logistics.mapper targetProjectsrc/main/java/ table tableNamewaybill domainObjectNameWaybillEntity enableCountByExamplefalse enableUpdateByExamplefalse enableDeleteByExamplefalse enableSelectByExamplefalse selectAllOrderByClauseupdate_time DESC/ /context /generatorConfiguration执行命令生成代码mvn mybatis-generator:generate生成后WaybillEntity自动包含Table注解WaybillMapper接口自带selectByPrimaryKey等方法XML 文件含完整 CRUD SQL。此时只需在WaybillServiceImpl中调用waybillMapper.selectByPrimaryKey(id)即可无需手写 SQL。5.2 验证生成代码的可用性快速添加“运单状态更新”功能利用 MBG 生成的WaybillMapper补充一个更新状态的方法// 在 WaybillMapper.java 中添加 int updateStatus(Param(waybillNo) String waybillNo, Param(status) String status); // 在 WaybillMapper.xml 中添加 update idupdateStatus UPDATE waybill SET status #{status}, update_time NOW() WHERE waybill_no #{waybillNo} /update然后在WaybillService中实现Override Transactional public void updateWaybillStatus(String waybillNo, String status) { int rows waybillMapper.updateStatus(waybillNo, status); if (rows 0) { throw new BusinessException(运单不存在或状态未更新 waybillNo); } }最后用 curl 测试curl -X PUT http://localhost:8080/logistics/api/waybills/SF1234567890/status \ -H Content-Type: application/json \ -d {status:已签收}至此一个具备查询、更新能力的物流快递系统核心模块已可运行。它不追求炫酷前端但每一行代码都对应 Java 面试题中的高频考点MVC 分层职责、Spring 事务传播、MyBatis 一级/二级缓存、MySQL 索引优化、Maven 依赖冲突解决。当你能独立完成这个流程再去看“SpringBoot MyBatis 当表不存在自动建表”这类问题时答案自然浮现——那只是spring.jpa.hibernate.ddl-autocreate的 JPA 行为而本项目用的是原生 MyBatis建表必须手动执行 SQL。本文还有配套的精品资源点击获取 
长河君 · 2026/9/20 22:15:52 · 阅读 1.2k SpringBoot物流系统入门：MVC三层架构实战
简介这是一套完整的物流快递系统SpringBoot实战项目面向Java初学者与课程设计、毕业设计学习者覆盖前后端分离开发全流程帮助掌握MVC三层架构、SpringBoot核心组件及MySQL数据库应用。资源包共640个文件含61个Java业务类如OrdersController、DriversController、InvoiceServiceImpl等、113个XML配置文件、84个CSS与69个JS前端资源、88个PNG和69个JPG界面素材以及SQL建表脚本、演示MP4视频、IDEA工程配置文件等整体73.13MB结构清晰、模块完整。已有910人学习下载适合从零搭建并理解典型电商物流场景下的订单管理、司机调度、网点维护、投诉处理与电子发票生成等核心功能。配套演示视频直观展示系统运行效果源码注释规范Maven依赖明确兼容JDK 1.8、Tomcat 8.5与MySQL 5.7开箱即用是Java Web入门与项目实践的高价值学习材料。1. 一个能跑起来的物流快递系统为什么必须从 SpringBoot MVC 三层架构开始学刚接触 Java Web 开发的人常陷入一个误区直接照着“快递系统”需求文档堆功能结果两周后连登录接口都返回 404。真实情况是——没有清晰分层、不理解 Controller/Service/DAO 各层职责边界、没配对 Maven 依赖与 MySQL 表结构再完整的业务逻辑也跑不起来。这个标题里的“物流快递系统前、后端JavaSpringBootMVC三层架构mavenMysqlTomcat”不是功能罗列而是一套可验证的最小技术栈闭环前端页面发起请求 → SpringBoot 接收并路由 → Service 层编排业务如查运单、改状态→ DAO 层执行 SQL → MySQL 返回数据 → Tomcat 承载整个 Web 应用。它适合两类人一是刚学完 Java 基础、想把“类和对象”真正落地到 Web 场景的初学者二是准备 Java 面试题时需要手写可运行 demo 的求职者——因为面试官真会问“你这个运单查询接口SQL 是在 Service 还是 Mapper 里写的为什么”、“如果数据库连接失败异常是在哪一层捕获的”。本篇不讲抽象理论只带你用最简路径在本地 Windows 或 macOS 上5 分钟内启动一个带运单管理、用户登录、快递员派件的完整系统。2. 搭建 SpringBoot 物流系统骨架Maven 项目初始化与核心依赖配置2.1 用 Spring Initializr 创建标准 Maven 工程非 IDE 插件生成很多新手误以为用 IDEA “New Project → Spring Initializr” 就万事大吉但实际开发中必须手动校验 pom.xml 中的 dependency scope 和版本兼容性。物流系统对事务一致性要求高不能盲目升级 SpringBoot 版本。当前2024 年主流实践推荐使用 SpringBoot 2.7.18LTS 版本它与 MyBatis 3.4.6、MySQL Connector/J 8.0.33 兼容稳定避免出现java.lang.NoClassDefFoundError: org/springframework/boot/autoconfigure/jdbc/DataSourceProperties这类典型依赖冲突。提示不要用 SpringBoot 3.x基于 Jakarta EE 9它默认移除了 javax.servlet会导致 Tomcat 9 无法部署而物流系统教学环境普遍用 Tomcat 9/10强行升级会卡在容器启动阶段。2.1.1 手动创建 pom.xml 关键依赖块可直接复制?xml version1.0 encodingUTF-8? project xmlnshttp://maven.apache.org/POM/4.0.0 xmlns:xsihttp://www.w3.org/2001/XMLSchema-instance xsi:schemaLocationhttp://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd modelVersion4.0.0/modelVersion parent groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-parent/artifactId version2.7.18/version relativePath/ /parent groupIdcom.example/groupId artifactIdlogistics-system/artifactId version0.0.1-SNAPSHOT/version namelogistics-system/name properties java.version1.8/java.version mybatis.version3.4.6/mybatis.version mysql.version8.0.33/mysql.version /properties dependencies !-- Web 核心提供 DispatcherServlet 和 REST 支持 -- dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency !-- 数据访问整合 MyBatis -- dependency groupIdorg.mybatis.spring.boot/groupId artifactIdmybatis-spring-boot-starter/artifactId version${mybatis.version}/version /dependency !-- 数据库驱动 -- dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId version${mysql.version}/version scoperuntime/scope /dependency !-- 数据源连接池HikariCP 内置无需额外引入 -- dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-jdbc/artifactId /dependency !-- Lombok 简化实体类避免手写 getter/setter -- dependency groupIdorg.projectlombok/groupId artifactIdlombok/artifactId optionaltrue/optional /dependency !-- 测试支持 -- dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-test/artifactId scopetest/scope /dependency /dependencies build plugins plugin groupIdorg.springframework.boot/groupId artifactIdspring-boot-maven-plugin/artifactId /plugin /plugins /build /project这段配置的关键点在于scoperuntime/scope明确指定 MySQL 驱动仅在运行时加载编译时不参与避免 IDE 报红optionaltrue/optional声明 Lombok 为可选依赖防止被其他模块意外传递依赖spring-boot-starter-jdbc虽未显式写版本号但由 parent 的spring-boot-starter-parent统一管理确保与 SpringBoot 2.7.18 兼容。2.1.2 初始化目录结构严格遵循 MVC 三层物理分包SpringBoot 不强制目录结构但物流系统必须显式分离职责。在src/main/java/com/example/logistics下建立以下包├── controller // 接收 HTTP 请求只做参数校验和调用 Service ├── service // 业务逻辑编排如运单状态流转校验、派件时间计算 │ ├── impl // Service 接口实现类 ├── mapper // MyBatis Mapper 接口对应 DAO 层 ├── entity // 数据库表映射实体Data TableName ├── dto // 数据传输对象如 LoginDTO、WaybillQueryDTO └── LogisticsSystemApplication.java // 启动类含 SpringBootApplication注意mapper包不能放在controller或service下否则 MyBatis 扫描不到接口entity类必须用TableName(waybill)显式绑定表名避免大小写敏感导致 MySQL 查询失败尤其在 Linux 服务器上。2.2 配置 application.ymlMySQL 连接与 MyBatis 行为控制物流系统对数据库操作有强一致性要求application.yml必须显式配置事务行为和 SQL 日志。以下是最小可用配置非开发环境勿开启show-sqlserver: port: 8080 servlet: context-path: /logistics spring: datasource: url: jdbc:mysql://localhost:3306/logistics_db?useUnicodetruecharacterEncodingUTF-8serverTimezoneAsia/ShanghaiallowPublicKeyRetrievaltrueuseSSLfalse username: root password: your_password_here driver-class-name: com.mysql.cj.jdbc.Driver # MyBatis 配置关键 mybatis: mapper-locations: classpath:mapper/*.xml configuration: log-prefix: com.example.logistics.mapper. map-underscore-to-camel-case: true # 自动转换 user_name → userName # 开启二级缓存物流系统中运单状态变更频繁此处设为 false cache-enabled: false type-aliases-package: com.example.logistics.entity logging: level: com.example.logistics.mapper: DEBUG # 查看实际执行的 SQL参数说明server.servlet.context-path设为/logistics避免与本地其他项目端口冲突serverTimezoneAsia/Shanghai必须设置否则 MySQL 8.0 会报The server time zone value XXX is unrecognizedmap-underscore-to-camel-case: true让 MyBatis 自动将数据库字段receiver_phone映射到 Java 字段receiverPhone省去Results手动映射cache-enabled: false是物流系统的硬性要求运单状态如“已签收”一旦更新所有节点必须实时读取最新值不能走缓存。3. 实现 MVC 三层核心逻辑以“运单查询”为例贯穿 Controller-Service-Mapper3.1 Controller 层定义 RESTful 接口契约与参数校验物流系统接口必须明确输入输出格式。以“根据运单号查询运单详情”为例Controller 只做三件事接收参数、校验合法性、调用 Service。不处理任何 SQL 或业务规则。3.1.1 定义运单查询 DTO 与响应 VO// src/main/java/com/example/logistics/dto/WaybillQueryDTO.java Data public class WaybillQueryDTO { NotBlank(message 运单号不能为空) Pattern(regexp ^SF[0-9]{10}$, message 运单号格式错误SF10位数字) private String waybillNo; } // src/main/java/com/example/logistics/vo/WaybillDetailVO.java Data public class WaybillDetailVO { private String waybillNo; private String senderName; private String receiverName; private String status; // 已揽收, 运输中, 已签收 private LocalDateTime updateTime; }3.1.2 编写 Controller 方法含全局异常处理// src/main/java/com/example/logistics/controller/WaybillController.java RestController RequestMapping(/api/waybills) Slf4j public class WaybillController { Autowired private WaybillService waybillService; GetMapping(/{waybillNo}) public ResultWaybillDetailVO getWaybillDetail(PathVariable String waybillNo) { // 参数校验交由 Valid 完成需在方法参数加 Valid WaybillQueryDTO queryDTO new WaybillQueryDTO(); queryDTO.setWaybillNo(waybillNo); return Result.success(waybillService.getWaybillDetail(queryDTO)); } }提示PathVariable直接绑定 URL 路径变量比RequestParam更符合 REST 规范ResultT是自定义统一响应体含 code/msg/data避免前端反复解析不同结构 JSON。3.2 Service 层封装业务规则与事务边界物流系统的核心复杂度在 Service 层。例如“查询运单”看似简单但需校验运单号是否存在、用户是否有权限查看区分客户/快递员、是否触发风控拦截如高频查询。这些逻辑绝不能写在 Controller 或 Mapper 中。3.2.1 Service 接口与实现类// src/main/java/com/example/logistics/service/WaybillService.java public interface WaybillService { WaybillDetailVO getWaybillDetail(WaybillQueryDTO queryDTO); } // src/main/java/com/example/logistics/service/impl/WaybillServiceImpl.java Service Transactional(rollbackFor Exception.class) Slf4j public class WaybillServiceImpl implements WaybillService { Autowired private WaybillMapper waybillMapper; Override public WaybillDetailVO getWaybillDetail(WaybillQueryDTO queryDTO) { // 1. 校验运单号格式已在 DTO 注解校验此处为二次保险 if (!queryDTO.getWaybillNo().matches(^SF[0-9]{10}$)) { throw new BusinessException(运单号格式非法); } // 2. 查询数据库 WaybillEntity entity waybillMapper.selectByWaybillNo(queryDTO.getWaybillNo()); if (entity null) { throw new BusinessException(未找到运单 queryDTO.getWaybillNo()); } // 3. 构建 VO此处可加入业务计算如预估送达时间 WaybillDetailVO vo new WaybillDetailVO(); vo.setWaybillNo(entity.getWaybillNo()); vo.setSenderName(entity.getSenderName()); vo.setReceiverName(entity.getReceiverName()); vo.setStatus(entity.getStatus()); vo.setUpdateTime(entity.getUpdateTime()); return vo; } }关键点Transactional保证数据库操作原子性若后续加入“查询更新物流轨迹”操作事务自动生效BusinessException是自定义运行时异常被全局异常处理器捕获后返回Result.error()避免暴露堆栈信息所有业务判断如权限校验应在此处添加而非 Mapper 层——Mapper 只负责“增删改查”不负责“能不能查”。3.3 Mapper 层MyBatis XML 映射与 SQL 编写物流系统涉及多表关联运单、收发件人、物流轨迹纯注解方式难以维护。必须使用mapper/*.xml文件编写 SQL并启用resultMap处理复杂映射。3.3.1 创建 WaybillMapper 接口与 XML 文件// src/main/java/com/example/logistics/mapper/WaybillMapper.java Mapper public interface WaybillMapper { WaybillEntity selectByWaybillNo(Param(waybillNo) String waybillNo); }!-- src/main/resources/mapper/WaybillMapper.xml -- ?xml version1.0 encodingUTF-8? !DOCTYPE mapper PUBLIC -//mybatis.org//DTD Mapper 3.0//EN http://mybatis.org/dtd/mybatis-3-mapper.dtd mapper namespacecom.example.logistics.mapper.WaybillMapper resultMap idWaybillResultMap typecom.example.logistics.entity.WaybillEntity id propertyid columnid/ result propertywaybillNo columnwaybill_no/ result propertysenderName columnsender_name/ result propertyreceiverName columnreceiver_name/ result propertystatus columnstatus/ result propertyupdateTime columnupdate_time/ /resultMap select idselectByWaybillNo resultMapWaybillResultMap SELECT id, waybill_no, sender_name, receiver_name, status, update_time FROM waybill WHERE waybill_no #{waybillNo} /select /mapper注意resultMap中property是 Java 字段名column是数据库字段名二者通过map-underscore-to-camel-case: true自动转换但显式声明更安全#{waybillNo}使用预编译参数防止 SQL 注入绝不能写成${waybillNo}。4. 数据库建模与 Tomcat 部署从 MySQL 表结构到可访问的 Web 应用4.1 物流系统核心表设计ER 图关键字段教学用物流系统不必过度设计但必须包含基础实体关系。以下是logistics_db数据库中 3 张核心表的建表语句MySQL 8.0-- 运单主表 CREATE TABLE waybill ( id bigint NOT NULL AUTO_INCREMENT COMMENT 主键ID, waybill_no varchar(20) NOT NULL COMMENT 运单号唯一索引, sender_name varchar(50) NOT NULL COMMENT 寄件人姓名, receiver_name varchar(50) NOT NULL COMMENT 收件人姓名, status enum(已揽收,运输中,派件中,已签收,已拒收) DEFAULT 已揽收 COMMENT 运单状态, update_time datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT 最后更新时间, PRIMARY KEY (id), UNIQUE KEY uk_waybill_no (waybill_no) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT运单主表; -- 用户表区分客户、快递员、管理员 CREATE TABLE user ( id bigint NOT NULL AUTO_INCREMENT, username varchar(50) NOT NULL COMMENT 登录账号, password varchar(100) NOT NULL COMMENT BCrypt 加密密码, role enum(CUSTOMER,COURIER,ADMIN) NOT NULL COMMENT 角色, PRIMARY KEY (id), UNIQUE KEY uk_username (username) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; -- 物流轨迹表运单状态变更历史 CREATE TABLE track_log ( id bigint NOT NULL AUTO_INCREMENT, waybill_no varchar(20) NOT NULL COMMENT 运单号, status varchar(20) NOT NULL COMMENT 当前状态, operator varchar(50) NOT NULL COMMENT 操作人快递员工号, create_time datetime NOT NULL DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), KEY idx_waybill_no (waybill_no) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;关键设计说明waybill_no设为UNIQUE KEY避免重复运单status使用enum类型而非varchar由数据库约束状态值防止 Java 层传入非法字符串track_log表不设外键FOREIGN KEY教学系统为简化部署靠 Java 层逻辑保证数据一致性。4.2 启动 Tomcat 并验证接口可用性SpringBoot 内置 Tomcat但教学场景常需外置部署以理解容器原理。以下步骤验证系统是否真正就绪4.2.1 使用 Maven 打包并部署到独立 Tomcat# 在项目根目录执行 mvn clean package -Dmaven.test.skiptrue # 将 target/logistics-system-0.0.1-SNAPSHOT.jar 复制到 Tomcat webapps 目录 # 注意SpringBoot 默认打包为可执行 jar需修改打包方式才能部署到外置 Tomcat提示若要部署到外置 Tomcat需修改pom.xml将packagingjar/packaging改为packagingwar/packaging并添加spring-boot-starter-tomcat为provided依赖否则会因 Servlet API 冲突启动失败。4.2.2 用 curl 验证运单查询接口绕过前端直击后端# 启动应用后执行以下命令假设 MySQL 已插入测试数据 curl -X GET http://localhost:8080/logistics/api/waybills/SF1234567890 \ -H Content-Type: application/json # 预期返回HTTP 200 { code: 200, msg: success, data: { waybillNo: SF1234567890, senderName: 张三, receiverName: 李四, status: 已揽收, updateTime: 2024-06-15T10:30:00 } }若返回{code:500,msg:Internal Server Error}按以下顺序排查查看logs/spring.log中Caused by:后的异常类名若为SQLException: Access denied for user检查application.yml中 MySQL 用户名密码若为Invalid bound statement (not found): com.example.logistics.mapper.WaybillMapper.selectByWaybillNo确认WaybillMapper.xml文件路径是否为src/main/resources/mapper/且文件名与namespace一致。5. 学习进阶技巧用 MyBatis Generator 自动生成基础 CRUD 代码手工编写 Entity、Mapper、XML 对初学者效率极低且易出错。MyBatis GeneratorMBG可根据数据库表结构一键生成 70% 的基础代码让学习者聚焦业务逻辑而非样板代码。5.1 配置 MBG 插件并生成代码在pom.xml的buildplugins中添加plugin groupIdorg.mybatis.generator/groupId artifactIdmybatis-generator-maven-plugin/artifactId version1.4.2/version configuration configurationFilesrc/main/resources/generatorConfig.xml/configurationFile verbosetrue/verbose overwritetrue/overwrite /configuration /plugin创建src/main/resources/generatorConfig.xml?xml version1.0 encodingUTF-8? !DOCTYPE generatorConfiguration PUBLIC -//mybatis.org//DTD MyBatis Generator Configuration 1.0//EN http://mybatis.org/dtd/mybatis-generator-config_1_0.dtd generatorConfiguration context idDB2Tables targetRuntimeMyBatis3 jdbcConnection driverClasscom.mysql.cj.jdbc.Driver connectionURLjdbc:mysql://localhost:3306/logistics_db userIdroot passwordyour_password/ javaModelGenerator targetPackagecom.example.logistics.entity targetProjectsrc/main/java/ sqlMapGenerator targetPackagemapper targetProjectsrc/main/resources/ javaClientGenerator typeXMLMAPPER targetPackagecom.example.logistics.mapper targetProjectsrc/main/java/ table tableNamewaybill domainObjectNameWaybillEntity enableCountByExamplefalse enableUpdateByExamplefalse enableDeleteByExamplefalse enableSelectByExamplefalse selectAllOrderByClauseupdate_time DESC/ /context /generatorConfiguration执行命令生成代码mvn mybatis-generator:generate生成后WaybillEntity自动包含Table注解WaybillMapper接口自带selectByPrimaryKey等方法XML 文件含完整 CRUD SQL。此时只需在WaybillServiceImpl中调用waybillMapper.selectByPrimaryKey(id)即可无需手写 SQL。5.2 验证生成代码的可用性快速添加“运单状态更新”功能利用 MBG 生成的WaybillMapper补充一个更新状态的方法// 在 WaybillMapper.java 中添加 int updateStatus(Param(waybillNo) String waybillNo, Param(status) String status); // 在 WaybillMapper.xml 中添加 update idupdateStatus UPDATE waybill SET status #{status}, update_time NOW() WHERE waybill_no #{waybillNo} /update然后在WaybillService中实现Override Transactional public void updateWaybillStatus(String waybillNo, String status) { int rows waybillMapper.updateStatus(waybillNo, status); if (rows 0) { throw new BusinessException(运单不存在或状态未更新 waybillNo); } }最后用 curl 测试curl -X PUT http://localhost:8080/logistics/api/waybills/SF1234567890/status \ -H Content-Type: application/json \ -d {status:已签收}至此一个具备查询、更新能力的物流快递系统核心模块已可运行。它不追求炫酷前端但每一行代码都对应 Java 面试题中的高频考点MVC 分层职责、Spring 事务传播、MyBatis 一级/二级缓存、MySQL 索引优化、Maven 依赖冲突解决。当你能独立完成这个流程再去看“SpringBoot MyBatis 当表不存在自动建表”这类问题时答案自然浮现——那只是spring.jpa.hibernate.ddl-autocreate的 JPA 行为而本项目用的是原生 MyBatis建表必须手动执行 SQL。本文还有配套的精品资源点击获取