企业官网建设流程全解析

这个项目是我去年帮学弟做毕业设计时从零到一完整跑通的一个SpringBoot实战项目，平台名字叫“基于SpringBoot的红色知识学习平台”。前前后后改了七八个版本，从最初连登录都跳不过去，到最后顺利答辩、部署上线，中间踩过的坑非常值得拿出来讲一讲。今天我把这个项目的整体设计思路、核心模块实现、数据库设计还有部署流程完整整理出来，给正在做Java毕设、或者想找一个完整SpringBoot项目练手的朋友做个参考。

这个项目说白了就是一个“在线知识学习系统”，只不过内容主题是红色文化方向。用户端能注册登录、浏览分类知识文章、收藏内容、记录学习进度、参与在线答题；管理端则负责内容发布、分类管理、用户管理、答题管理。技术上看，它覆盖了JavaWeb方向几乎所有高频考点：登录认证、权限控制、增删改查、分页查询、文件上传、接口鉴权、前后端交互，所以说它是很适合拿来当毕业设计的题目。

下面我就从项目设计、数据库、核心实现、部署和踩坑五个方面来拆解。

1. 项目概览与整体设计思路

1.1 这个项目是什么，适合谁参考

红色知识学习平台，本质上是一个垂直领域的知识内容管理系统加上在线学习功能。它解决的痛点很直接：传统线下学习材料分散、进度难跟踪、无法量化学习效果，于是把这套流程搬到线上，做成一个既可以“看内容”，又可以“测效果”的平台。

具体功能拆下来大概是这样的：

• 用户端：注册登录、个人中心、知识文章浏览与搜索、内容分类筛选、文章收藏、学习进度记录、在线答题与成绩查看。
• 管理端：管理员登录、知识内容的新增编辑和上下架、分类维护、用户查询与管理、题目和答案维护、基础数据统计。

适合参考的人我总结了三类：第一类是正在做SpringBoot方向毕业设计的学生，这个项目结构完整、技术点密集，论文也好写；第二类是自学SpringBoot三件套但缺一个完整项目串联知识的人，跟着捋一遍能搞懂登录认证、权限控制、数据流转这些核心概念；第三类是校内社团、单位内部想快速搭一个轻量学习平台的人，代码精简不臃肿，部署成本也低。

1.2 技术选型：为什么选SpringBoot而不是SSH

关于技术栈，很多同学会纠结：学校课程教的是SSH（Struts2+Spring+Hibernate），网上主流却是SpringBoot，我到底选哪个？我的建议非常明确：只要不是老师硬性要求，直接选SpringBoot。

理由不复杂。第一，SSH的XML配置实在太多了，一个小的数据源配置都要写半天，而SpringBoot的“约定优于配置”和自动装配机制把这些繁琐的模板代码全部干掉了。第二，SpringBoot生态太成熟了，Spring Security、MyBatis-Plus、Redis、MinIO这些常用组件都有极低的上手成本。第三，毕业答辩的时候，老师大概率会问“SpringBoot的自动装配原理是什么”“ starter 机制怎么理解”，选SpringBoot等于把问题圈定在一个你自己熟悉且容易准备的范围内。

我把SpringBoot的自动装配用生活化的方式理解：你不用关心餐厅后厨怎么切菜，只需要在菜单上勾选套餐（等价于引入starter依赖），后厨就会自动把米饭、菜、甜品配好端上来（等价于框架自动帮你注入好所有Bean）。你只要拿起筷子吃就行。这种思想让项目骨架搭起来非常快，前后端工程师协作时也不容易因为配置问题扯皮。

1.3 整体架构与请求链路

我做的是前后端分离的方案。后端用SpringBoot只负责提供RESTful接口，前端用Vue开发页面，部署时用Nginx托管前端静态资源，同时把API请求反向代理到后端服务。

