企业官网建设流程全解析

这套 Spring Boot 家教信息服务系统，前后做了三周，源码已经完整打包。起因特别简单，身边好几个朋友都在为孩子找家教发愁，另一端又有不少研究生和在职老师空闲时间想带课，两边需求都对上了，就是缺一个顺畅的对接渠道。刚好课程设计需要一个完整 Web 项目，我就把这个真实场景落成了系统。整套代码不算复杂，但功能闭环完整：学生/家长注册后能按科目、年级、区域和价格找家教，教员能发布个人资料和授课信息，双方在线约课，管理员负责审核和内容管理。如果你正在做基于 Spring Boot 的毕设或 Java 课程设计案例，或者刚学完 Spring Boot 想找一个能练手的完整项目，这份源码和这篇拆解可以帮你省不少时间。

1. 项目整体设计与需求拆解

1.1 三类角色把业务闭环拼完整

家教服务系统第一件事就是把“谁用”这个问题想清楚。这个项目里一共三类角色：

• 学生/家长端：核心动作是找老师和约课。需要能看到教员列表，按科目（数学、英语、物理等）、年级（小学、初中、高中）、所在区域、课时费区间做筛选；点进教员详情页能看到教育背景、教学年限、授课风格介绍和历史评价；确认合适后直接发起约课申请。
• 教员端：核心动作是发布和维护自己的授课档案。注册后需要填写真实姓名、授课科目、适合的年级、可授课时间段、期望课时费、教学经历等，提交后由管理员审核。审核通过的信息才会出现在前端检索列表里。
• 管理员端：核心动作是内容和风控。审核教员资料是否真实合规，管理首页公告、科目分类、处理用户的约课申诉，必要时候下线某个教员或删除违规评价。

我画业务流程图的时候发现，这三类角色其实天然构成一个闭环：教员发布信息 -> 学生检索并约课 -> 订单进入待确认状态 -> 教员接单或拒绝 -> 双方线下完成授课 -> 学生对这次服务做评价。这个闭环里每一步都有明确的数据归属，系统设计起来不会乱。你如果只是照着网上一些残缺项目抄，很容易漏掉“审核”和“评价”这两个环节，结果做出来只是一个信息展示站，根本不能叫“服务系统”。

1.2 需求分析时的关键取舍

做这类系统，最忌讳的是什么都想装。我一开始列的功能清单里有在线视频授课、按小时排课、在线支付、积分商城，后来全部砍掉了。原因很简单：一套课程设计/毕业设计语境下的系统，核心是要把“信息服务”和“订单流转”讲清楚，支付涉及第三方接口和资质，视频涉及推流和房间管理，这些属于锦上添花，而不是骨架。

最终保留的功能是这样几个原则：

1. 信息流要通：家教档案、需求信息、站内公告都能被目标用户看到，并且支持最基本的检索。
2. 单据要可追溯：学生发起的约课申请，到教员确认，到完成，每一步都留下状态记录和操作时间。
3. 内容要有人管：管理员能对最敏感的数据（教员认证信息、评价内容）做审核和干预。
4. 界面要能用：不追求漂亮，但页面布局和按钮逻辑要让不懂技术的人也能顺手操作。

这个取舍背后其实是一个很实用的判断标准：你做的系统，最终要能在答辩或者验收时，用两分钟讲清楚“它为谁解决什么问题”。功能越多，越讲不清。与其铺开做十个半成品模块，不如把三个核心模块做扎实。

2. 技术选型：为什么是 Spring Boot，以及配套方案怎么配

2.1 Spring Boot 解决的最核心痛点

选 Spring Boot 不只是因为它火，而是因为它确实适合这种“从零快速搭一个可演示系统”的场景。传统 SSM 项目光配置就得折腾一两天，Spring Boot 的自动装配机制把大量样板配置接管了。你写一个带 @SpringBootApplication 注解的入口类，内嵌的 Tomcat 启动完，一个能处理 HTTP 请求的 Web 服务就起来了。这就是所谓的 springboot自动装配原理核心价值：约定大于配置，框架帮你在启动阶段根据 classpath 里的依赖自动注册对应的 Bean。

我自己用下来最直观的体感是三点：

