简介这是一套基于SpringBoot的商城后台管理系统完整源码与数据库面向计算机专业毕业设计学生及Java Web初学者帮助解决从零搭建电商项目、理解前后端协作流程的难题。系统集成商城前台与后台前端采用jsp、jQuery与layui后端基于maven、SpringMVC、Spring、MyBatis涵盖用户登录注册、商品浏览、购物车、结算、订单与评论管理以及管理员和商家双角色的商品发布、财务管理、公告管理、采购进货、日月销售额统计、日志导出与锁屏等功能。压缩包共468个文件约8.66MB包含104个java源文件、54个jsp页面、52个js脚本、19个css样式及18个xml配置另有gif、png、jpg等图片素材和sql数据库脚本结构完整便于二次开发。目前已有31人学习下载适合作为毕业设计参考或课程项目模板可快速掌握商城系统的业务逻辑与代码组织方式。1. 商城后台管理系统从一套 SpringBoot 源码里能拆出多少可复用的东西拿到「基于 SpringBoot 的商城后台管理系统源码数据库」这类资源很多人第一反应是先把项目跑起来看效果结果卡在数据库连不上、依赖下载失败、前端页面 404 上折腾半天连登录页都进不去。这套东西的本质是一套典型的 Java Web 单体后台SpringBoot 做容器和自动装配MyBatis 或 MyBatis-Plus 做持久层MySQL 存商品、订单、用户、库存这些核心表前端多半是 Thymeleaf 模板或者 Vue 打包后塞进 static 目录。它解决的是中小型电商后台的增删改查、权限控制、订单流转这些重复造轮子的活。适合谁适合刚学完 SpringBoot 想找个完整项目练手的也适合接私活需要快速搭后台骨架的。但别指望它开箱即用数据库脚本、配置项、版本兼容这三关必须先过。2. 把源码跑起来之前先搞清楚这套 SpringBoot 项目的结构2.1 典型目录长什么样哪些文件动不得一套标准的商城后台 SpringBoot 项目根目录下通常是src/main/java放业务代码src/main/resources放配置和静态资源sql或db目录放数据库脚本。Java 包结构一般按controller、service、mapper、entity、config、util分层这是最稳的约定别自作聪明改成 DDD 那套改完 MyBatis 扫描路径全乱。application.yml或application.properties是第一个要看的文件里面藏着数据库连接、端口、文件上传路径、日志级别。pom.xml是第二个重点看 SpringBoot 父版本和 MyBatis 版本这两个决定了你能不能直接用 JDK 17 跑。常见做法是先把pom.xml里的java.version和本机 JDK 对齐不一致就先改配置别急着编译。静态资源这块要特别注意如果前端是 Vue 打包后放进resources/static那index.html的引用路径必须是相对路径否则部署到子目录下全白屏。resources/templates下如果有 Thymeleaf 模板检查spring.thymeleaf.cache在开发时设成false不然改页面不生效这个坑我踩过不止一次。2.2 数据库脚本怎么导入字符集和引擎别选错数据库脚本通常是一个.sql文件里面包含建库、建表、插初始数据三部分。导入前先确认 MySQL 版本5.7 和 8.0 在utf8mb4排序规则上有差异脚本里如果写死utf8mb4_general_ci8.0 下也能跑但caching_sha2_password认证插件会让老版本 JDBC 驱动连不上。导入命令用命令行最稳别用 Navicat 图形化拖拽大文件容易断# 先建库字符集必须 utf8mb4否则商品名里的 emoji 存不进去 mysql -u root -p -e CREATE DATABASE mall_admin DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; # 再导入脚本注意路径别带中文 mysql -u root -p mall_admin /path/to/mall_admin.sql # 验证表数量和引擎 mysql -u root -p -e USE mall_admin; SHOW TABLES; SELECT TABLE_NAME, ENGINE FROM information_schema.TABLES WHERE TABLE_SCHEMAmall_admin;逻辑说明第一条命令建库时指定字符集避免后续改表第二条导入数据如果脚本里没有USE语句必须手动指定库名第三条验证表是否都建成功重点看ENGINE是不是InnoDB如果是MyISAM事务和行锁用不了订单模块会出并发问题。参数说明utf8mb4_general_ci是通用排序规则对大小写不敏感适合后台系统如果业务要求严格区分大小写换成utf8mb4_bin。导入大文件时如果报max_allowed_packet错误在my.cnf里把max_allowed_packet调到64M再重启 MySQL。2.3 配置文件里三个必改项改完才能启动application.yml里数据库连接是第一个要改的url里的库名、时区、useSSL参数都得对spring: datasource: url: jdbc:mysql://127.0.0.1:3306/mall_admin?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghaiuseSSLfalseallowPublicKeyRetrievaltrue username: root password: your_password driver-class-name: com.mysql.cj.jdbc.Driver thymeleaf: cache: false prefix: classpath:/templates/ suffix: .html server: port: 8080 servlet: context-path: /逻辑说明serverTimezoneAsia/Shanghai不加会报时区错误useSSLfalse在本地开发时关掉allowPublicKeyRetrievaltrue是 MySQL 8.0 的caching_sha2_password认证需要的。context-path如果设成/mall那所有接口和页面都要加前缀前端请求路径也得同步改这个改错就是 404。参数说明driver-class-name在 MySQL 8.0 下必须是com.mysql.cj.jdbc.Driver老版本com.mysql.jdbc.Driver会警告。thymeleaf.cache开发时false上线改true提性能。端口冲突就改server.port别去杀进程。3. 商城后台核心模块的增删改查怎么落地3.1 商品管理从实体类到 Mapper 的完整链路商品模块是后台最核心的涉及商品表、分类表、库存表三张表的关联。实体类用 Lombok 简化 getter/setter字段名和数据库列名用驼峰转下划线自动映射Data TableName(t_product) public class Product { TableId(type IdType.AUTO) private Long id; private String name; private Long categoryId; private BigDecimal price; private Integer stock; private String coverImg; TableField(fill FieldFill.INSERT) private LocalDateTime createTime; TableField(fill FieldFill.INSERT_UPDATE) private LocalDateTime updateTime; }逻辑说明TableName指定表名TableId指定主键策略AUTO表示数据库自增。TableField(fill ...)配合 MyBatis-Plus 的自动填充处理器插入和更新时自动写时间不用手动 set。如果用的是原生 MyBatis这些注解换成 XML 里的resultMap和insert语句。参数说明BigDecimal存价格别用Double浮点精度问题在订单金额计算时会翻车。stock用Integer扣减库存时用UPDATE t_product SET stock stock - #{num} WHERE id #{id} AND stock #{num}靠数据库行锁保证不超卖别在 Java 里先查再减。Mapper 层用 MyBatis-Plus 的BaseMapper直接继承分页查询用Page对象Mapper public interface ProductMapper extends BaseMapperProduct { // 自定义分页查询带分类名称 IPageProductVO selectProductPage(PageProductVO page, Param(keyword) String keyword); }对应的 XML 里写SELECT p.*, c.name AS categoryName FROM t_product p LEFT JOIN t_category c ON p.category_id c.id WHERE p.name LIKE CONCAT(%, #{keyword}, %)。逻辑说明关联查询用LEFT JOIN分类被删了商品还能查出来。参数说明CONCAT拼接模糊查询别用#{}直接拼%会 SQL 注入。3.2 订单状态流转状态机用枚举还是数据库字段订单模块的坑最多状态流转如果只用Integer字段硬编码后期加状态就得改代码。常见做法是定义一个枚举public enum OrderStatus { UNPAID(0, 待支付), PAID(1, 已支付), SHIPPED(2, 已发货), COMPLETED(3, 已完成), CANCELLED(4, 已取消); private final int code; private final String desc; // 构造和 getter 省略 }逻辑说明枚举把状态和描述绑死前端传code后端用OrderStatus.values()遍历匹配。状态流转校验放在 Service 层比如只有UNPAID能改成PAIDPAID能改成SHIPPED其他组合直接抛业务异常。参数说明数据库里status字段用TINYINT别用VARCHAR存中文查询和索引效率差。如果状态超过 10 个考虑用状态机框架但小项目枚举够用。订单查询要分页加条件筛选时间范围查询用BETWEENSELECT * FROM t_order WHERE status #{status} AND create_time BETWEEN #{startTime} AND #{endTime} ORDER BY create_time DESC LIMIT #{offset}, #{size}逻辑说明LIMIT分页在数据量大时性能差深分页用WHERE id #{lastId} LIMIT #{size}优化。参数说明startTime和endTime由前端传后端做格式校验别让用户传个2024-13-45进来。3.3 权限控制拦截器还是 Spring Security后台系统必须登录才能操作简单做法是写个HandlerInterceptor在preHandle里检查 Session 里有没有用户信息public class LoginInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { Object user request.getSession().getAttribute(loginUser); if (user null) { response.sendRedirect(/login); return false; } return true; } }逻辑说明拦截器注册在WebMvcConfigurer里排除/login、/css/**、/js/**这些静态资源路径。参数说明sendRedirect用相对路径别写死域名。如果项目用 Spring Security配置HttpSecurity的antMatchers和formLogin但 Security 学习曲线陡小后台用拦截器更快。4. 源码跑通后必查的五个坑4.1 启动报Table xxx doesnt exist现象项目启动时控制台刷一堆Table mall_admin.t_user doesnt exist但数据库里明明有表。原因application.yml里的库名和实际导入的库名不一致或者 MyBatis-Plus 的table-prefix配置和表名对不上。常见的是脚本里表名带t_前缀但实体类没加TableNameMyBatis-Plus 默认用类名转下划线User变成user找不到t_user。解决检查spring.datasource.url里的库名再检查实体类注解。如果全局都有t_前缀在application.yml里加mybatis-plus.global-config.db-config.table-prefix: t_这样实体类不用逐个加注解。4.2 前端页面 404但接口能通现象访问http://localhost:8080/白屏或 404但http://localhost:8080/user/list能返回 JSON。原因静态资源没打包进resources/static或者index.html不在static根目录。如果前端是 Vue 打包vue.config.js里的publicPath设成了/但部署在子路径下资源引用全错。解决确认index.html在src/main/resources/static/下publicPath改成./用相对路径。如果是 Thymeleaf 模板检查Controller有没有返回index而不是redirect:/index。4.3 文件上传报MultipartException现象上传商品图片时抛org.springframework.web.multipart.MultipartException: Could not parse multipart servlet request。原因SpringBoot 默认单文件大小限制 1MB超过就报错。或者临时目录被系统清理了java.io.tmpdir指向的路径不存在。解决在application.yml里加配置spring: servlet: multipart: max-file-size: 10MB max-request-size: 50MB location: /data/tmplocation指定一个存在的目录别用默认的/tmp有些系统会定时清。参数说明max-file-size是单文件max-request-size是整个请求多文件上传时后者要大于前者之和。4.4 分页查询总数不对现象MyBatis-Plus 分页查出来total是 0但数据明明有。原因分页插件没配置。MyBatis-Plus 需要注册PaginationInnerInterceptor不注册的话Page对象不生效SQL 里不会拼LIMIT。解决在配置类里加Bean public MybatisPlusInterceptor mybatisPlusInterceptor() { MybatisPlusInterceptor interceptor new MybatisPlusInterceptor(); interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL)); return interceptor; }参数说明DbType.MYSQL指定数据库类型用错方言分页 SQL 会报语法错误。4.5 修改代码后不生效必须重启现象改了 Controller 或 Mapper 的代码刷新页面还是老逻辑。原因spring.thymeleaf.cache设成了true或者 IDE 没开自动编译。IDEA 默认不自动编译改完 Java 文件要手动Build。解决application.yml里thymeleaf.cache: falseIDEA 里Settings - Build - Compiler - Build project automatically勾上再在Registry里开compiler.automake.allow.when.app.running。但生产环境必须把缓存打开不然性能掉一半。5. 把这套源码改造成能接私活的骨架跑通只是第一步真正值钱的是把它改成能快速复用的骨架。我一般会做三件事抽出一个common模块放统一返回体、全局异常处理、分页封装把权限从 Session 换成 JWT这样前后端分离时不用带 Cookie数据库连接池从默认的 HikariCP 调参maximum-pool-size设成 CPU 核数乘 2 加磁盘数别用默认的 10。统一返回体长这样Data public class ResultT { private int code; private String msg; private T data; public static T ResultT success(T data) { ResultT r new Result(); r.setCode(200); r.setMsg(ok); r.setData(data); return r; } public static T ResultT fail(String msg) { ResultT r new Result(); r.setCode(500); r.setMsg(msg); return r; } }逻辑说明Controller 里统一返回Result前端拿code判断成功失败。全局异常处理用RestControllerAdvice捕获Exception返回Result.fail(e.getMessage())别把堆栈直接吐给前端。JWT 改造的关键是写个JwtUtil登录成功后生成 token 返回前端前端每次请求带Authorization头拦截器里解析 token 拿用户信息。注意 token 过期时间别设太长后台系统 2 小时够用刷新 token 的逻辑看业务需求。数据库连接池调参在application.yml里spring: datasource: hikari: maximum-pool-size: 20 minimum-idle: 5 connection-timeout: 30000 idle-timeout: 600000 max-lifetime: 1800000参数说明maximum-pool-size不是越大越好连接数超过数据库max_connections会报错。max-lifetime要比数据库的wait_timeout小不然连接被数据库断了池子里还是死连接。最后说个血泪经验别在源码里直接改先git init提交一版原始代码再开分支改。改崩了能回滚这个后悔药必须备。数据库脚本也纳入版本管理每次改表结构写增量 SQL别直接改原脚本不然线上和本地对不上。这套骨架搭好之后再接新后台项目复制粘贴改改表名就能用省下来的时间够你多接两个单。希望帮到你。本文还有配套的精品资源点击获取 
长河君 · 2026/10/27 7:22:18 · 阅读 1.2k SpringBoot商城后台管理系统源码解析与实战改造指南
简介这是一套基于SpringBoot的商城后台管理系统完整源码与数据库面向计算机专业毕业设计学生及Java Web初学者帮助解决从零搭建电商项目、理解前后端协作流程的难题。系统集成商城前台与后台前端采用jsp、jQuery与layui后端基于maven、SpringMVC、Spring、MyBatis涵盖用户登录注册、商品浏览、购物车、结算、订单与评论管理以及管理员和商家双角色的商品发布、财务管理、公告管理、采购进货、日月销售额统计、日志导出与锁屏等功能。压缩包共468个文件约8.66MB包含104个java源文件、54个jsp页面、52个js脚本、19个css样式及18个xml配置另有gif、png、jpg等图片素材和sql数据库脚本结构完整便于二次开发。目前已有31人学习下载适合作为毕业设计参考或课程项目模板可快速掌握商城系统的业务逻辑与代码组织方式。1. 商城后台管理系统从一套 SpringBoot 源码里能拆出多少可复用的东西拿到「基于 SpringBoot 的商城后台管理系统源码数据库」这类资源很多人第一反应是先把项目跑起来看效果结果卡在数据库连不上、依赖下载失败、前端页面 404 上折腾半天连登录页都进不去。这套东西的本质是一套典型的 Java Web 单体后台SpringBoot 做容器和自动装配MyBatis 或 MyBatis-Plus 做持久层MySQL 存商品、订单、用户、库存这些核心表前端多半是 Thymeleaf 模板或者 Vue 打包后塞进 static 目录。它解决的是中小型电商后台的增删改查、权限控制、订单流转这些重复造轮子的活。适合谁适合刚学完 SpringBoot 想找个完整项目练手的也适合接私活需要快速搭后台骨架的。但别指望它开箱即用数据库脚本、配置项、版本兼容这三关必须先过。2. 把源码跑起来之前先搞清楚这套 SpringBoot 项目的结构2.1 典型目录长什么样哪些文件动不得一套标准的商城后台 SpringBoot 项目根目录下通常是src/main/java放业务代码src/main/resources放配置和静态资源sql或db目录放数据库脚本。Java 包结构一般按controller、service、mapper、entity、config、util分层这是最稳的约定别自作聪明改成 DDD 那套改完 MyBatis 扫描路径全乱。application.yml或application.properties是第一个要看的文件里面藏着数据库连接、端口、文件上传路径、日志级别。pom.xml是第二个重点看 SpringBoot 父版本和 MyBatis 版本这两个决定了你能不能直接用 JDK 17 跑。常见做法是先把pom.xml里的java.version和本机 JDK 对齐不一致就先改配置别急着编译。静态资源这块要特别注意如果前端是 Vue 打包后放进resources/static那index.html的引用路径必须是相对路径否则部署到子目录下全白屏。resources/templates下如果有 Thymeleaf 模板检查spring.thymeleaf.cache在开发时设成false不然改页面不生效这个坑我踩过不止一次。2.2 数据库脚本怎么导入字符集和引擎别选错数据库脚本通常是一个.sql文件里面包含建库、建表、插初始数据三部分。导入前先确认 MySQL 版本5.7 和 8.0 在utf8mb4排序规则上有差异脚本里如果写死utf8mb4_general_ci8.0 下也能跑但caching_sha2_password认证插件会让老版本 JDBC 驱动连不上。导入命令用命令行最稳别用 Navicat 图形化拖拽大文件容易断# 先建库字符集必须 utf8mb4否则商品名里的 emoji 存不进去 mysql -u root -p -e CREATE DATABASE mall_admin DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; # 再导入脚本注意路径别带中文 mysql -u root -p mall_admin /path/to/mall_admin.sql # 验证表数量和引擎 mysql -u root -p -e USE mall_admin; SHOW TABLES; SELECT TABLE_NAME, ENGINE FROM information_schema.TABLES WHERE TABLE_SCHEMAmall_admin;逻辑说明第一条命令建库时指定字符集避免后续改表第二条导入数据如果脚本里没有USE语句必须手动指定库名第三条验证表是否都建成功重点看ENGINE是不是InnoDB如果是MyISAM事务和行锁用不了订单模块会出并发问题。参数说明utf8mb4_general_ci是通用排序规则对大小写不敏感适合后台系统如果业务要求严格区分大小写换成utf8mb4_bin。导入大文件时如果报max_allowed_packet错误在my.cnf里把max_allowed_packet调到64M再重启 MySQL。2.3 配置文件里三个必改项改完才能启动application.yml里数据库连接是第一个要改的url里的库名、时区、useSSL参数都得对spring: datasource: url: jdbc:mysql://127.0.0.1:3306/mall_admin?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghaiuseSSLfalseallowPublicKeyRetrievaltrue username: root password: your_password driver-class-name: com.mysql.cj.jdbc.Driver thymeleaf: cache: false prefix: classpath:/templates/ suffix: .html server: port: 8080 servlet: context-path: /逻辑说明serverTimezoneAsia/Shanghai不加会报时区错误useSSLfalse在本地开发时关掉allowPublicKeyRetrievaltrue是 MySQL 8.0 的caching_sha2_password认证需要的。context-path如果设成/mall那所有接口和页面都要加前缀前端请求路径也得同步改这个改错就是 404。参数说明driver-class-name在 MySQL 8.0 下必须是com.mysql.cj.jdbc.Driver老版本com.mysql.jdbc.Driver会警告。thymeleaf.cache开发时false上线改true提性能。端口冲突就改server.port别去杀进程。3. 商城后台核心模块的增删改查怎么落地3.1 商品管理从实体类到 Mapper 的完整链路商品模块是后台最核心的涉及商品表、分类表、库存表三张表的关联。实体类用 Lombok 简化 getter/setter字段名和数据库列名用驼峰转下划线自动映射Data TableName(t_product) public class Product { TableId(type IdType.AUTO) private Long id; private String name; private Long categoryId; private BigDecimal price; private Integer stock; private String coverImg; TableField(fill FieldFill.INSERT) private LocalDateTime createTime; TableField(fill FieldFill.INSERT_UPDATE) private LocalDateTime updateTime; }逻辑说明TableName指定表名TableId指定主键策略AUTO表示数据库自增。TableField(fill ...)配合 MyBatis-Plus 的自动填充处理器插入和更新时自动写时间不用手动 set。如果用的是原生 MyBatis这些注解换成 XML 里的resultMap和insert语句。参数说明BigDecimal存价格别用Double浮点精度问题在订单金额计算时会翻车。stock用Integer扣减库存时用UPDATE t_product SET stock stock - #{num} WHERE id #{id} AND stock #{num}靠数据库行锁保证不超卖别在 Java 里先查再减。Mapper 层用 MyBatis-Plus 的BaseMapper直接继承分页查询用Page对象Mapper public interface ProductMapper extends BaseMapperProduct { // 自定义分页查询带分类名称 IPageProductVO selectProductPage(PageProductVO page, Param(keyword) String keyword); }对应的 XML 里写SELECT p.*, c.name AS categoryName FROM t_product p LEFT JOIN t_category c ON p.category_id c.id WHERE p.name LIKE CONCAT(%, #{keyword}, %)。逻辑说明关联查询用LEFT JOIN分类被删了商品还能查出来。参数说明CONCAT拼接模糊查询别用#{}直接拼%会 SQL 注入。3.2 订单状态流转状态机用枚举还是数据库字段订单模块的坑最多状态流转如果只用Integer字段硬编码后期加状态就得改代码。常见做法是定义一个枚举public enum OrderStatus { UNPAID(0, 待支付), PAID(1, 已支付), SHIPPED(2, 已发货), COMPLETED(3, 已完成), CANCELLED(4, 已取消); private final int code; private final String desc; // 构造和 getter 省略 }逻辑说明枚举把状态和描述绑死前端传code后端用OrderStatus.values()遍历匹配。状态流转校验放在 Service 层比如只有UNPAID能改成PAIDPAID能改成SHIPPED其他组合直接抛业务异常。参数说明数据库里status字段用TINYINT别用VARCHAR存中文查询和索引效率差。如果状态超过 10 个考虑用状态机框架但小项目枚举够用。订单查询要分页加条件筛选时间范围查询用BETWEENSELECT * FROM t_order WHERE status #{status} AND create_time BETWEEN #{startTime} AND #{endTime} ORDER BY create_time DESC LIMIT #{offset}, #{size}逻辑说明LIMIT分页在数据量大时性能差深分页用WHERE id #{lastId} LIMIT #{size}优化。参数说明startTime和endTime由前端传后端做格式校验别让用户传个2024-13-45进来。3.3 权限控制拦截器还是 Spring Security后台系统必须登录才能操作简单做法是写个HandlerInterceptor在preHandle里检查 Session 里有没有用户信息public class LoginInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { Object user request.getSession().getAttribute(loginUser); if (user null) { response.sendRedirect(/login); return false; } return true; } }逻辑说明拦截器注册在WebMvcConfigurer里排除/login、/css/**、/js/**这些静态资源路径。参数说明sendRedirect用相对路径别写死域名。如果项目用 Spring Security配置HttpSecurity的antMatchers和formLogin但 Security 学习曲线陡小后台用拦截器更快。4. 源码跑通后必查的五个坑4.1 启动报Table xxx doesnt exist现象项目启动时控制台刷一堆Table mall_admin.t_user doesnt exist但数据库里明明有表。原因application.yml里的库名和实际导入的库名不一致或者 MyBatis-Plus 的table-prefix配置和表名对不上。常见的是脚本里表名带t_前缀但实体类没加TableNameMyBatis-Plus 默认用类名转下划线User变成user找不到t_user。解决检查spring.datasource.url里的库名再检查实体类注解。如果全局都有t_前缀在application.yml里加mybatis-plus.global-config.db-config.table-prefix: t_这样实体类不用逐个加注解。4.2 前端页面 404但接口能通现象访问http://localhost:8080/白屏或 404但http://localhost:8080/user/list能返回 JSON。原因静态资源没打包进resources/static或者index.html不在static根目录。如果前端是 Vue 打包vue.config.js里的publicPath设成了/但部署在子路径下资源引用全错。解决确认index.html在src/main/resources/static/下publicPath改成./用相对路径。如果是 Thymeleaf 模板检查Controller有没有返回index而不是redirect:/index。4.3 文件上传报MultipartException现象上传商品图片时抛org.springframework.web.multipart.MultipartException: Could not parse multipart servlet request。原因SpringBoot 默认单文件大小限制 1MB超过就报错。或者临时目录被系统清理了java.io.tmpdir指向的路径不存在。解决在application.yml里加配置spring: servlet: multipart: max-file-size: 10MB max-request-size: 50MB location: /data/tmplocation指定一个存在的目录别用默认的/tmp有些系统会定时清。参数说明max-file-size是单文件max-request-size是整个请求多文件上传时后者要大于前者之和。4.4 分页查询总数不对现象MyBatis-Plus 分页查出来total是 0但数据明明有。原因分页插件没配置。MyBatis-Plus 需要注册PaginationInnerInterceptor不注册的话Page对象不生效SQL 里不会拼LIMIT。解决在配置类里加Bean public MybatisPlusInterceptor mybatisPlusInterceptor() { MybatisPlusInterceptor interceptor new MybatisPlusInterceptor(); interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL)); return interceptor; }参数说明DbType.MYSQL指定数据库类型用错方言分页 SQL 会报语法错误。4.5 修改代码后不生效必须重启现象改了 Controller 或 Mapper 的代码刷新页面还是老逻辑。原因spring.thymeleaf.cache设成了true或者 IDE 没开自动编译。IDEA 默认不自动编译改完 Java 文件要手动Build。解决application.yml里thymeleaf.cache: falseIDEA 里Settings - Build - Compiler - Build project automatically勾上再在Registry里开compiler.automake.allow.when.app.running。但生产环境必须把缓存打开不然性能掉一半。5. 把这套源码改造成能接私活的骨架跑通只是第一步真正值钱的是把它改成能快速复用的骨架。我一般会做三件事抽出一个common模块放统一返回体、全局异常处理、分页封装把权限从 Session 换成 JWT这样前后端分离时不用带 Cookie数据库连接池从默认的 HikariCP 调参maximum-pool-size设成 CPU 核数乘 2 加磁盘数别用默认的 10。统一返回体长这样Data public class ResultT { private int code; private String msg; private T data; public static T ResultT success(T data) { ResultT r new Result(); r.setCode(200); r.setMsg(ok); r.setData(data); return r; } public static T ResultT fail(String msg) { ResultT r new Result(); r.setCode(500); r.setMsg(msg); return r; } }逻辑说明Controller 里统一返回Result前端拿code判断成功失败。全局异常处理用RestControllerAdvice捕获Exception返回Result.fail(e.getMessage())别把堆栈直接吐给前端。JWT 改造的关键是写个JwtUtil登录成功后生成 token 返回前端前端每次请求带Authorization头拦截器里解析 token 拿用户信息。注意 token 过期时间别设太长后台系统 2 小时够用刷新 token 的逻辑看业务需求。数据库连接池调参在application.yml里spring: datasource: hikari: maximum-pool-size: 20 minimum-idle: 5 connection-timeout: 30000 idle-timeout: 600000 max-lifetime: 1800000参数说明maximum-pool-size不是越大越好连接数超过数据库max_connections会报错。max-lifetime要比数据库的wait_timeout小不然连接被数据库断了池子里还是死连接。最后说个血泪经验别在源码里直接改先git init提交一版原始代码再开分支改。改崩了能回滚这个后悔药必须备。数据库脚本也纳入版本管理每次改表结构写增量 SQL别直接改原脚本不然线上和本地对不上。这套骨架搭好之后再接新后台项目复制粘贴改改表名就能用省下来的时间够你多接两个单。希望帮到你。本文还有配套的精品资源点击获取