这样做的好处有三点。第一是答辩素材多，前后端分离、跨域处理、接口文档这些都能当作亮点去讲；第二是开发效率高，我不用每次调样式都重启后端；第三是部署清晰，前端是纯静态文件，后端是一个独立Java进程，出问题更好排查。

整体请求链路是这样的：

浏览器访问域名 -> Nginx返回Vue静态页面 -> 页面里的Ajax请求打到 /api 路径 -> Nginx把 /api 开头的请求反向代理到 127.0.0.1:8080 -> SpringBoot处理请求并访问MySQL -> 返回JSON数据给前端渲染。

需要注意的细节是，前后端分离之后必然会遇到跨域问题。我在后端配置了全局CORS策略，允许前端开发服务器的地址跨域访问，同时在Spring Security里把OPTIONS请求放行，否则浏览器预检请求会被拦截，页面会莫名其妙地拿不到数据。

2. 数据库设计与核心表结构

2.1 建表之前想清楚的三件事

很多同学做项目一上来就建表，这是最容易返工的开端。我建模之前先问了自己三个问题。

第一，用户体系怎么设计？我需要的角色很简单，普通用户和管理员。不需要搞太复杂，在用户表里用一个role字段区分即可。但密码必须加密存储，不能是明文。第二，知识内容怎么组织？平台的内容是文章和视频混合，视频需要存封面和播放地址。我把它们统一放在一张内容表里，用content_type字段区分图文还是视频，这样查询列表时逻辑简单。第三，学习行为怎么落库？学习进度、收藏、答题记录都属于“用户产生数据”，要与内容表分离开，单独建表，这样内容表不会无限膨胀。

建模前把这三件事想明白，后面写Mapper和Service的时候会非常顺畅。

2.2 用户、分类与内容模块表设计

用户表（user）字段不算多，但每个字段都有讲究：

• id：主键自增
• username：用户名，唯一索引
• password：BCrypt加密后的密码
• nickname：昵称，做前台展示用
• avatar：头像URL
• role：角色，0表示普通用户，1表示管理员
• status：账号状态，0禁用，1正常
• create_time：注册时间

分类表（category）比较简单：id、name、parent_id、sort_order。parent_id是为了以后做二级分类预留的，现在内容量不大，用一级分类也完全足够。

知识内容表（article）是整个项目的货架表，字段有id、category_id、title、summary、cover、content、content_type、video_url、view_count、status、create_by、create_time。create_by后面关联管理员表，方便追溯是谁发布的；status字段控制上下架，不需要物理删除内容，方便以后重新上架。

索引方面，我在category_id、status、create_time上建了联合索引。因为列表页最常用的查询条件是“某个分类下已上架的内容，按照发布时间倒序”，这个联合索引能直接命中，避免全表扫描。

2.3 学习行为与答题模块表设计

学习行为涉及三张表。

学习记录表（study_record）记录用户每次学习内容的情况，字段有id、user_id、article_id、progress（观看进度，0到100整数）、study_duration（累计学习秒数）、last_study_time。每次用户上报进度时，如果同一条记录存在就更新，不存在就新增。

收藏表（favorite）很简单：id、user_id、article_id、create_time。需要注意的是，要加唯一约束（user_id, article_id），防止用户重复收藏同一条内容。

答题模块我设计了两张表。题目表（question）存的是题库，字段有id、category_id、title、question_type（单选/多选/判断）、options（选项JSON字符串）、answer（正确答案）、analysis（答案解析）、score（分值）。答题记录表（exam_record）存用户每次考试的整体情况，字段有id、user_id、total_score、correct_count、question_count、duration、create_time。

这里有个经验：题目的选项我建议用JSON串存，不要拆成四五个字段。因为单选、多选、判断三种题型的选项数量不一致，用title、option_a、option_b这种固定字段去存会很别扭，JSON串虽然查询时不好直接统计，但考试答题场景基本都是读出来然后在内存里处理，性能完全没问题。

3. 核心功能实现与难点拆解

3.1 JWT登录认证：从原理到配置

