SpringBoot远程教育网站设计与部署：从架构到前后端分离实战

很多人在做SpringBoot远程教育网站的时候，容易陷入一个误区：拿到一个所谓“源码”就急着跑起来，结果数据库脚本导入报错、前端请求404、上传文件找不到路径，最后连自己在哪一步挂掉的都不知道。这个项目我前前后后完整做过两遍，也帮人排查过不少类似的问题，今天就把“基于SpringBoot远程教育网站的设计与实现”这个项目从设计思路到落地部署，按我自己的实操顺序完整拆一遍。

先说清楚这个项目是什么：一个典型的前后端分离架构在线学习平台，后端用SpringBoot提供REST接口，前端用Vue（也可以是原生页面）做交互，数据库用MySQL存放用户、课程、订单、评论等核心数据。它解决的问题非常直白——让学员能在线浏览课程、购买课程、学习视频，让管理员能维护课程内容和用户状态，让教师能上传自己的课程资源。适合用在学习、毕设、或者作为接手企业级项目之前的热身练习，因为它的业务链路完整，但复杂度又没到Spring Cloud那一步。

1. 项目整体设计与技术选型思路

1.1 远程教育网站到底要做什么

动手写代码之前，我建议先把业务边界画清楚。很多同学一上来就跟着视频敲代码，敲到一半发现功能对不上，又回头改表结构，真没必要。远程教育网站最核心的用户其实只有三类：学员（前台使用）、教师（负责课程生产和维护）、管理员（后台运营）。围绕这三类人，核心业务闭环是：注册登录 → 浏览课程 → 下单购买 → 学习视频 → 评价互动，以及管理端的课程发布、用户管理、订单统计。听起来不复杂，但每一条链路都涉及前后端交互、数据库读写、状态流转，这就是项目真正有含金量的地方。

我当时把功能拆成两个端来看：前端门户（学员视角）和后台管理端（管理员和教师视角）。门户端包含首页展示、课程列表、课程详情、在线播放、购物车/订单、个人中心；管理端包含仪表盘、课程分类管理、课程信息管理、用户管理、订单处理、数据统计。这样拆完之后，后端接口其实就是一个个围绕资源的CRUD加上订单这种偏业务的状态流转，思路特别清晰。

1.2 为什么是SpringBoot + Vue这套组合

技术选型这件事，永远不要脱离项目规模谈架构。SpringBoot在这个量级的项目里几乎是“标准答案”：起步依赖让引入Java Web组件变得极其简单，内嵌Tomcat省掉了繁琐的外部容器配置，自动装配在大量场景下帮你把配置项给默认好，配合Spring生态做数据访问、安全认证、参数校验都很顺手。

前端我选Vue，主要原因有两点：一是Vue的生态对新手友好，脚手架的方式可以快速搭建工程结构，模板语法让页面渲染逻辑直接写在HTML里，不需要额外引入重量级框架；二是关键，Vue和SpringBoot之间通过完全分离的JSON接口通信，联调阶段我能明确知道问题出在前端路由还是后端接口，定位效率高很多。如果毕设或者项目时间非常紧，你也可以用后端的模板引擎直接写页面，但我个人的建议是，既然标题都写了“远程教育网站”，前后端分离这一套仍是当前行业的主流模式，作为项目经历写在简历上是加分的，多花两天学Vue的基础足以覆盖这个项目的开发需求。

1.3 除了框架，还需要哪些配套组件

SpringBoot解决了后端“跑起来”的问题，但完整项目还需要几个关键组件。首先是数据库，MySQL是默认选择，稳定、资料多、部署简单，社区开源的远程教育项目也基本都基于MySQL来设计。其次是数据访问层，我推荐用MyBatis-Plus，它比原生MyBatis多了通用CRUD方法，日常的增删改查基本不用手写SQL，遇到多表关联、条件查询再自己补充XML或者注解SQL，效率能提升一大截。然后是鉴权方案，远程教育网站有不同角色，游客、学员、管理员访问的接口必须区分开，JWT方案是目前最主流的做法，无状态、跨域友好、扩展性也强。至于Redis，能做缓存也能做验证码存储，但这个体量的项目初版可以先不引入，避免同时排查两个组件的定位成本，后面再优化也不迟。