• 依赖管理省心：spring-boot-starter-web 一个依赖就把 web 场景、json 序列化、内嵌服务器、参数校验全部带齐了。
• 外部化配置清晰：所有连接信息都集中在 application.yml 里，换数据库、换端口、调日志级别，改配置重启就行，不用翻一堆 XML。
• 打包部署简单：Maven 打包出来一个 fat jar，java -jar 就能跑，这在演示和交付的时候非常加分。

这个项目做的时候还专门注意了版本问题。现在网上搜 springboot 教程，很多例子还是 2.x 甚至 1.x 的写法，如果你装了 JDK 17 又拉到 Spring Boot 3.x，很多老代码会直接报错。我最终选的是 Spring Boot 2.7.x + JDK 8/11 的组合，这也是大部分课程设计环境最稳的搭配。具体版本踩坑我在第 6 节单独讲。

2.2 配套技术栈的搭配逻辑

除了 Spring Boot，这套系统的完整技术栈是这样的：

有人可能问，为什么不用 Vue 做前后端分离？分离不是不行，我见过很多同学用 Spring Boot + Vue 做出来的效果也不错，但我们这个项目有个实际情况：希望直接启动后端就能完整演示，包括页面，不要在 Node 环境多一道构建步骤。Thymeleaf 的好处是只要把对应模板放在 templates 目录下，后端 Controller 返回视图名就能渲染，对一个以业务闭环为核心的系统来说，开发效率和演示流畅度都更高。如果你非要前后端分离，结构上把 Controller 改成返回 JSON、前端用 Vue 脚手架单独跑，后端代码几乎不用大改，后面我会提一下改动点。

2.3 数据库表设计：六张核心表

表结构是整个系统的地基，我设计的时候一共六张核心表。你可以直接导入源码里的 tutor_system.sql 使用：

• t_user：用户表。字段有 id、username、password、real_name、phone、role（student/tutor/admin）、status、create_time。
• t_tutor_profile：教员档案表。挂在用户表之下，字段有 user_id、subject（授课科目）、grade（适合年级）、area（所在区域）、price_per_hour（课时费）、school（毕业/在读院校）、teaching_exp（教学经历）、intro（自我介绍）、head_img（头像）、status（0 待审核，1 审核通过，2 已下线）。
• t_demand：约课需求表。学生填写期望科目、年级、区域、预算和备注说明，方便教员端反向查看。
• t_order：订单表。字段有 order_no、demand_id、student_id、tutor_id、tutor_profile_id、price、status（0 待教员确认，1 待上课，2 已完成，3 已取消）、create_time、finish_time。
• t_comment：评价表。order_id、student_id、tutor_id、rating（1-5 整数）、content、create_time。
• t_notice：公告表。title、content、create_time，管理员后台维护，首页展示。

这个表设计的核心思路是“订单表对信息表、评价表对订单表”。订单表是通过中间层，把学生和教员两个角色的行为真正关联起来的唯一纽带。评价表挂在订单底下，既保证评价者一定是真实下过单的用户，也方便以后统计某个教员的平均评分。如果你做成一个纯展示没有订单关系的评论模块，数据就失去了可信度，这是家教类平台最敏感的一点。

注意：我没有建物理外键，而是用 Java 层逻辑维护关联。原因很简单，物理外键在删除数据、批量导入时会带来很多限制，课程设计阶段用逻辑外键就够了，还能少踩不少坑。

3. 核心功能模块实现：从注册到完成一次约课

3.1 用户注册登录与角色权限

整个系统的入口是注册和登录。注册页让用户选择角色：我是学生/家长，还是我是教员。选不同角色，注册后进入的路由和要补填的信息不一样。学生注册完直接进入首页，教员注册完会先被引导到“完善授课档案”页面。

密码处理这块我坚持用了加盐哈希，用的 Spring 自带的 BCryptPasswordEncoder，而不是网上很多源码里那种明文存储或者简单 MD5。理由不用多说，你也不希望自己的项目代码里出现把用户密码明文落库的低级操作。

登录逻辑的 Controller 大概长这样：

