尧图网页设计 
简介基于Spring Boot与Thymeleaf的高校教材征订管理系统毕业设计源码面向Java后端初学者与毕业设计开发者覆盖教材征订、领书管理、订书管理、系统管理及特殊处理等核心业务流程模块划分清晰可直接参考其页面交互与功能设计。包内共601个文件包括28个Java类、105个XML配置与MyBatis映射、23个HTML页面、101个JS脚本、18个CSS样式以及大量PNG/JPG界面截图后端Controller、Service、Dao与Thymeleaf模板一一对应并附带多套样式皮肤与图标素材便于快速理解页面渲染逻辑或更换前端风格。压缩包仅3.29MB目录结构规整导入IDE即可运行调试。当前已有769人学习浏览借助完整项目代码可理解Spring Boot整合Thymeleaf的典型开发方式从数据表设计、接口编写、业务逻辑到页面渲染的全流程都能快速梳理也适合作为高校教材征订类毕业设计二次开发的模板。1. 高校教材征订管理系统一条从数据建模到状态机落地的完整SpringBoot链路每个学期的教材征订窗口期高校教材科都要处理一次典型的信息协调难题教务处下发通知学院教务员收集任课教师选用的教材汇总成计划表再经教材科审核后向供应商报订。这个过程一旦依赖 Excel 和邮件来回传递就会出现模板结构不一致、明细被误删、版本覆盖导致漏订错订而且事后难以追溯是谁在什么时间改了什么。SpringBoot 高校教材征订管理系统正是把这一场景固化成管理后台的经典题目技术栈主流、业务边界清晰又恰好覆盖 Spring MVC、MyBatis、事务、权限、状态流转这些 Java 面试题里的高频考点。它不涉及微服务和消息队列但对准备校招、需要完整项目经历来复盘的开发者来说是一个能本地跑通、能讲清楚设计的可靠起点。2. 技术选型与SpringBoot项目初始化先定版本再搭骨架2.1 为什么是SpringBoot对比SSH的优势与版本选择SSH 和 SSM 时代一个数据源配置要分散在三四份 XML 里启动前还要单独安装 Tomcat改一次依赖版本就可能引出一串 jar 包冲突。SpringBoot 的起步依赖把 web、aop、validation 这些常用组件的版本统一固定自动配置屏蔽了 DispatcherServlet、SqlSessionFactory、数据源的装配细节内嵌 Tomcat 也让本地开发与服务器部署保持同一套启动方式。对教材征订系统这类以 CRUD 为核心的管理后台SpringBoot 提供的价值主要集中在开发效率和部署一致性上而不是运行时性能。版本选择有一条现实原则先确认本机 JDK再决定用哪个 SpringBoot 版本。近期很多springboot版本太高的报错根源就是 3.x 基线要求 JDK 17而机器上还是 JDK 8启动阶段直接 ClassNotFoundException部分第三方 starter 也没跟上 3.x 的模块化调整。做毕设或内部系统我一般选 2.7.18 搭配 JDK 8资料多、踩坑记录全如果本机已经是 JDK 17 及以上可以上 3.2.x但要注意 mybatis-plus 分页插件等组件的兼容适配。2.2 Maven依赖与分层目录一份最小可运行组合教材征订系统的依赖不需要铺很多核心是 web、mybatis-plus、mysql 驱动、lombok、validation 五件套。parent groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-parent/artifactId version2.7.18/version relativePath/ /parent dependencies dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency dependency groupIdcom.baomidou/groupId artifactIdmybatis-plus-boot-starter/artifactId version3.5.3.2/version /dependency dependency groupIdcom.mysql/groupId artifactIdmysql-connector-j/artifactId scoperuntime/scope /dependency dependency groupIdorg.projectlombok/groupId artifactIdlombok/artifactId optionaltrue/optional /dependency dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-validation/artifactId /dependency /dependencies这份依赖的用途可以压成一张表方便后续替换版本时对照依赖作用注意事项spring-boot-starter-web内嵌 Tomcat、Spring MVC、JSON 序列化提供 REST 接口能力mybatis-plus-boot-starterMyBatis 增强与 Spring Boot 自动装配自带分页、逻辑删除、乐观锁插件mysql-connector-jMySQL JDBC 驱动8.x 驱动类为 com.mysql.cj.jdbc.Driverlombok编译期生成 getter/setter/Builder减少实体类模板代码spring-boot-starter-validationJSR-303 参数校验用于登录和明细导入的 DTO 校验选型理由上mybatis-plus-boot-starter 同时引入 mybatis 与 spring 集成省掉了手动注册 Mapper 扫描配置的步骤单表操作也无需写 XML。目录结构保持官方推荐方式controller 只做参数接收与响应包装service 承载事务和业务规则mapper 只管数据读写entity 与表字段一一对应common 放统一返回体、异常处理与工具类。征订系统最容易出问题的批次提交后明细不可改审核通过后才能生成订单这类规则必须收敛在 service 层散落到 controller 后期加角色时就会失控。2.3 application.yml必配参数数据源、驼峰映射与SQL日志server: port: 8080 spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/textbook_order?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghairewriteBatchedStatementstrueuseSSLfalse username: root password: ${DB_PASSWORD:root123} mybatis-plus: configuration: map-underscore-to-camel-case: true log-impl: org.apache.ibatis.logging.stdout.StdOutImpl global-config: db-config: logic-delete-field: deleted logic-delete-value: 1 logic-not-delete-value: 0 logging: level: com.example.textbook.mapper: debug几个参数必须说明白。serverTimezoneAsia/Shanghai 不写MySQL 8.0 驱动在写入 DATETIME 时可能直接报时区错误或者出现与本地时间相差 8 小时的现象rewriteBatchedStatementstrue 是第三章批量导入的性能闸门没有它 saveBatch 只会逐条 insertmap-underscore-to-camel-case 开启后数据库字段 enroll_item 自动映射到实体属性 enrollItem省掉每张表的 resultMap。密码用 ${DB_PASSWORD:root123} 占位符本地开发不设环境变量就回退到 root123打包部署时通过系统环境变量注入真实口令避免源码仓库里出现硬编码密码。log-impl 配成 StdOutImpl控制台会直接打印带真实参数值的 SQL排查 UpdateWrapper 的条件是否完整时非常直观。提示mybatis-plus 3.5.3 之后的版本需要显式声明 PaginationInnerInterceptor否则 Page 对象查询后 total 始终为 0。这个点也常出现在 SpringBoot 面试题的分页插件原理追问里。3. 数据库建模与征订核心业务四张表串起完整征订链路3.1 表结构设计教材、批次、明细、订单的取舍一本教材可以被多个学院的多门课程同时选用一个学期的一次征订会产出成千上万条明细只有全部审核确认后才形成采购订单。如果只做教材表 征订记录表两表结构后续要复用教材信息、按批次查询历史征订、对账供应商订单都会变得别扭。常规设计是拆四张表book_info 管教材字典enroll_plan 管征订批次enroll_item 管每一条征订明细purchase_order 管最终采购订单。CREATE TABLE book_info ( id BIGINT AUTO_INCREMENT PRIMARY KEY, isbn VARCHAR(32) NOT NULL COMMENT ISBN, book_name VARCHAR(128) NOT NULL, author VARCHAR(64), publisher VARCHAR(64), price DECIMAL(10,2), deleted TINYINT DEFAULT 0, UNIQUE KEY uk_isbn (isbn) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE enroll_plan ( id BIGINT AUTO_INCREMENT PRIMARY KEY, plan_name VARCHAR(128) NOT NULL, term VARCHAR(32) NOT NULL COMMENT 学期如2025-2026-1, start_time DATETIME, end_time DATETIME, status VARCHAR(20) NOT NULL DEFAULT DRAFT, version INT DEFAULT 0, deleted TINYINT DEFAULT 0 ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE enroll_item ( id BIGINT AUTO_INCREMENT PRIMARY KEY, plan_id BIGINT NOT NULL, course_name VARCHAR(128) NOT NULL, book_id BIGINT NOT NULL, college VARCHAR(64) COMMENT 学院, teacher VARCHAR(32), student_count INT DEFAULT 0, status VARCHAR(20) DEFAULT DRAFT, version INT DEFAULT 0, deleted TINYINT DEFAULT 0, KEY idx_plan (plan_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE purchase_order ( id BIGINT AUTO_INCREMENT PRIMARY KEY, plan_id BIGINT NOT NULL, supplier VARCHAR(64), total_amount DECIMAL(12,2), order_no VARCHAR(64), created_time DATETIME DEFAULT CURRENT_TIMESTAMP, deleted TINYINT DEFAULT 0 ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;设计意图要放在业务里看。enroll_plan 承担征订批次term 字段表示学期status 字段与第四章状态机对应enroll_item 只记录业务事实课程名、教材、学院、教师、学生数不掺物流和库存字段purchase_order 在计划确认后才生成order_no 用程序生成而非自增主键方便对接采购对账。version 和 deleted 字段分别服务乐观锁与逻辑删除前者在第四章演示后者保证过期征订数据不直接物理消失。字符集统一 utf8mb4否则中文备注和教材名在部分字符集下会乱码。3.2 MyBatis Plus 实体、Mapper 与 LambdaQueryWrapper 的正确写法实体类要遵循两条约定字段与表列名一一对应不把非表字段塞进去。常见犯错是把 statusText 这类展示字段直接写在实体里MyBatis 生成的 SQL 会多出这一列启动或查询时报 BadSqlGrammar。如果有冗余展示需求用 TableField(exist false) 显式排除。TableId(type IdType.AUTO) 对应自增主键Version 和 TableLogic 分别激活乐观锁与逻辑删除。Data TableName(enroll_item) public class EnrollItem { TableId(type IdType.AUTO) private Long id; private Long planId; private String courseName; private Long bookId; private String college; private String teacher; private Integer studentCount; TableField(status) private String status; Version private Integer version; TableLogic private Integer deleted; }Mapper 接口继承 BaseMapper 后单表增删改查与分页方法开箱即用。跨表 join 则放到 resources/mapper 下的 XML 中XML 的 namespace 必须与 Mapper 接口的全限定名完全一致否则启动报 Invalid bound statement。查询条件推荐用 LambdaQueryWrapper方法引用的写法在编译期就能发现字段名拼写错误例如 EnrollItem::getCollege 打错了IDE 直接标红而字符串 college 拼错只能等到运行时才暴露。Mapper public interface EnrollItemMapper extends BaseMapperEnrollItem { }ListEnrollItem list enrollItemMapper.selectList( new LambdaQueryWrapperEnrollItem() .eq(EnrollItem::getPlanId, planId) .eq(EnrollItem::getCollege, college) .eq(EnrollItem::getStatus, CONFIRMED) .orderByAsc(EnrollItem::getCourseName));注意 eq 的边界传 null 值时会拼接 IS NULL而不是忽略条件。实现可选查询时要配合条件重载写成 wrapper.eq(StringUtils.isNotBlank(college), EnrollItem::getCollege, college)前端不传学院时这一条件就不会拼进 SQL。这个细节在多人协作的查询接口里很容易被忽略也是我在接手项目时第一个检查的地方。3.3 批量导入与 saveBatch 实测调优征订明细的写入特征是低频大批量一个窗口几千条数据典型来自 Excel 导入或页面逐条录入。明确一个结论MyBatis Plus 的 saveBatch 底层走的是 JDBC 批量提交但只有在数据源连接串打开 rewriteBatchedStatementstrue 时MySQL 驱动才会把多条 insert 合并为多值 insert这是性能差一个数量级的关键。Transactional(rollbackFor Exception.class) public boolean importItems(Long planId, ListEnrollItem items) { EnrollPlan plan enrollPlanMapper.selectById(planId); if (plan null || !DRAFT.equals(plan.getStatus())) { throw new BizException(当前批次不在可编辑状态); } int pageSize 1000; for (int i 0; i items.size(); i pageSize) { ListEnrollItem sub items.subList(i, Math.min(i pageSize, items.size())); enrollItemMapper.saveBatch(sub); } return true; }这段代码有几个参数值得留神。Transactional 保证整批导入要么全部成功要么全部回滚避免导入一半后用户刷新页面看到半个批次的脏数据pageSize 取 1000 是平衡网络往返与事务大小的常见值低于 500 时请求次数偏多高于 2000 时单事务过大回滚成本也随之上升saveBatch 每次传入子列表MP 内部会自动分批执行。导入前必须校验计划状态这既是对业务规则的守护也是后面审批状态机能成立的先决条件。4. 征订审批与状态流转轻量状态机的设计与边界4.1 为什么必须引入状态Excel时代的漏订与重订教材征订最容易翻车的点不在录入而在流转。Excel 汇总时代教务员和教材科各自维护一份文件模板结构被改动、明细被误删、版本覆盖都是常见事故。把流程搬进系统后稳定性不取决于界面做得多好看而取决于两条原则当前数据处于什么状态是显式存储在字段里的从状态 A 到状态 B 必须经过唯一的操作入口。这两条做到漏订和重订就能在数据层面被及时发现。这个思路不只是针对教材征订凡是先填后审、审完再执行的业务都可以用这套模型。4.2 状态枚举与流转规则表状态字段用字符串存库但代码里不能到处写字符串比较。枚举能内聚流转合法性检查常量类做不到。五个主状态加一个终态足够覆盖高校征订的完整流程public enum PlanStatus { DRAFT(草稿), SUBMITTED(已提交), AUDITING(审核中), CONFIRMED(已确认), GENERATED(已生成订单), CANCELED(已取消); private final String desc; PlanStatus(String desc) { this.desc desc; } public String getDesc() { return desc; } }流转规则用表格明确后续给不同角色做按钮权限时可以直接对照当前状态允许操作操作后状态操作角色DRAFT编辑明细、提交SUBMITTED学院教务员SUBMITTED审核通过、驳回AUDITING、DRAFT教材科管理员AUDITING确认、取消CONFIRMED、CANCELED教务处管理员CONFIRMED生成订单GENERATED管理员GENERATED查看、导出GENERATED被授权用户把已提交和审核中拆成两段是为了区分谁提交了材料和谁正在处理同时让审计日志能记录到两个不同的动作节点。驳回时批次回到 DRAFT但明细数据保留用户不需要重新录一遍这是征订系统里非常关键的用户体验细节。4.3 审批更新与并发控制用 update where 代替 select then update审批最怕重复点击。前端按钮禁用只能挡住一部分误操作后端并发情况下两个管理员同时审批同一份计划如果都执行无条件 update后提交的人会覆盖先提交的人而审计记录前后矛盾。常规解法是让更新语句自带条件把期望的当前状态写进 where受影响行数为 0 就说明状态已被别的事务改过。Transactional(rollbackFor Exception.class) public boolean auditPlan(Long planId, String userId, boolean pass) { String target pass ? AUDITING : DRAFT; UpdateWrapperEnrollPlan wrapper new UpdateWrapper(); wrapper.eq(id, planId) .eq(status, SUBMITTED) .eq(deleted, 0); EnrollPlan update new EnrollPlan(); update.setStatus(target); int rows enrollPlanMapper.update(update, wrapper); if (rows 0) { throw new BizException(批次状态已变更请刷新后重试); } auditLogService.record(userId, planId, AUDIT, target); return true; }这里刻意没有用 Version 乐观锁。审批是低频操作用 status 字段本身做条件比维护 version 更直观也更容易在 SQL 日志里确认Version 更适合明细行那种被多角色频繁编辑的写冲突场景。审计日志必须和状态更新在同一个事务里否则状态没改成但日志已入库给后续排查造成误导。update...where 本身是原子操作不需要把 select 和 update 拆开再包一层事务隔离这是与普通先查再改写法的本质区别。5. 权限控制与安全配置拦截器、BCrypt与配置密文5.1 权限模型取舍不引入Spring Security的现实理由征订系统的角色是学院教务员、教材科管理员、教务处管理员、系统管理员权限差异集中在谁能编辑、谁能审批、谁能取消粒度到接口级已经足够。引入 Spring Security 的代价是过滤器链、认证管理器、会话并发控制这些概念会盖过业务本身答辩被问为什么上这么重的框架反而难答。我一般用 HandlerInterceptor 做登录拦截配一个角色判断工具已经能挡住绝大多数越权请求。如果后续要上 JWT、OAuth2 或第三方登录再迁移到 Spring Security 和 Sa-Token 不迟。两种方案的边界列成表更直观方案适用规模学习成本扩展性自定义拦截器角色少、接口级权限低需自行维护白名单与角色注解Spring Security多角色、JWT、OAuth2高生态完整迁移方便5.2 登录拦截器与角色校验的具体写法拦截器只做两件事判断请求路径是否放行检查会话里是否有已登录用户。硬编码白名单适合小项目路径多了要收敛成常量集合。public class AuthInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { if (request.getRequestURI().startsWith(/api/auth/login)) { return true; } UserInfo user (UserInfo) request.getSession() .getAttribute(loginUser); if (user null) { response.setStatus(401); response.setContentType(application/json;charsetUTF-8); response.getWriter().write({\code\:401,\msg\:\未登录\}); return false; } request.setAttribute(currentUser, user); return true; } }注册拦截器时注意路径规则的写法/** 会拦住静态资源需要用 excludePathPatterns 把登录接口和静态目录放出去。Configuration public class WebConfig implements WebMvcConfigurer { Autowired private AuthInterceptor authInterceptor; Override public void addInterceptors(InterceptorRegistry registry) { registry.addInterceptor(authInterceptor) .addPathPatterns(/api/**) .excludePathPatterns(/api/auth/login); } }角色校验放在 Service 层入口用一个 requireRole 工具方法显式调用比在 controller 堆注解更透明审计日志也方便记录操作者角色。业务规则教材科管理员不能取消已确认的计划在 service 方法第一行就可见新人接手时不需要去翻注解定义。5.3 密码存储与yml密文两张必补的安全短板密码不能明文入库也不能用 MD5。BCrypt 每次随机生成盐相同密码产生不同哈希撞库成本显著提高。Spring Security 的 crypto 模块可以独立使用不依赖完整过滤器链。public class PasswordUtil { private static final BCryptPasswordEncoder ENCODER new BCryptPasswordEncoder(); public static String encrypt(String rawPassword) { return ENCODER.encode(rawPassword); } public static boolean match(String rawPassword, String encodedPassword) { return ENCODER.matches(rawPassword, encodedPassword); } }数据源密码不写明文进 yml 也是安全底线。常见做法是引入 jasypt-spring-boot-starter配置文件里写 ENC(加密串)启动时通过 JVM 参数注入密钥。加密命令为 java -cp jasypt-1.9.3.jar org.jasypt.intf.cli.JasyptPBEStringEncryptionCLI inputroot123 password密钥 algorithmPBEWithMD5AndDES生成的密文填进 yml启动时加 -Djasypt.encryptor.password密钥。这样即使配置仓库被拉取数据库口令也不会直接暴露。提示jasypt 3.x 默认算法改为 PBEWITHHMACSHA512ANDAES_256生成密文时要与依赖版本一致2.x 参数在新版本运行时会直接抛 DecryptionException。6. 打包部署与常见报错一次跑通征订主链路的验证技巧6.1 Maven打包与启动命令mvn clean package -DskipTests java -jar target/textbook-order-0.0.1-SNAPSHOT.jar \ --server.port8081 \ --spring.profiles.activeprod第一步先确认 java -version 和 mvn -v 输出的 JDK 版本与项目要求一致很多启动失败在环境变量阶段就能拦住。打包跳过测试是为了避免示例测试类影响构建速度启动时看到 Tomcat started on port(s) 8080 才算真正起来。端口被占用时用 --server.port 临时换端口不需要改配置文件。6.2 高频报错排查表报错关键字高频原因处理路径Could not create connection to database serverMySQL 未启动或端口不对检查 3306 端口改 url 中的地址The server time zone value数据源 url 缺时区参数加 serverTimezoneAsia/ShanghaiClassNotFoundException: com.mysql.jdbc.Driver驱动版本与驱动类不匹配8.x 用 com.mysql.cj.jdbc.DriverInvalid bound statement (not found)XML namespace 与接口不一致核对 namespace 为接口全限定名Error attempting to get column from result set字段类型映射失败检查 DECIMAL 与 BigDecimal 对应自动建表后中文乱码建表字符集不是 utf8mb4用脚本建表不用自动建表自动建表是个容易踩的隐形坑。部分源码依赖 spring.sql.init 启动建表但数据库默认字符集一旦不是 utf8mb4中文备注会乱码字段顺序也不可控。建表 SQL 应该纳入 Git 管理应用只负责读写不负责维护结构。6.3 用curl链路验证状态机是否真实生效页面点完一遍不等于流程正确用 curl 走一遍登录、审核、确认链路再回看服务端 SQL 日志能快速判断状态机是否真实生效。curl -c cookie.txt -X POST http://localhost:8080/api/auth/login \ -H Content-Type: application/json \ -d {account:admin,password:123456} curl -b cookie.txt -X POST http://localhost:8080/api/plan/audit \ -H Content-Type: application/json \ -d {planId:1,pass:true}第二条命令执行后服务端日志应出现 UPDATE enroll_plan SET statusAUDITING WHERE id1 AND statusSUBMITTED一旦 where 条件里没有 status就是 UpdateWrapper 没生效并发下必然出现覆盖更新。验证完状态流转再按时间倒序查一次审计表确认每次变更都有记录。这组操作全部通过后这套征订管理系统的主干链路才算真正可演示而不是一个能打开登录页的壳子。本文还有配套的精品资源点击获取 SpringBoot高校教材征订管理系统：从建模到状态机落地
简介基于Spring Boot与Thymeleaf的高校教材征订管理系统毕业设计源码面向Java后端初学者与毕业设计开发者覆盖教材征订、领书管理、订书管理、系统管理及特殊处理等核心业务流程模块划分清晰可直接参考其页面交互与功能设计。包内共601个文件包括28个Java类、105个XML配置与MyBatis映射、23个HTML页面、101个JS脚本、18个CSS样式以及大量PNG/JPG界面截图后端Controller、Service、Dao与Thymeleaf模板一一对应并附带多套样式皮肤与图标素材便于快速理解页面渲染逻辑或更换前端风格。压缩包仅3.29MB目录结构规整导入IDE即可运行调试。当前已有769人学习浏览借助完整项目代码可理解Spring Boot整合Thymeleaf的典型开发方式从数据表设计、接口编写、业务逻辑到页面渲染的全流程都能快速梳理也适合作为高校教材征订类毕业设计二次开发的模板。1. 高校教材征订管理系统一条从数据建模到状态机落地的完整SpringBoot链路每个学期的教材征订窗口期高校教材科都要处理一次典型的信息协调难题教务处下发通知学院教务员收集任课教师选用的教材汇总成计划表再经教材科审核后向供应商报订。这个过程一旦依赖 Excel 和邮件来回传递就会出现模板结构不一致、明细被误删、版本覆盖导致漏订错订而且事后难以追溯是谁在什么时间改了什么。SpringBoot 高校教材征订管理系统正是把这一场景固化成管理后台的经典题目技术栈主流、业务边界清晰又恰好覆盖 Spring MVC、MyBatis、事务、权限、状态流转这些 Java 面试题里的高频考点。它不涉及微服务和消息队列但对准备校招、需要完整项目经历来复盘的开发者来说是一个能本地跑通、能讲清楚设计的可靠起点。2. 技术选型与SpringBoot项目初始化先定版本再搭骨架2.1 为什么是SpringBoot对比SSH的优势与版本选择SSH 和 SSM 时代一个数据源配置要分散在三四份 XML 里启动前还要单独安装 Tomcat改一次依赖版本就可能引出一串 jar 包冲突。SpringBoot 的起步依赖把 web、aop、validation 这些常用组件的版本统一固定自动配置屏蔽了 DispatcherServlet、SqlSessionFactory、数据源的装配细节内嵌 Tomcat 也让本地开发与服务器部署保持同一套启动方式。对教材征订系统这类以 CRUD 为核心的管理后台SpringBoot 提供的价值主要集中在开发效率和部署一致性上而不是运行时性能。版本选择有一条现实原则先确认本机 JDK再决定用哪个 SpringBoot 版本。近期很多springboot版本太高的报错根源就是 3.x 基线要求 JDK 17而机器上还是 JDK 8启动阶段直接 ClassNotFoundException部分第三方 starter 也没跟上 3.x 的模块化调整。做毕设或内部系统我一般选 2.7.18 搭配 JDK 8资料多、踩坑记录全如果本机已经是 JDK 17 及以上可以上 3.2.x但要注意 mybatis-plus 分页插件等组件的兼容适配。2.2 Maven依赖与分层目录一份最小可运行组合教材征订系统的依赖不需要铺很多核心是 web、mybatis-plus、mysql 驱动、lombok、validation 五件套。parent groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-parent/artifactId version2.7.18/version relativePath/ /parent dependencies dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency dependency groupIdcom.baomidou/groupId artifactIdmybatis-plus-boot-starter/artifactId version3.5.3.2/version /dependency dependency groupIdcom.mysql/groupId artifactIdmysql-connector-j/artifactId scoperuntime/scope /dependency dependency groupIdorg.projectlombok/groupId artifactIdlombok/artifactId optionaltrue/optional /dependency dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-validation/artifactId /dependency /dependencies这份依赖的用途可以压成一张表方便后续替换版本时对照依赖作用注意事项spring-boot-starter-web内嵌 Tomcat、Spring MVC、JSON 序列化提供 REST 接口能力mybatis-plus-boot-starterMyBatis 增强与 Spring Boot 自动装配自带分页、逻辑删除、乐观锁插件mysql-connector-jMySQL JDBC 驱动8.x 驱动类为 com.mysql.cj.jdbc.Driverlombok编译期生成 getter/setter/Builder减少实体类模板代码spring-boot-starter-validationJSR-303 参数校验用于登录和明细导入的 DTO 校验选型理由上mybatis-plus-boot-starter 同时引入 mybatis 与 spring 集成省掉了手动注册 Mapper 扫描配置的步骤单表操作也无需写 XML。目录结构保持官方推荐方式controller 只做参数接收与响应包装service 承载事务和业务规则mapper 只管数据读写entity 与表字段一一对应common 放统一返回体、异常处理与工具类。征订系统最容易出问题的批次提交后明细不可改审核通过后才能生成订单这类规则必须收敛在 service 层散落到 controller 后期加角色时就会失控。2.3 application.yml必配参数数据源、驼峰映射与SQL日志server: port: 8080 spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/textbook_order?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghairewriteBatchedStatementstrueuseSSLfalse username: root password: ${DB_PASSWORD:root123} mybatis-plus: configuration: map-underscore-to-camel-case: true log-impl: org.apache.ibatis.logging.stdout.StdOutImpl global-config: db-config: logic-delete-field: deleted logic-delete-value: 1 logic-not-delete-value: 0 logging: level: com.example.textbook.mapper: debug几个参数必须说明白。serverTimezoneAsia/Shanghai 不写MySQL 8.0 驱动在写入 DATETIME 时可能直接报时区错误或者出现与本地时间相差 8 小时的现象rewriteBatchedStatementstrue 是第三章批量导入的性能闸门没有它 saveBatch 只会逐条 insertmap-underscore-to-camel-case 开启后数据库字段 enroll_item 自动映射到实体属性 enrollItem省掉每张表的 resultMap。密码用 ${DB_PASSWORD:root123} 占位符本地开发不设环境变量就回退到 root123打包部署时通过系统环境变量注入真实口令避免源码仓库里出现硬编码密码。log-impl 配成 StdOutImpl控制台会直接打印带真实参数值的 SQL排查 UpdateWrapper 的条件是否完整时非常直观。提示mybatis-plus 3.5.3 之后的版本需要显式声明 PaginationInnerInterceptor否则 Page 对象查询后 total 始终为 0。这个点也常出现在 SpringBoot 面试题的分页插件原理追问里。3. 数据库建模与征订核心业务四张表串起完整征订链路3.1 表结构设计教材、批次、明细、订单的取舍一本教材可以被多个学院的多门课程同时选用一个学期的一次征订会产出成千上万条明细只有全部审核确认后才形成采购订单。如果只做教材表 征订记录表两表结构后续要复用教材信息、按批次查询历史征订、对账供应商订单都会变得别扭。常规设计是拆四张表book_info 管教材字典enroll_plan 管征订批次enroll_item 管每一条征订明细purchase_order 管最终采购订单。CREATE TABLE book_info ( id BIGINT AUTO_INCREMENT PRIMARY KEY, isbn VARCHAR(32) NOT NULL COMMENT ISBN, book_name VARCHAR(128) NOT NULL, author VARCHAR(64), publisher VARCHAR(64), price DECIMAL(10,2), deleted TINYINT DEFAULT 0, UNIQUE KEY uk_isbn (isbn) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE enroll_plan ( id BIGINT AUTO_INCREMENT PRIMARY KEY, plan_name VARCHAR(128) NOT NULL, term VARCHAR(32) NOT NULL COMMENT 学期如2025-2026-1, start_time DATETIME, end_time DATETIME, status VARCHAR(20) NOT NULL DEFAULT DRAFT, version INT DEFAULT 0, deleted TINYINT DEFAULT 0 ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE enroll_item ( id BIGINT AUTO_INCREMENT PRIMARY KEY, plan_id BIGINT NOT NULL, course_name VARCHAR(128) NOT NULL, book_id BIGINT NOT NULL, college VARCHAR(64) COMMENT 学院, teacher VARCHAR(32), student_count INT DEFAULT 0, status VARCHAR(20) DEFAULT DRAFT, version INT DEFAULT 0, deleted TINYINT DEFAULT 0, KEY idx_plan (plan_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE purchase_order ( id BIGINT AUTO_INCREMENT PRIMARY KEY, plan_id BIGINT NOT NULL, supplier VARCHAR(64), total_amount DECIMAL(12,2), order_no VARCHAR(64), created_time DATETIME DEFAULT CURRENT_TIMESTAMP, deleted TINYINT DEFAULT 0 ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;设计意图要放在业务里看。enroll_plan 承担征订批次term 字段表示学期status 字段与第四章状态机对应enroll_item 只记录业务事实课程名、教材、学院、教师、学生数不掺物流和库存字段purchase_order 在计划确认后才生成order_no 用程序生成而非自增主键方便对接采购对账。version 和 deleted 字段分别服务乐观锁与逻辑删除前者在第四章演示后者保证过期征订数据不直接物理消失。字符集统一 utf8mb4否则中文备注和教材名在部分字符集下会乱码。3.2 MyBatis Plus 实体、Mapper 与 LambdaQueryWrapper 的正确写法实体类要遵循两条约定字段与表列名一一对应不把非表字段塞进去。常见犯错是把 statusText 这类展示字段直接写在实体里MyBatis 生成的 SQL 会多出这一列启动或查询时报 BadSqlGrammar。如果有冗余展示需求用 TableField(exist false) 显式排除。TableId(type IdType.AUTO) 对应自增主键Version 和 TableLogic 分别激活乐观锁与逻辑删除。Data TableName(enroll_item) public class EnrollItem { TableId(type IdType.AUTO) private Long id; private Long planId; private String courseName; private Long bookId; private String college; private String teacher; private Integer studentCount; TableField(status) private String status; Version private Integer version; TableLogic private Integer deleted; }Mapper 接口继承 BaseMapper 后单表增删改查与分页方法开箱即用。跨表 join 则放到 resources/mapper 下的 XML 中XML 的 namespace 必须与 Mapper 接口的全限定名完全一致否则启动报 Invalid bound statement。查询条件推荐用 LambdaQueryWrapper方法引用的写法在编译期就能发现字段名拼写错误例如 EnrollItem::getCollege 打错了IDE 直接标红而字符串 college 拼错只能等到运行时才暴露。Mapper public interface EnrollItemMapper extends BaseMapperEnrollItem { }ListEnrollItem list enrollItemMapper.selectList( new LambdaQueryWrapperEnrollItem() .eq(EnrollItem::getPlanId, planId) .eq(EnrollItem::getCollege, college) .eq(EnrollItem::getStatus, CONFIRMED) .orderByAsc(EnrollItem::getCourseName));注意 eq 的边界传 null 值时会拼接 IS NULL而不是忽略条件。实现可选查询时要配合条件重载写成 wrapper.eq(StringUtils.isNotBlank(college), EnrollItem::getCollege, college)前端不传学院时这一条件就不会拼进 SQL。这个细节在多人协作的查询接口里很容易被忽略也是我在接手项目时第一个检查的地方。3.3 批量导入与 saveBatch 实测调优征订明细的写入特征是低频大批量一个窗口几千条数据典型来自 Excel 导入或页面逐条录入。明确一个结论MyBatis Plus 的 saveBatch 底层走的是 JDBC 批量提交但只有在数据源连接串打开 rewriteBatchedStatementstrue 时MySQL 驱动才会把多条 insert 合并为多值 insert这是性能差一个数量级的关键。Transactional(rollbackFor Exception.class) public boolean importItems(Long planId, ListEnrollItem items) { EnrollPlan plan enrollPlanMapper.selectById(planId); if (plan null || !DRAFT.equals(plan.getStatus())) { throw new BizException(当前批次不在可编辑状态); } int pageSize 1000; for (int i 0; i items.size(); i pageSize) { ListEnrollItem sub items.subList(i, Math.min(i pageSize, items.size())); enrollItemMapper.saveBatch(sub); } return true; }这段代码有几个参数值得留神。Transactional 保证整批导入要么全部成功要么全部回滚避免导入一半后用户刷新页面看到半个批次的脏数据pageSize 取 1000 是平衡网络往返与事务大小的常见值低于 500 时请求次数偏多高于 2000 时单事务过大回滚成本也随之上升saveBatch 每次传入子列表MP 内部会自动分批执行。导入前必须校验计划状态这既是对业务规则的守护也是后面审批状态机能成立的先决条件。4. 征订审批与状态流转轻量状态机的设计与边界4.1 为什么必须引入状态Excel时代的漏订与重订教材征订最容易翻车的点不在录入而在流转。Excel 汇总时代教务员和教材科各自维护一份文件模板结构被改动、明细被误删、版本覆盖都是常见事故。把流程搬进系统后稳定性不取决于界面做得多好看而取决于两条原则当前数据处于什么状态是显式存储在字段里的从状态 A 到状态 B 必须经过唯一的操作入口。这两条做到漏订和重订就能在数据层面被及时发现。这个思路不只是针对教材征订凡是先填后审、审完再执行的业务都可以用这套模型。4.2 状态枚举与流转规则表状态字段用字符串存库但代码里不能到处写字符串比较。枚举能内聚流转合法性检查常量类做不到。五个主状态加一个终态足够覆盖高校征订的完整流程public enum PlanStatus { DRAFT(草稿), SUBMITTED(已提交), AUDITING(审核中), CONFIRMED(已确认), GENERATED(已生成订单), CANCELED(已取消); private final String desc; PlanStatus(String desc) { this.desc desc; } public String getDesc() { return desc; } }流转规则用表格明确后续给不同角色做按钮权限时可以直接对照当前状态允许操作操作后状态操作角色DRAFT编辑明细、提交SUBMITTED学院教务员SUBMITTED审核通过、驳回AUDITING、DRAFT教材科管理员AUDITING确认、取消CONFIRMED、CANCELED教务处管理员CONFIRMED生成订单GENERATED管理员GENERATED查看、导出GENERATED被授权用户把已提交和审核中拆成两段是为了区分谁提交了材料和谁正在处理同时让审计日志能记录到两个不同的动作节点。驳回时批次回到 DRAFT但明细数据保留用户不需要重新录一遍这是征订系统里非常关键的用户体验细节。4.3 审批更新与并发控制用 update where 代替 select then update审批最怕重复点击。前端按钮禁用只能挡住一部分误操作后端并发情况下两个管理员同时审批同一份计划如果都执行无条件 update后提交的人会覆盖先提交的人而审计记录前后矛盾。常规解法是让更新语句自带条件把期望的当前状态写进 where受影响行数为 0 就说明状态已被别的事务改过。Transactional(rollbackFor Exception.class) public boolean auditPlan(Long planId, String userId, boolean pass) { String target pass ? AUDITING : DRAFT; UpdateWrapperEnrollPlan wrapper new UpdateWrapper(); wrapper.eq(id, planId) .eq(status, SUBMITTED) .eq(deleted, 0); EnrollPlan update new EnrollPlan(); update.setStatus(target); int rows enrollPlanMapper.update(update, wrapper); if (rows 0) { throw new BizException(批次状态已变更请刷新后重试); } auditLogService.record(userId, planId, AUDIT, target); return true; }这里刻意没有用 Version 乐观锁。审批是低频操作用 status 字段本身做条件比维护 version 更直观也更容易在 SQL 日志里确认Version 更适合明细行那种被多角色频繁编辑的写冲突场景。审计日志必须和状态更新在同一个事务里否则状态没改成但日志已入库给后续排查造成误导。update...where 本身是原子操作不需要把 select 和 update 拆开再包一层事务隔离这是与普通先查再改写法的本质区别。5. 权限控制与安全配置拦截器、BCrypt与配置密文5.1 权限模型取舍不引入Spring Security的现实理由征订系统的角色是学院教务员、教材科管理员、教务处管理员、系统管理员权限差异集中在谁能编辑、谁能审批、谁能取消粒度到接口级已经足够。引入 Spring Security 的代价是过滤器链、认证管理器、会话并发控制这些概念会盖过业务本身答辩被问为什么上这么重的框架反而难答。我一般用 HandlerInterceptor 做登录拦截配一个角色判断工具已经能挡住绝大多数越权请求。如果后续要上 JWT、OAuth2 或第三方登录再迁移到 Spring Security 和 Sa-Token 不迟。两种方案的边界列成表更直观方案适用规模学习成本扩展性自定义拦截器角色少、接口级权限低需自行维护白名单与角色注解Spring Security多角色、JWT、OAuth2高生态完整迁移方便5.2 登录拦截器与角色校验的具体写法拦截器只做两件事判断请求路径是否放行检查会话里是否有已登录用户。硬编码白名单适合小项目路径多了要收敛成常量集合。public class AuthInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { if (request.getRequestURI().startsWith(/api/auth/login)) { return true; } UserInfo user (UserInfo) request.getSession() .getAttribute(loginUser); if (user null) { response.setStatus(401); response.setContentType(application/json;charsetUTF-8); response.getWriter().write({\code\:401,\msg\:\未登录\}); return false; } request.setAttribute(currentUser, user); return true; } }注册拦截器时注意路径规则的写法/** 会拦住静态资源需要用 excludePathPatterns 把登录接口和静态目录放出去。Configuration public class WebConfig implements WebMvcConfigurer { Autowired private AuthInterceptor authInterceptor; Override public void addInterceptors(InterceptorRegistry registry) { registry.addInterceptor(authInterceptor) .addPathPatterns(/api/**) .excludePathPatterns(/api/auth/login); } }角色校验放在 Service 层入口用一个 requireRole 工具方法显式调用比在 controller 堆注解更透明审计日志也方便记录操作者角色。业务规则教材科管理员不能取消已确认的计划在 service 方法第一行就可见新人接手时不需要去翻注解定义。5.3 密码存储与yml密文两张必补的安全短板密码不能明文入库也不能用 MD5。BCrypt 每次随机生成盐相同密码产生不同哈希撞库成本显著提高。Spring Security 的 crypto 模块可以独立使用不依赖完整过滤器链。public class PasswordUtil { private static final BCryptPasswordEncoder ENCODER new BCryptPasswordEncoder(); public static String encrypt(String rawPassword) { return ENCODER.encode(rawPassword); } public static boolean match(String rawPassword, String encodedPassword) { return ENCODER.matches(rawPassword, encodedPassword); } }数据源密码不写明文进 yml 也是安全底线。常见做法是引入 jasypt-spring-boot-starter配置文件里写 ENC(加密串)启动时通过 JVM 参数注入密钥。加密命令为 java -cp jasypt-1.9.3.jar org.jasypt.intf.cli.JasyptPBEStringEncryptionCLI inputroot123 password密钥 algorithmPBEWithMD5AndDES生成的密文填进 yml启动时加 -Djasypt.encryptor.password密钥。这样即使配置仓库被拉取数据库口令也不会直接暴露。提示jasypt 3.x 默认算法改为 PBEWITHHMACSHA512ANDAES_256生成密文时要与依赖版本一致2.x 参数在新版本运行时会直接抛 DecryptionException。6. 打包部署与常见报错一次跑通征订主链路的验证技巧6.1 Maven打包与启动命令mvn clean package -DskipTests java -jar target/textbook-order-0.0.1-SNAPSHOT.jar \ --server.port8081 \ --spring.profiles.activeprod第一步先确认 java -version 和 mvn -v 输出的 JDK 版本与项目要求一致很多启动失败在环境变量阶段就能拦住。打包跳过测试是为了避免示例测试类影响构建速度启动时看到 Tomcat started on port(s) 8080 才算真正起来。端口被占用时用 --server.port 临时换端口不需要改配置文件。6.2 高频报错排查表报错关键字高频原因处理路径Could not create connection to database serverMySQL 未启动或端口不对检查 3306 端口改 url 中的地址The server time zone value数据源 url 缺时区参数加 serverTimezoneAsia/ShanghaiClassNotFoundException: com.mysql.jdbc.Driver驱动版本与驱动类不匹配8.x 用 com.mysql.cj.jdbc.DriverInvalid bound statement (not found)XML namespace 与接口不一致核对 namespace 为接口全限定名Error attempting to get column from result set字段类型映射失败检查 DECIMAL 与 BigDecimal 对应自动建表后中文乱码建表字符集不是 utf8mb4用脚本建表不用自动建表自动建表是个容易踩的隐形坑。部分源码依赖 spring.sql.init 启动建表但数据库默认字符集一旦不是 utf8mb4中文备注会乱码字段顺序也不可控。建表 SQL 应该纳入 Git 管理应用只负责读写不负责维护结构。6.3 用curl链路验证状态机是否真实生效页面点完一遍不等于流程正确用 curl 走一遍登录、审核、确认链路再回看服务端 SQL 日志能快速判断状态机是否真实生效。curl -c cookie.txt -X POST http://localhost:8080/api/auth/login \ -H Content-Type: application/json \ -d {account:admin,password:123456} curl -b cookie.txt -X POST http://localhost:8080/api/plan/audit \ -H Content-Type: application/json \ -d {planId:1,pass:true}第二条命令执行后服务端日志应出现 UPDATE enroll_plan SET statusAUDITING WHERE id1 AND statusSUBMITTED一旦 where 条件里没有 status就是 UpdateWrapper 没生效并发下必然出现覆盖更新。验证完状态流转再按时间倒序查一次审计表确认每次变更都有记录。这组操作全部通过后这套征订管理系统的主干链路才算真正可演示而不是一个能打开登录页的壳子。本文还有配套的精品资源点击获取