2. 数据库设计与核心功能拆解

2.1 数据库表结构到底怎么设计

数据库是这类项目的底子，表结构设计好了，后面所有接口都顺。我把自己两版项目沉淀下来的表结构梳理了一下，你照着这个思路去建表基本不会跑偏。

远程教育网站至少需要这几张表：用户表（区分角色，存用户名、密码、头像、手机号、邮箱）、课程分类表、课程表、章节表（一门课包含多个章节，章节里放视频地址和资料链接）、订单表、评论表、轮播图表。额外可以加一张购物车表，如果前端要做购物车功能的话，不过很多简化版项目会直接跳过购物车，让用户点“立即购买”就生成订单，这个看你的功能取舍。

表与表之间的关系也容易理清楚：一个分类下有多个课程，一个课程属于一个分类；一个用户买了多个课程，一个课程可以被多个用户购买，这是个典型的多对多关系，但不要直接建多对多关联表，而是通过订单表来沉淀购买关系，因为订单本身就承载了“谁在什么时间以什么价格购买了哪门课”的业务信息，比纯关系表更有价值。课程和章节是一对多，用户和评论是一对多，评论再关联课程。

密码字段一定要存加密后的密文，别明文入库。我见过不少参考项目里的用户密码直接是明文，这在演示的时候没事，但写进简历或者做上线演示时一旦被人问到就是减分项，用Spring Security自带的BCryptPasswordEncoder就能做加密校验，两条代码的事情。

2.2 用户角色与权限体系设计

远程教育网站里最常见的权限模型是“三角色”模型：学员只能访问前台课程和已购内容，教师能够管理自己名下的课程，管理员拥有全部后台权限。如果你不用现成的Spring Security + JWT，而是一个拦截器手动判断，我建议把用户角色设计成用户表里的一个字段，不搞单独的角色表，简单项目这样最直观。

JWT的流程你可以这样理解：用户登录成功后，后端用用户ID、角色这些信息生成一个签名字符串返回给前端，前端存到localStorage里，每次请求都在请求头里带上这个字符串。后端写一个拦截器，只要有JWT就解析出用户信息，通过验证就放行，未通过就返回401。要注意JWT本身不存服务端状态，所以无法提前失效，一旦签发，在有效期内就算用户改了密码它还是有效的，针对多个设备登录、用户被封禁这些场景，工程上通常靠把JWT的签发版本或作废时间存到Redis来解决，但初版项目只需要关注JWT的有效期设置合理就行。

2.3 订单与支付的业务状态

订单是远程教育网站里少有的、有明确状态流转的功能模块，也是面试官比较喜欢深挖的点。我在设计时把订单状态定义为这么几个：待支付（0）、已支付（1）、已取消（2）、已退款（3）。流程是用户下单生成待支付订单，如果调用支付接口模拟支付成功，订单状态变成已支付，同时生成一份“我的课程”记录，把课程和学习者的关系持久化下来；如果用户未支付就关掉了页面，订单状态还停留在待支付，可以设置一个定时任务或在下单接口里做超时关单逻辑，初版可以用最简单的方案——每次查询订单列表时，对超过30分钟仍未支付的订单执行作废处理。

所谓“远程教育网站的支付”，绝大多数毕业设计或者课程设计里并不会真的接入微信/支付宝，因为涉及商户号和资质。我推荐的做法是做一个模拟支付：前端点击支付之后调用后端的模拟支付接口，后端不经过任何第三方网关，直接把订单更新为已支付。这个方案足以演示流程闭环，又不用面对复杂的验签和回调。

3. 实操过程与关键模块实现笔记

3.1 项目初始化与核心配置

具体到代码层面，我用的是SpringBoot 2.x版本，原因很简单：3.x出来之后虽然性能更好、API也有改动，但很多资料和依赖还是围绕2.x写的，尤其是SpringSecurity和MyBatis-Plus的整合，2.x的山寨坑在网上全都被踩平了，遇到问题能搜到答案。工具链就是IDEA + Maven + MySQL 8.0 + JDK 1.8。这套组合在Windows和Windows的Linux子系统上都能很顺利跑起来。