@PostMapping("/login") public String login(String username, String password, String role, HttpSession session, Model model) { User user = userService.login(username, password, role); if (user == null) { model.addAttribute("error", "用户名或密码错误"); return "login"; } session.setAttribute("user", user); if ("admin".equals(user.getRole())) { return "redirect:/admin/index"; } if ("tutor".equals(user.getRole())) { return "redirect:/tutor/profile"; } return "redirect:/index"; }

登录之后怎么知道当前用户是谁？这个项目用的是 Session + 拦截器。登录成功往 Session 里塞一个 user 对象，然后通过拦截器拦截需要登录的路径，比如 /student/、/tutor/、/admin/**。拦截器代码不复杂，但它是整个权限控制的骨架，我在第 4 节会贴关键代码。

角色权限的落点是把“操作按钮的可见性”和“请求路径的可达性”一起控制。比如首页导航栏，根据 session 里的 user.role 决定显示“我的授课档案”还是“我要找家教”；而 /admin/** 路径无论导航栏怎么藏，后端拦截器都会校验 role 必须是 admin 才放行。这里有个容易漏的坑：很多人只在页面上做了权限隐藏，没有做后端拦截，结果懂点技术的用户直接拼接 URL 就能访问后台页面。这个项目的源码里拦截器是全局生效的，你复用的时候千万别把这块砍掉。

3.2 家教信息发布与条件检索

教员端最核心的操作是维护自己的授课档案。表单字段比较多，我特意做了一个两步提交：第一步填写基本资料（真实姓名、手机号、所在城市），第二步填写授课信息（科目、年级、区域、课时费、教学经历），最后上传一张头像。

这里面有两个关键细节：

第一个是头像上传。文件上传用的 Spring MVC 的 MultipartFile，限制大小 10MB，存到项目本地的 upload 目录，数据库里只存相对路径。这样既避免把图片二进制塞进数据库导致表膨胀，又能在页面用简单的渲染出来。上传目录要在配置类里映射成静态资源路径，不然浏览器访问不到，这个细节很多初次接触的人会卡住。

第二个是审核状态。教员提交或修改档案后，status 一律重置为 0（待审核）。前端检索列表只查 status=1 的记录，也就是说，除非管理员在后台点了通过，否则这个教员即使注册了也不会出现在学生端页面上。这个机制保证了平台信息的可信度，也是答辩时能拿出来讲的管理亮点。

学生端检索我做了“科目 + 年级 + 区域 + 价格上限”四个条件的组合查询。实现上就是一个动态 SQL，四个条件都有值就 AND 拼接，没有值就跳过。用 MyBatis-Plus 的话可以直接构造 LambdaQueryWrapper 做条件判断，非常干净。分页用的 MyBatis-Plus 的 Page 对象，前端底部展示上一页/下一页和页码数字。

3.3 约课订单的完整状态流转

订单是这个系统的“心脏”，也是我建议你重点看源码的部分。约课流程是这样：

1. 学生在家教详情页点击“预约这位老师”，弹出确认框，填写期望上课时间和备注。
2. 后端创建一条订单，status=0（待教员确认）。
3. 教员端“收到的约课申请”列表里出现这条记录，教员点“接受”，订单变为 status=1（待上课）；点“拒绝”，订单变为 status=3（已取消）。
4. 双方线下完成首次授课后，学生（或教员）在订单详情页点“确认完成”，订单变为 status=2（已完成）。
5. 订单完成后，订单详情页出现“去评价”按钮，学生可以打分和写评语。

这个状态机我特意设计了四个状态，并且把“拒绝”也算作一种操作，而不是直接把记录删掉。原因是在真实业务里，被拒绝的需求可能被其他教员看到，而且订单记录本身是后续评价和追溯的依据，删了就说不清了。你可以在这个基础上继续扩展，比如增加“授课中”“已超时”等状态，但核心原则是：订单状态必须是单向可追踪的，任何状态变化都要记录时间戳。

3.4 评价体系和后台审核

评价模块的逻辑绑定在订单之上。学生只有对状态为“已完成”的订单才能评价，而且一个订单只能评价一次，后端在创建评价前先查该 order_id 是否已经存在记录。评价内容分为 1~5 分星级加一段文字，前台详情页展示最近 10 条评价和平均分。

后台管理是这个项目里最容易被初学者低估的模块。很多人觉得后台就是写几个增删改查的页面，其实不是。我们这个后台有四个 Tab：

• 教员审核：列出所有 status=0 的教员档案，逐条查看并点击“通过”或“驳回”。驳回时要求填写原因，驳回原因会反馈到教员端消息里。
• 用户管理：停用/启用账号，重置密码，查看某个用户关联的订单和评价。
• 公告管理：新增、编辑、下线首页公告。
• 数据统计：这个是加分项，我只做了一个简单的“注册用户数、待审核教员数、本月新增订单数”三个数字的仪表盘。

后台的页面不需要多华丽，但操作路径要顺。我用了一个简单的侧边栏模板，每块是独立表格，公共部分抽成了一个 common 模板片段。这样代码量不大，但管理员用起来是顺手的。

4. 关键代码解读：源码里最值得看的三处

拿到源码之后，你最先应该看的不是页面，而是下面这三个位置的代码。它们基本上代表着这套系统能不能算“完整”的分界线。

4.1 配置文件：application.yml 的坑与正确写法

application.yml 是启动的第一道关。我配置里的内容也踩过不少坑，最后稳定版是这样：

server: port: 8080 servlet: session: timeout: 30m spring: datasource: url: jdbc:mysql://localhost:3306/tutor_system?useUnicode=true&characterEncoding=utf-8&serverTimezone=Asia/Shanghai&useSSL=false&allowPublicKeyRetrieval=true username: root password: 123456 driver-class-name: com.mysql.cj.jdbc.Driver thymeleaf: cache: false servlet: multipart: max-file-size: 10MB max-request-size: 50MB web: resources: static-locations: classpath:/static/,file:upload/ mybatis-plus: mapper-locations: classpath:mapper/*.xml configuration: map-underscore-to-camel-case: true log-impl: org.apache.ibatis.logging.stdout.StdOutImpl

几个容易踩的位置我给你标出来：

• url 里的 serverTimezone=Asia/Shanghai 必加。MySQL 8 默认使用 UTC 时区，不加这个参数，数据库连接时间正常但写入 timestamp 字段会差八个小时。
• driver-class-name 一定是 com.mysql.cj.jdbc.Driver，不是老教程里的 com.mysql.jdbc.Driver。后者是 MySQL 5 时代的写法，在 MySQL 8 驱动下会直接启动报错。
• allowPublicKeyRetrieval=true是 MySQL 8 的加密连接要求，不加在某些环境会报 Public Key Retrieval is not allowed。
• thymeleaf.cache=false 改为 false，开发阶段改模板不用重启才能生效，否则每次都要等缓存刷新。
• 静态资源映射：file:upload/这一句必须配**，不然你上传到头像目录的图片在页面上永远显示不出来。

4.2 登录拦截器：权限控制的骨架

拦截器是所有受保护路径的第一道门。源码里 LoginInterceptor 是这样的设计：

@Component public class LoginInterceptor implements HandlerInterceptor { @Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { HttpSession session = request.getSession(); User user = (User) session.getAttribute("user"); if (user == null) { // 未登录，跳转到登录页，并记录来源路径以便登录后回跳 String path = request.getRequestURI(); response.sendRedirect("/login?redirect=" + URLEncoder.encode(path, "UTF-8")); return false; } return true; } }

然后通过 WebMvcConfigurer 注册拦截器并配置放行规则：

@Configuration public class WebConfig implements WebMvcConfigurer { @Autowired private LoginInterceptor loginInterceptor; @Override public void addInterceptors(InterceptorRegistry registry) { registry.addInterceptor(loginInterceptor) .addPathPatterns("/**") .excludePathPatterns( "/", "/index", "/login", "/register", "/logout", "/tutor/list", "/tutor/detail/**", "/notice/**", "/css/**", "/js/**", "/images/**", "/upload/**", "/error" ); } }

注意 excludePathPatterns 必须把静态资源也放行，否则登录页自己加载不出 CSS 样式，那画面真的很尴尬。另外，如果你的项目引入了 Spring Security，那么拦截器这套方案就要换掉，但作为课程设计，自定义拦截器反而更容易在答辩的时候讲清楚“我是怎么做权限控制的”。

4.3 组合查询与分页：MyBatis-Plus 的正确打开方式

检索是学生端用得最多的功能，代码是这样：

@Service public class TutorServiceImpl implements TutorService { @Autowired private TutorProfileMapper tutorProfileMapper; @Override public Page<TutorProfileVO> search(TutorSearchQuery query) { LambdaQueryWrapper<TutorProfile> wrapper = new LambdaQueryWrapper<>(); wrapper.eq(TutorProfile::getStatus, 1); // 只查审核通过的 wrapper.like(StringUtils.hasText(query.getSubject()), TutorProfile::getSubject, query.getSubject()); wrapper.like(StringUtils.hasText(query.getGrade()), TutorProfile::getGrade, query.getGrade()); wrapper.eq(StringUtils.hasText(query.getArea()), TutorProfile::getArea, query.getArea()); wrapper.le(query.getPriceMax() != null, TutorProfile::getPricePerHour, query.getPriceMax()); wrapper.orderByDesc(TutorProfile::getCreateTime); Page<TutorProfile> page = new Page<>(query.getPageNum(), query.getPageSize()); Page<TutorProfile> result = tutorProfileMapper.selectPage(page, wrapper); // 把实体转为 VO，补上用户昵称、头像等可展示字段 return convertToVO(result); } }

这段代码的核心是 LambdaQueryWrapper 的条件构造。条件里 if 判断的写法很关键：直接用 wrapper.like(条件为 true 才拼接) 的方式，就不用写一堆 if 后再拼接字符串，代码干净很多。分页用 MyBatis-Plus 的 selectPage 自带拦截器实现，不需要再额外引入 PageHelper。这个组合查询+分页的写法，你在其他管理类系统的列表页里也能无缝复用。

5. 从源码到跑起来：完整启动路径与验证流程

代码光看不能算会用，我按最干净的路径把整个启动过程列一遍。

5.1 环境准备

你需要准备的工具和版本：

拿到源码后，IDEA 里选择 File -> Open，直接选中项目根目录的 pom.xml 打开即可。首次打开会花几分钟下载依赖，你可以在 Maven 面板里看进度，别急着点运行。

5.2 导入数据库

用 Navicat 或命令行执行源码根目录下的 tutor_system.sql：

mysql -uroot -p123456 < tutor_system.sql

执行完会创建 tutor_system 数据库和六张表，并且插入一份初始数据：一个管理员账号（admin / admin123）、两个审核通过的测试教员、一条公告。

5.3 修改配置并启动

把 application.yml 里的数据库账号密码改成你自己的，保持其他配置不动。用 IDEA 打开项目后，等 Maven 依赖下载完，直接运行 TutorApplication 的 main 方法。控制台出现下面这行就是启动成功：

Tomcat started on port(s): 8080 (http) with context path ''

浏览器访问 http://localhost:8080 就能看到首页。

5.4 用测试账号走一遍核心流程

我建议你按这条路径把系统完整走一遍，这一步最锻炼人：

1. 用 admin / admin123 登录后台，在教员审核里把某个待审核账号通过。
2. 用注册的学生账号去首页搜索“高中数学 朝阳区 200 元以下”，找到教员点进详情。
3. 点击预约，填写备注，提交订单。
4. 用教员账号登录，在“收到的约课申请”里接受这条订单。
5. 学生账号在订单详情点确认完成，然后评价。

这一套走下来，你对表结构之间怎么关联、状态怎么流转的理解，比看十遍代码都有用。

5.5 命令行打包部署

如果要在服务器或别的机器上部署，执行：

mvn clean package -DskipTests java -jar target/tutor-system-0.0.1-SNAPSHOT.jar

外网访问时记得检查服务器防火墙和安全组规则，放开 8080 端口即可。生产环境我不会建议直接用内嵌 Tomcat 跑服务，但演示和交付已经足够。

6. 高频问题排查技巧与避坑记录

这部分是我实际跑这个项目时踩过的所有坑，整理成一个速查表，再挑三个最常见的详细说。

6.1 Spring Boot 版本太高导致的隐形问题

这是新手最常踩也是最难查的一类问题。很多教程代码是基于 2.x 写的，但你在 IDEA 新建项目时默认选到了 3.x，一启动就会出现各种诡异报错，比如 javax.servlet 包不存在、循环依赖检测不通过、或者某些 starter 因为版本冲突直接找不到类。

判断方法很简单：看你的 pom.xml 里 parent 的版本号。如果你用 JDK 8，Spring Boot 3.x 根本跑不起来，因为 3.x 强制要求 JDK 17。如果你用 JDK 17 又想跑 2.7 的老项目，需要确认 IDEA 的 Project Structure 里 Language Level 是否指向 8 或 11。我建议最省事的办法：用 IDEA 新建一个 Spring Boot 项目，版本明确选择 2.7.18 + Java 8，然后把源码里的代码和资源平铺进去，这样能避开 90% 的版本坑。

6.2 数据库连接串：一个字符都不能错

数据库连不上是另一个高频问题。MySQL 8 下最常见的是这几个报错：

• The server time zone value 'Öйú±ê׼ʱ¼ä' is unrecognized：乱码本质是时区问题，连接串加 serverTimezone=Asia/Shanghai。
• Public Key Retrieval is not allowed：加 allowPublicKeyRetrieval=true。
• Communications link failure：确认 MySQL 服务有没有启动，Windows 服务里 mysql 是否在运行，端口 3306 是否被占用。

我见过有人把所有报错截图发群里求助，一看只是数据库服务没开。建议你在 IDEA 右侧 Database 面板先建一条连接测试，通了再启动项目，能省很多排查时间。

6.3 IDEA 里运行源码前的三个确认项

拿到别人给的源码，别急着双击运行。先做下面三件事，能避免一半的问题：

1. 确认 Maven 仓库依赖下载完成：打开 Maven 面板，如果 pom 文件有红色波浪线，等右侧 Process 跑完再操作；IDEA 右下角出现绿色对勾说明依赖 OK。
2. 确认 Lombok 插件已安装并启用：项目实体类用了 @Data、@Getter 等注解，如果没有 Lombok 插件，编译会报找不到 getter/setter。新版 IDEA 内置了 Lombok，老版本需要自己装。
3. 确认 Project SDK 和 Language Level 一致：File -> Project Structure 里 SDK 选 JDK 8/11，Language Level 选 8，Modules 里同样设置。不一致的时候，有时编译通过但运行报错，最坑。

7. 这套源码后续还可以怎么扩展

如果你做完基础版还想继续加分，我给几个切实可行的扩展方向，按性价比排序：

1. 检索升级：把数据库 LIKE 查询换成 Elasticsearch，支持更快的全文检索和相关性排序。这个对面试简历很加分，但成本也高，要起 ES 实例。
2. 消息通知：订单状态变化时给相关用户推送站内信或邮件通知。用 Spring Boot 的 @Async 注解做异步发送，代码不复杂，体验提升很大。
3. 前后端分离：把 Controller 改用 @RestController 返回 JSON，前端用 Vue 3 + Element Plus 单独搭，接口保持语义一致即可。改造的关键是跨域配置和登录态从 Session 换成 Token。
4. 接入对象存储：本地文件上传改成 OSS 或者 MinIO，解决服务器重启后上传文件丢失的问题。这个我在开发过程中也研究过，minio 加入到 springboot 其实就是加一个 starter 依赖再配个 bucket，代码量不大。
5. 管理员统计报表：用 ECharts 展示每日订单趋势、热门科目排行、教员评分分布，视觉效果和答辩效果都很明显。

我个人的建议是，如果你时间有限，优先做消息通知和 ECharts 报表，这两个性价比最高，尤其是答辩现场能直观看到数据变化，比讲一百行代码都有说服力。

最后再分享一个实操细节：这套源码里我特意把每个模块的注释写得比较全，特别是 Service 层和状态流转的地方，因为不管你自己后面维护还是交给同学接手，注释都是省时间的东西。系统跑通之后，建议你花半小时把数据库表关系画出来，再对着代码捋一遍请求从 Controller 到 Service 到 Mapper 的路径，这半小时比你再多看两个教程都管用。