登录认证是这个项目里最容易被问、也最容易写崩的部分。我选的是Spring Security + JWT的组合，状态无关，非常适合前后端分离场景。

认证流程是：用户提交用户名密码，后端校验通过后，用JWT工具类生成一个token串返回给前端，前端存在localStorage里。之后每次请求，前端在请求头里带上Authorization: Bearer token，后端写一个过滤器去解析这个token，解析成功就把用户信息塞进SecurityContext，失败就返回401。

先看JWT工具类的核心方法：

public class JwtUtil { private static final String SECRET_KEY = "your-secret-key-change-in-production"; public static String generateToken(String username, String role) { return Jwts.builder() .setSubject(username) .claim("role", role) .setIssuedAt(new Date()) .setExpiration(new Date(System.currentTimeMillis() + 1000 * 60 * 60 * 24)) .signWith(SignatureAlgorithm.HS256, SECRET_KEY) .compact(); } public static Claims parseToken(String token) { return Jwts.parser() .setSigningKey(SECRET_KEY) .parseClaimsJws(token) .getBody(); } }

然后是核心的过滤器，继承OncePerRequestFilter，在每个请求进来时尝试解析token：

public class JwtAuthenticationFilter extends OncePerRequestFilter { @Override protected void doFilterInternal(HttpServletRequest request, HttpServletResponse response, FilterChain chain) throws ServletException, IOException { String header = request.getHeader("Authorization"); if (header != null && header.startsWith("Bearer ")) { String token = header.substring(7); try { Claims claims = JwtUtil.parseToken(token); String username = claims.getSubject(); String role = claims.get("role", String.class); UsernamePasswordAuthenticationToken authentication = new UsernamePasswordAuthenticationToken(username, null, Collections.singletonList(new SimpleGrantedAuthority("ROLE_" + role))); SecurityContextHolder.getContext().setAuthentication(authentication); } catch (Exception e) { // token无效或过期，保持匿名状态 } } chain.doFilter(request, response); } }

这里有几个细节必须注意。不能在所有请求上都强制校验token，登录接口、注册接口和内容浏览接口应该放行。我在SecurityConfig里用permitAll()把无需认证的路径显式声明出来。token过期时间我设置的是24小时，反复踩过坑才明白：过期时间太短用户要频繁登录，体验差；太长又会有安全隐患，毕业设计场景24小时比较合适。生产环境一般把密钥放到配置文件中，不要硬编码在类里。

3.2 知识内容的发布、浏览与分页

内容模块的核心是分页查询。这里我直接用了MyBatis-Plus的IPage，代码非常简洁：

public IPage<ArticleVO> getArticlePage(int pageNum, int pageSize, Long categoryId) { Page<Article> page = new Page<>(pageNum, pageSize); LambdaQueryWrapper<Article> wrapper = new LambdaQueryWrapper<>(); wrapper.eq(Article::getStatus, 1); if (categoryId != null) { wrapper.eq(Article::getCategoryId, categoryId); } wrapper.orderByDesc(Article::getCreateTime); return articleMapper.selectPage(page, wrapper); }

分页接口返回的内容，我不会直接把数据库实体丢给前端，而是转成一个VO（View Object），把createBy这种内部字段隐藏掉，再额外追加一个isFavorite字段，标示当前用户是否已收藏这条内容。这个字段在前端列表页非常关键，不然用户根本不知道哪些内容收藏过了。

内容发布的后台接口，核心是文件上传。封面图我用本地上传方案：保存到服务器指定目录，然后返回一个访问URL。这里要注意，本地目录不能随便找，我建议统一放在项目配置的upload.dir下，Nginx再把该目录映射为静态资源访问。这样后台上传图片后，前端直接拿到一个可访问的图片地址，不依赖后端再写一个图片流接口。

图片上传的核心代码如下：

public String uploadFile(MultipartFile file) { if (file.isEmpty()) { throw new BusinessException("文件不能为空"); } String originalFilename = file.getOriginalFilename(); String ext = originalFilename.substring(originalFilename.lastIndexOf(".")); String fileName = UUID.randomUUID() + ext; File dest = new File(uploadDir + "/" + fileName); try { file.transferTo(dest); } catch (IOException e) { throw new BusinessException("文件上传失败"); } return "/upload/" + fileName; }

文件名必须用UUID重写，千万不能直接用原始文件名，这是血的教训。要是上传两张同名的图片，第二张直接覆盖第一张。文件大小也建议在Spring配置中限制一下，默认最大1MB，毕设场景足够，免得有人传一个几十兆的大图把服务器带宽打满。

3.3 学习进度与在线答题：最容易出bug的地方

学习进度这个功能看似简单，做起来细节很多。前端在用户进入文章详情时，通过接口上报一条学习记录。上报参数包括文章id、当前进度（0到100的整数）、本次学习时长。后端接口的逻辑是：先查这个用户对这篇文章有没有历史记录，有就更新，没有就新增。

有一个细节我优化过：如果一个用户反复打开同一篇文章，每次都新增记录，表数据会膨胀得很快。所以我在代码里用user_id + article_id做了一个唯一约束，把“更新”作为主逻辑，这样同一篇文章对同一个用户永远只有一条学习记录，历史数据只是不断累积时长和进度。学习时长和进度连续上报时的数据一致性也要注意，最好用定时器在前端每15秒上报一次，而不是每次切换页面都上报，减少接口压力。

在线答题模块我做了随机抽题、自动判卷、成绩记录三件事。随机抽题很简单，用SQL的随机排序取指定数量：

SELECT * FROM question WHERE category_id = #{categoryId} ORDER BY RAND() LIMIT #{limit}

自动判卷的核心思路是，前端把用户选择的答案对象列表提交到后端，后端遍历每一题，与question表里的answer字段比对，计算正确数量和总分，然后把结果写入exam_record表。这里尤其要注意多选题的判分逻辑：一题多选，必须选项完全一致才算对，少选多选都不得分。这个逻辑看起来很基础，但实际开发时很多人会忽略边界条件。

判分的Service方法核心片段：

public ExamResult submitExam(Long userId, List<UserAnswerItem> answers) { int correctCount = 0; int totalScore = 0; for (UserAnswerItem item : answers) { Question question = questionMapper.selectById(item.getQuestionId()); if (question == null) continue; totalScore += question.getScore(); if (checkAnswer(question, item.getUserAnswer())) { correctCount++; } } // 写答案记录表、返回成绩 }

4. 部署上线全流程实录

4.1 部署前必须调整的配置项

很多同学在本地跑得飞起，一到部署就卡住。核心问题在于，本地配置和服务器配置混在一起了。我建议在resources目录下拆出application-dev.yml和application-prod.yml两个配置，通过spring.profiles.active来控制激活哪一套。

生产环境配置必须改这几个地方：数据库地址改成服务器的内网IP和真实库名；数据库账号密码不能用root弱口令；JWT密钥换成一个随机长字符串；文件上传目录改成服务器的绝对路径，比如/opt/upload。端口保持8080不用动，因为外面有Nginx挡着。

数据库初始化这一步，我是先把本地的SQL文件导出来，包括建表语句和初始数据，然后上传到服务器执行：

mysql -u root -p < knowledge_platform.sql

有个很容易被忽略的坑：MySQL的字符集。如果建库语句里没有指定utf8mb4，导入中文数据后可能出现乱码。我初始化SQL开头都会带上：

CREATE DATABASE IF NOT EXISTS knowledge_platform DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;

4.2 服务器环境搭建

服务器我用的是Linux环境。基础环境分三步走：安装JDK 8、安装MySQL 5.7、安装Nginx。JDK安装很简单，下载tar包解压后配置JAVA_HOME即可。如果机器内存只有2G，建议给JVM设置一个合理的堆内存，在启动命令里加上-server -Xms256m -Xmx512m，避免默认值把内存撑爆。

MySQL 5.7在CentOS上的安装命令是：

yum install mysql-community-server -y systemctl start mysqld grep 'temporary password' /var/log/mysqld.log mysql_secure_installation

安装完成后，记得给新建的数据库用户只授权这个库的权限：

CREATE USER 'app_user'@'localhost' IDENTIFIED BY 'StrongPass123'; GRANT ALL PRIVILEGES ON knowledge_platform.* TO 'app_user'@'localhost'; FLUSH PRIVILEGES;

这样即使应用被注入SQL，也只能影响这一个数据库，不会拖垮整个MySQL实例。

4.3 用Nginx托管前端并完成联调

前端构建完以后，dist目录就是一堆纯静态文件。我把它传到服务器的/var/www/knowledge-platform目录下，然后配置Nginx。配置文件是最核心的部分，直接贴出来：

server { listen 80; server_name your-domain.com; # 前端静态资源 root /var/www/knowledge-platform; index index.html; # 解决Vue路由刷新404问题 location / { try_files $uri $uri/ /index.html; } # API反向代理 location /api/ { proxy_pass http://127.0.0.1:8080; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } # 上传的图片文件 location /upload/ { alias /opt/upload/; } }

注意location /api/这里，proxy_pass后面如果没有接路径，会把完整的 /api/xxx 传给后端；如果proxy_pass写成了http://127.0.0.1:8080/，那么 /api 前缀会被去掉，两种写法后端接收到的路径不一样。我后端所有接口统一以 /api 开头，所以这里直接用不加路径的写法，比较省事。

为了让后端服务在后台稳定运行、服务器重启后还能自动拉起，我写了一个systemd服务文件，虽然网上很多人直接nohup java -jar启动，但systemd的好处是崩溃后自动重启，日志统一管理，答辩演示的时候即使进程挂了也能自动恢复：

[Unit] Description=Knowledge Platform After=network.target [Service] User=root ExecStart=/usr/bin/java -jar /opt/app/knowledge-platform.jar --spring.profiles.active=prod Restart=always RestartSec=10 [Install] WantedBy=multi-user.target

配置好之后执行systemctl daemon-reload，再systemctl enable knowledge-platform，开机自启问题也解决了。

5. 常见问题与排查记录

5.1 我在部署和答辩演示时踩过的坑

把这个项目从头到尾跑完，前前后后遇到了不少典型问题。我整理成一个表格，每个问题都对应一个具体的解决思路，拿过去就能用：

5.2 关于源码、文档和项目演示的三点建议

最后再分享三个在实际交付项目中积累的经验。

第一个建议：项目交付时一定要把部署文档写清楚。我见过太多同学代码写完了，结果换一台电脑就不会跑了。我的习惯是写一份标准的README，把jdk版本、数据库版本、初始化SQL步骤、配置文件改动点、启动命令、默认账号密码全部写清楚。做答辩演示之前，按照文档从零部署一遍，确保不会当场翻车。

第二个建议：不要把所有的坑都踩一遍才写代码。比如Spring Security的过滤器顺序、MyBatis-Plus分页插件的配置、CORS和Security的冲突，这些点网上资料很零散。最靠谱的做法是先画一个接口清单，把每个接口的路径、请求参数、返回结构定下来再写代码。接口定清楚了，前后端并行开发效率反而更高。

第三个建议：项目源码命名要规范，注释不能少。答辩老师不会一行行读代码，但他会随机打开几个类看一眼。如果ServiceImpl里面全是a、b、c这种变量名，即使功能没问题也会打低分。我在关键业务方法上都加了简单的中文注释，把“这段代码是在做什么”写清楚，看起来会专业很多。

根据我实际做下来的经验，这种偏内容管理方向的学习平台类项目，最大的工作量不在CRUD本身，而在权限控制、进度记录、判分逻辑这些细节上。只要能把这几个核心点讲清楚，答辩和面试都基本没有大问题。