第一步创建工程，我习惯在Spring Initializr上选好依赖再导入IDEA：Spring Web，Spring Security，MyBatis-Plus，MySQL Driver，Lombok。注意，Lombok在编译阶段生成getter/setter，能在实体类里少写大量重复代码，但务必确认你的IDEA安装并启用了Lombok插件，不然一编译就是一片红色的找不到方法。

application.yml里最核心的配置是数据源和MyBatis-Plus的配置。数据源配置里除了常规的url、username、password外，我建议加上serverTimezone=Asia/Shanghai，不然MySQL连接经常报时区错；MyBatis-Plus的配置里设置一下逻辑删除字段和分页插件，尤其分页插件不配置的话，Page对象分页查询一律分不了页，这个坑我踩过。启动类加@MapperScan扫描Mapper接口，这个忘了的话Mapper接口一个都装配不进来，启动直接报错。

3.2 用户登录注册与JWT鉴权的完整实现

登录注册接口看起来简单，但涉及校验、加密、生成Token、拦截校验好几个环节。我建议的代码层次是：Controller只做参数接收和结果返回，Service层放业务逻辑，Mapper层只写SQL。这样维护起来不用在Controller里找密码比对逻辑。

注册接口里做两件事：用户名唯一性校验和密码加密。唯一性校验是用selectCount查一下用户表里有没有同名账户；密码加密用BCryptPasswordEncoder.encode()。登录接口里把用户提交的明文密码和库里存的密文用matches()比对，对比成功就生成Token，生成Token的密钥放在配置里，别硬编码在代码里。

拦截器这里，我一般写一个JwtInterceptor implements HandlerInterceptor，在preHandle里取请求头Authorization，去掉"Bearer "前缀，用JWT工具类校验签名和有效期。配置WebMvcConfigurer注册拦截器的时候，把登录、注册、课程列表、课程详情这些接口放到放行名单里，其他接口一律必须带Token访问。还要注意，用Spring Security做认证框架的项目，要避免和自定义拦截器重复拦截，推荐二选一；如果选了Spring Security方案，就基于SecurityFilterChain配置多组规则，JWT校验通过一个OncePerRequestFilter完成，效果是一样的。

3.3 课程列表分页与多条件查询

课程展示模块在远程教育网站里属于高频访问接口，课程数量多起来之后，一次性返回所有数据的写法必须扣掉。前端传pageNum和pageSize两个参数，后端用MyBatis-Plus的Page对象接收，Mapper层直接用selectPage就能返回分页数据。这里有个很容易踩的坑：直接调用selectPage返回总数是0，或者分页不生效，多半是没注册分页插件，在配置类里加一个MybatisPlusInterceptor，往里面add一个PaginationInnerInterceptor，再指定数据库类型为mysql，分页就正常了。

课程列表通常还带筛选条件：按分类查、按课程名称模糊查、按价格排序。这些条件放到QueryWrapper里用Lambda表达式拼，比手写字符串拼接安全。具体到代码，用like方法模糊匹配标题，用eq方法匹配分类ID，用orderByDesc按销量或按上架时间倒序。注意一个细节，课程表里最好有status字段控制上下架，列表只查“已上架”状态的课程，否则后台还没编辑完的课程就被前端看见了，很尴尬。

3.4 文件上传与视频资源的处理

远程教育网站的课程封面、讲师头像、视频地址都会牵扯到文件上传。文件上传最基础的做法是：前端通过multipart/form-data发送文件，后端用MultipartFile接收，把文件保存到服务器本地磁盘，再把访问路径存进数据库对应字段，同时给WebMvcConfigurer配置一个虚拟路径映射，把/upload/**这个URL映射到实际存储目录，这样浏览器就能通过URL直接访问图片。

视频资源我想多说一句：本地存储适合开发和演示，但如果你的项目要部署到云服务器，视频文件越来越大，磁盘迟早扛不住，而且Nginx直接代理视频资源在性能和播放兼容性上都有更成熟的方案。我自己在完整部署时会把课程视频放在服务器的静态目录，通过Nginx直接对外提供访问，Tomcat只负责接口请求。这样既减轻了后端压力，文件访问速度也快很多。如果你没有专门的视频服务器，这个方案足够应付中小流量。

3.5 管理后台的CRUD与数据统计

后台管理端在功能上大部分是CRUD，前端用Vue写一个列表页，通过axios调用后端接口。课程管理的后端接口必须包含新增课程、修改课程、上下架课程、删除课程（逻辑删除）这些操作。逻辑删除就是数据库里加一个deleted字段，删除操作实际上是UPDATE，不是DELETE，好处是误删之后还能恢复。MyBatis-Plus里在实体类字段上加@TableLogic注解，查询时会自动过滤已删除记录，不用在每一条SQL里手动加where deleted = 0，非常省心。

数据统计模块一般做三个数字：用户总数、课程总数、订单总营收。这三个数字用一个统计接口分别查三张表就能拿到。如果你还想做得好看一点，可以在订单表里按天分组统计最近30天的订单数量和销售额，返回给前端画折线图。订单的金额字段类型建议用DECIMAL，别用DOUBLE，在线支付相关的系统用浮点数存金额是大忌，精度问题会导致对账对不上。

4. 部署上线与常见问题排查

4.1 本地打包与前后端联调

项目写完之后第一件事是本地把前后端一起跑通。后端在IDEA里直接点运行即可，前端如果是Vue项目，需要先执行npm install安装依赖，再执行npm run serve启动开发服务器。前后端联调阶段最常见的报错就是跨域，因为前端跑在8080端口，后端跑在8081端口，浏览器会拦截跨端口请求。解决方案有两种：后端在配置类里加一个CorsFilter允许跨域；或者更推荐的方式是前端配代理，在vue.config.js里配置devServer.proxy，把/api前缀的请求代理到后端的地址。前者开发阶段方便，后者上线更贴近真实的生产形态。

联调阶段我建议先给自己列一个接口清单，把“登录、课程分页、课程详情、下单、支付、我的课程、后台课程管理”这几组核心接口挨个测一遍。前端页面如果报错，用浏览器F12打开开发者工具，Network面板看请求是否发出、状态码是多少、返回体是什么。如果请求根本没发出去，多半是axios拦截器里没带Token或者地址写错了；如果返回401，检查Token过期或者被拦截了；如果返回500，就去看后端控制台，异常堆栈里会明确告诉你哪一行出了问题。按这个顺序排查比瞎猜快得多。

4.2 云服务器部署的完整步骤

如果你要把项目部署到云服务器上，千万不要租那种特别低配的实例，远程教育网站如果还带视频播放，CPU和带宽都非常吃紧，建议至少2核4G、带宽按需购买。操作系统我选CentOS 7或者Ubuntu 20.04都行。部署之前先把环境装好：JDK 1.8、MySQL 5.7或8.0、Nginx，需要安装的话。

后端打包用Maven的package命令生成jar包，如果有测试代码，可以加-DskipTests跳过测试。把jar包上传到服务器后，推荐用nohup java -jar xxx.jar > app.log 2>&1 &这种方式后台运行，日志输出到文件里方便排查问题。数据库脚本在服务器上执行一遍，注意修改数据库连接配置里的IP、用户名、密码。

前端构建执行npm run build，生成一个dist目录，把它上传到服务器Nginx配置的root目录，然后修改Nginx配置让/api开头的请求反向代理到后端端口，其他请求指向前端静态文件。这一步配置好之后，访问服务器IP或域名就能看到完整的远程教育网站了。为了安全，数据库端口不要对公网开放，只允许本机访问，否则你的数据库账号被人扫到爆破的话，数据就没了。

4.3 SpringBoot版本太高引发的连锁问题

热搜词里提到“SpringBoot版本太高”，这确实是刚起步的同学最容易遇到的一个坑。官方最开始推荐下载的版本往往是3.x，但3.x要求JDK17起步，而大量教程和类库还是围绕JDK1.8写的。如果你没注意版本冲突，导入项目后项目直接编译不过，依赖下载也经常失败。

我自己在帮人排查远程教育网站项目的时候，遇到过至少三次这种情况：新建SpringBoot项目默认选了3.2.x版本，JDK用的1.8，结果启动报Error creating bean with name 'entityManagerFactory'，换成2.7.x版本后问题立刻消失。所以如果你用的JDK是1.8，就老老实实用SpringBoot 2.7.x；如果确实想用3.x，就装JDK17，并且注意MyBatis-Plus要用3.5.3以上版本，javax.*下的包名要改成jakarta.*。这条经验可以帮你省下好几个小时的排查时间。

4.4 循环依赖、打包失败这些老问题怎么处理

SpringBoot项目里让人头大的“BeanCurrentlyInCreationException”其实是循环依赖。两个Service互相注入对方，Spring在默认情况下无法处理好这种构造器注入的循环引用，导致启动失败。解决方式有两种：调整设计，把互相调用的方法抽到一个独立的Service里；或者用@Lazy注解延迟一个Bean的加载。实际项目中我更推荐第一种，因为循环依赖本身往往意味着类职责没有拆干净，重构比绕过去更健康。

打包到Docker的时候也容易踩坑，尤其是“SpringBoot JDK1.8打包到DockerDesktop”这种场景。Docker镜像里必须自带一个能跑jar包的JDK环境，所以Dockerfile开头的FROM指定成openjdk:8-jdk-alpine，然后把jar包复制进去，暴露端口，执行启动命令。如果不对照服务器环境JDK版本，jar在服务器上就会出现“UnsupportedClassVersionError”，低级但极其常见。这个错误本质是编译用的JDK版本比运行环境的JDK版本新，解决方案要不就是把编译JDK降下来，要不就是把运行环境升上去。

4.5 远程教育网站常见问题排查速查

我把做这个项目最容易踩到的坑整理成一份速查表，希望你在部署联调的时候能少走弯路。

这里面有些问题的表象是一样的，但原因千差万别，排查时记得先分前后端、再分上下游，用排除法定位，别一上来就怀疑框架有问题，大多数时候都是自己配漏了。

5. 一些项目之外的建议

5.1 怎么把项目讲给面试官听

远程教育网站这类项目在面试里被问到的概率非常高，但很多人答不好，原因是只会背自己写的代码，没有从业务角度讲清设计过程。我建议从三个方面来总结你的项目：第一，说清楚你解决了什么问题——用户如何在线学习、管理员如何管理课程、订单如何流转；第二，说清楚技术选型的原因——为什么SpringBoot而不是SSM，为什么JWT而不是Session；第三，说清楚你最满意的模块设计——推荐讲订单状态流转，因为它涉及业务规则、异常场景和状态设计。如果你把这三个问题提前准备好，面试官不管怎么追问都能留有余地。

5.2 后续可以怎么扩展

这个项目做完不是终点，我想再给几个扩展方向：接入Redis做课程列表缓存和高频接口限流；引入消息队列解决下单后的异步通知；对接云存储保存课程视频；给前端加一个在线播放进度断点续播；把后台的订单统计升级为图表报表。这些扩展写在项目迭代记录里，比简历上写“熟练使用XX框架”能说明的东西更多，因为它们是可验证的、有落地场景的优化动作。

5.3 关于我的最后一条心得

踩过远程教育网站部署的坑之后，我最大的体会是：这类项目里，最难的部分从来不是写CRUD，而是把无状态的用户请求和有序的业务状态结合到一起，并在各种极端情况下保持数据的一致和用户体验的连贯。比如用户支付后网断了，订单到底怎么处理；课程下架时已有学员是否还能继续看视频，这些真实场景才真正拉开做项目的深度。你如果正在做这个项目，先把主链路跑通，再慢慢逼自己去思考“异常的时候怎么办”，写出来的东西质量会有质的飞跃。