企业官网建设流程全解析

做高校科研管理系统这套项目，我前前后后折腾过好几个版本。最初是给一个学院做内部课题申报管理，后来逐步加上了论文登记、经费统计、成果导出这些模块，最后整理成了一个基于Spring Boot + Vue的完整前后端分离项目。这个系统的关键词看着很常规，但真正动手部署、跑通、把代码讲清楚，里边的坑其实比想象中多得多。这篇文章我打算从系统设计思路、源码结构、本地部署、生产环境发布，到核心模块的代码解析、常见问题排查，完整过一遍。适合刚开始接触Spring Boot和Vue整合项目的同学，也适合手上正好接了类似高校管理系统的开发者参考。

1. 为什么高校科研管理系统值得自己动手做一套

1.1 这个项目解决的是什么问题

高校里的科研管理，表面上是“申报-审批-统计”三个动作，实际上牵扯的角色特别多：教师要填申报书、传附件、查进度；科研秘书要初审、汇总、催材料；院领导要审批、签字；管理员还要维护学科类别、项目类型、经费科目。以前很多学校用Excel加微信群的方式管理，文件版本混乱不说，统计报表全靠人工拉数据，一到年底结题验收就手忙脚乱。

这套系统核心要解决的，就是把线下那套“填表-交表-审表”的流程搬到线上。老师登录后能看到自己的历史项目、论文、专利，申报的时候不用反复填基础信息；管理员后台可以维护所有字典数据，导出报表一键生成。如果只是要一个能用的管理后台，Spring Boot加Vue这套组合是最稳妥的选择，生态成熟、参考资料多、招人也好招。

1.2 为什么选 Spring Boot + Vue 这套组合

先说我自己的选型逻辑，不吹不黑，主要是三个原因。

第一，Spring Boot在后端领域几乎是事实标准。自动配置省去了一大堆XML配置，内嵌Tomcat让部署变得极其简单，一个java -jar就能跑起来。科研管理系统这种业务以CRUD为主、事务和权限要求明确的场景，Spring Boot的生态完全覆盖。

第二，Vue在前端的上手门槛相对低。系统里大量页面是表格、表单、弹窗这类中后台界面，Vue配合Element UI或Element Plus，开发效率非常直观。一个科研管理系统的页面复杂度不会高到需要React那种细粒度状态管理，Vue的响应式机制够用了。

第三，前后端分离对团队协作友好。后端只出接口，前端只管页面，两边可以并行开发。高校里经常有老师带学生做项目，学生负责前端、老师负责后端，这种分离结构分割任务非常方便。

当然，这套组合也有需要提前适应的点，后面部署部分会专门讲跨域、路由模式、打包这些问题。

2. 系统整体设计与模块拆解

2.1 前后端分离的架构逻辑

这个项目采用的是最典型的前后端分离架构：浏览器访问Vue构建的静态页面，页面里的JS通过HTTP请求调用后端RESTful API，后端Spring Boot负责业务逻辑和数据持久化，MySQL作为最终存储。

前端 Vue项目 后端 Spring Boot项目 nginx / dev server ---> controller层接收请求 | | views/paper.vue service层处理业务 api/paper.js <---axios---> mapper层操作数据库

前端和后端通过JSON格式交互，接口路径一般以/api开头。前后端分离带来的直接好处是：前端可以独立部署在Nginx上，后端可以独立部署在服务器上，甚至不在同一台机器上，只要接口能通就行。

这种架构也有代价。最典型的就是跨域问题，开发环境前端跑在8080端口，后端跑在8081端口，浏览器默认会拦截非同源的请求，解决方式有CORS配置、反向代理、或者直接把前端打包产物放到后端静态资源目录里。这块实操细节我在第4和第6部分详细说。

2.2 核心功能模块与数据流转

高校科研管理系统不是单表增删改查那么简单，它有清晰的业务流程。我这套项目里主要的模块如下：

数据流转的典型场景是项目申报：老师在前端表单里填写项目信息，提交后数据落到project表，状态为“待审核”；科研秘书登录后看到待审核列表，可以退回或提交到下一级；院领导审批通过后状态变为“已立项”。这条链路涉及多张表和多种状态，如果不在表设计里预留好status字段和审批记录表，后面扩展会非常痛苦。

2.3 源码目录应该怎么读

拿到一份源码，很多人第一反应就是到处乱点。我建议按照固定的顺序读，效率会高很多。

后端先看pom.xml，搞清楚项目用了哪些依赖，是Spring Boot 2.x还是3.x，Java版本要求是什么，这决定了你本地方不跑得起来。接着看application.yml，里面是数据源、端口、文件上传路径等核心配置。然后看启动类，确认Mapper扫描和组件扫描的配置方式。再往后才是Controller层，顺着接口路径去看对应的Service和Mapper。

前端先看package.json，确认Vue版本、Element版本、axios版本。然后看vue.config.js，里面通常配置了开发环境代理和打包输出路径。接着看router目录，了解页面路由结构。再打开一个典型页面，比如项目申报页面，顺着它调用的API找到api目录下对应的请求封装，这样一条链路就打通了。

我的项目目录大致是这样组织的：

src/main/java/com/example/research ├── config # 跨域配置、MyBatis配置、Swagger配置 ├── controller # 接收前端请求 ├── service # 业务逻辑层 ├── mapper # MyBatis接口 ├── entity # 数据库实体类 ├── common # 统一返回结果、异常处理、工具类 ├── security # JWT登录鉴权相关 └── ResearchApplication.java frontend/ ├── src │ ├── api # 调用后端接口的封装 │ ├── views # 页面组件 │ ├── router # 路由配置 │ ├── store # 全局状态 │ └── components # 通用组件 ├── package.json └── vue.config.js

这样一套结构读下来，项目的基本情况就掌握大半了。

3. 环境准备与本地部署实操

3.1 JDK、Maven、Node.js 这些基础环境怎么配

本地跑这套系统，最怕的就是环境不一致。我见过太多“我本地能跑，你那边怎么不行”的案例，八成都是JDK版本或者依赖仓库版本搞错了。

先说后端环境。我这个项目用的是Spring Boot 2.7.x，所以在本地用JDK 1.8或者JDK 11都可以，推荐JDK 8，兼容性最好。如果你拿到的源码是Spring Boot 3.x，那必须用JDK 17及以上，因为Spring Boot 3基于Jakarta EE，包名都从javax改成了jakarta，这个差异在部署时很容易踩坑。

Maven建议用3.6以上版本。安装之后配置好阿里云镜像，方便依赖下载：

<mirror> <id>aliyunmaven</id> <mirrorOf>*</mirrorOf> <name>阿里云公共仓库</name> <url>https://maven.aliyun.com/repository/public</url> </mirror>

然后是前端环境。Vue 2项目用Node.js 14或16比较稳，Vue 3项目推荐Node.js 16.20以上。前端依赖下载慢的问题也有解决方案，后面会说。

检查环境是否装好，终端里依次执行：

java -version mvn -v node -v npm -v mysql --version

四个命令都能正常输出版本号，说明基础环境没问题。

3.2 数据库初始化与配置

数据库是这套系统最容易出问题的地方。项目一般会带一个sql目录，里面有初始化脚本，里面有建库、建表、插入初始数据的语句。拿到手先在MySQL里执行一遍：

mysql -u root -p < research_system.sql

执行完建议用Navicat或命令行看一下表是否建全，特别是user表、role表、project表这些核心表是不是有初始数据。很多系统初始管理员账号就靠这个脚本写入，比如admin/admin123。

连接配置在application.yml这个位置：

spring: datasource: url: jdbc:mysql://localhost:3306/research_system?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai username: root password: 你自己的密码 driver-class-name: com.mysql.cj.jdbc.Driver

这里有三个细节一定要说。

第一，driver-class-name用com.mysql.cj.jdbc.Driver，这是MySQL 8的驱动类。如果你用MySQL 5.7，也最好在pom里引入mysql-connector-j的8.x版本，这样新旧数据库都能连。

第二，url里必须带上serverTimezone=Asia/Shanghai，不然会报时区错误。以后端时间为准，别用UTC。

第三，如果你连的是MySQL 8，但本地装的是MySQL 5.7的客户端工具或者旧驱动，有可能会提示Public Key Retrieval is not allowed，解决办法是往url后面加allowPublicKeyRetrieval=true。

3.3 后端服务启动步骤

配置好数据库之后，后端启动是比较机械的。

在项目根目录执行：

mvn clean install -DskipTests

没有报错的话，target目录下会生成一个jar包。如果你是在IDE里启动，直接在IDEA里找到启动类，右键Run就行。

有几点需要注意：

第一，如果你是第一次拉代码，依赖下载时间会比较长。如果几十个依赖一直报下载失败，先检查Maven配置文件中是否配置了阿里云镜像。

第二，端口冲突很常见。我项目里配置的是8081端口，如果你本地的8081被其他服务占了，项目会启动失败，报Web server failed to start。要么改yml里的server.port，要么把占用端口的进程杀掉。

第三，Spring Boot启动日志最后一行如果出现Started ResearchApplication，才说明真正启动成功，仅仅看到Spring Boot的banner不能算数。有些人看到banner图就以为启动完了，结果接口调不通。

启动成功后，浏览器访问http://localhost:8081/api/ping这种接口，能返回JSON，后端就通了。

3.4 前端项目启动与联调

前端部分先安装依赖，进入frontend目录执行：

npm install

这里我也要提醒一下。国内网络环境下，npm install很容易卡在某些包的下载上，建议把源切换到淘宝镜像，然后进行安装：

npm config set registry https://registry.npmmirror.com

安装成功后启动开发服务器：

npm run serve

默认端口一般是8080。这时打开http://localhost:8080，页面应该能加载出来，但大概率还登录不了，因为前端请求后端的接口是跨域的。

解决开发环境跨域，最常用的方式是在vue.config.js里配置代理：

module.exports = { devServer: { port: 8080, proxy: { '/api': { target: 'http://localhost:8081', changeOrigin: true } } } }

这样配置之后，前端页面发起的/api/xxx请求会被devServer转发到后端的8081端口，浏览器就不存在跨域问题了。

前后端联调成功过的标志是：登录页面能正常请求，验证码能加载，输入初始账号密码能跳转到首页。走到这一步，本地环境基本上就通了。

4. 生产环境部署与配置

4.1 服务器环境准备

开发环境和生产环境一个很大的差别是：开发环境允许你怎么方便怎么来，生产环境得考虑稳定性、开机自启、日志轮转、安全加固。

我部署这套系统的服务器配置建议至少2核4G内存，操作系统用CentOS 7或者Ubuntu 20.04都行。需要在服务器上安装的东西包括：JDK、MySQL、Nginx。

如果你的服务器内存比较小，建议给JVM限制一下堆内存：

java -jar research-system.jar --server.port=8081 -Xms512m -Xmx1024m

服务器上安装MySQL后，记得把数据库文件导入，然后排查一下MySQL的bind-address是不是0.0.0.0，否则后端进程连不上。生产环境数据库和后端如果在同一台机器，直接用127.0.0.1连接就行，不需要开公网端口。

4.2 后端打包与进程管理

后端打包方式跟本地一样，在项目根目录执行：

mvn clean package -DskipTests

生成jar包后，上传到服务器，放在一个专门的目录比如/opt/research。然后启动：

nohup java -jar research-system.jar --spring.profiles.active=prod > /opt/research/log.log 2>&1 &

这种启动方式虽然在跑，但不够正规。我建议用systemd来管理，这样开机自启、崩溃自动重启都有保障。写一个服务文件：

[Unit] Description=Research System Backend After=network.target [Service] User=root WorkingDirectory=/opt/research ExecStart=/usr/bin/java -jar /opt/research/research-system.jar --spring.profiles.active=prod Restart=always RestartSec=5 [Install] WantedBy=multi-user.target

然后执行：

systemctl daemon-reload systemctl enable research systemctl start research systemctl status research

用systemd管理之后，重启服务只需要systemctl restart research，日志查看用journalctl -u research，比nohup方便得多。

生产环境的application-prod.yml里，数据库密码、Redis密码千万别写在公开的文档里。建议用环境变量覆盖配置，Spring Boot原生支持这种用法：

spring: datasource: password: ${DB_PASSWORD}

启动前在服务器上设置环境变量：

export DB_PASSWORD='你的数据库密码'

4.3 前端打包与 Nginx 配置

前端生产构建执行：

npm run build

构建完成后，dist目录就是所有静态文件。把这个目录上传到服务器的/data/www/research，然后在Nginx配置里做静态资源映射和反向代理。

一个可以用的Nginx配置示例：

server { listen 80; server_name research.example.com; root /data/www/research; index index.html; location / { try_files $uri $uri/ /index.html; } location /api/ { proxy_pass http://127.0.0.1:8081; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; } }

这里的核心是location /块里的try_files $uri $uri/ /index.html，这一行是为了解决Vue Router的history模式。如果不加，用户访问站点/abc这类前端路由时Nginx找不到对应文件，会返回404。加上之后，所有匹配不到静态文件的请求都会回退到index.html，由前端路由接管。

反向代理部分，把/api/开头的请求转发给后端的8081端口，这样前端页面里的API请求都走同域，不存在跨域问题。前后端就通过这种方式在生产环境串联起来了。

4.4 HTTPS 与常见部署架构

高校系统一般都会有等保或者统一身份认证要求，HTTP明文传输在很多场景下过不了审。现在配HTTPS证书已经非常方便，免费证书三个月一更新，系统自动化部署即可。

如果你的前端域名和后端不在一个域名，接口就要支持跨域。我建议务必用Nginx把后端API反代到同域名下，避免在后端代码里写一堆跨域配置。一个域名加一条location配置，比在后端搞CORS滤波器和预检请求要省心得多。

还有一点，不要把静态文件直接放到Spring Boot的src/main/resources/static目录里然后打成jar包一起发布。这样做虽然能让前端后端变成一个服务，但每次前端代码有改动都要重新打jar包，而且Nginx的缓存、压缩、静态文件性能优势全没了。生产环境老老实实前后端分离部署，dist目录交给Nginx，jar包跑在后台，这才是正道。

5. 代码讲解：核心模块的实现思路

5.1 登录鉴权与 JWT

科研管理系统的登录不能只是简单查一下用户名密码对不对，必须考虑会话保持、接口鉴权、密码安全。

我这套实现用的方案是Spring Security + JWT。用户在登录接口提交用户名密码时，后端校验通过后生成一个包含用户ID和角色的token字符串，返回给前端。前端把它存在本地存储里，后续每个请求都在请求头带上Authorization: Bearer token。后端通过过滤器拦截请求，从token里解析出用户信息。

这里不展开所有代码，重点说实现思路：

public class JwtUtil { public String generateToken(String username) { return Jwts.builder() .setSubject(username) .setExpiration(new Date(System.currentTimeMillis() + 7 * 24 * 3600 * 1000L)) .signWith(SignatureAlgorithm.HS256, secretKey) .compact(); } }

核心点有三个。

第一，token的有效期一般是7天，不要设置太长，否则用户改了密码，旧token还能继续用，这是安全隐患。

第二，密码存储必须用BCrypt加密，不能明文存到数据库里。Spring Security自带BCryptPasswordEncoder，注册用户时加密，登录校验时调用matches方法。

第三，前端必须在axios的请求拦截器里统一加上token，在响应拦截器里统一处理401状态并跳转登录页。否则你会在每个页面都写一遍“token过期”的判断，非常痛苦。

5.2 科研项目申报流程

科研项目的状态流转是整个系统里最难做好的模块。状态字段通常包括：草稿、待初审、待终审、已立项、已结题、已驳回。

实体类里加上status字段还不够，建议再加一张project_audit_log表，记录每一次审批操作：谁在什么时间做了什么操作，批注是什么。这样后期追溯问题有依据，领导问起来也能解释清楚。

Service层的核心逻辑是状态校验。比如“待初审”的项目不能被直接改成“已立项”，必须走“待终审”这一步。这个规则不要在Controller里写，要放在Service里统一判断：

public void auditProject(Long projectId, String action, String comment) { Project p = projectDao.selectById(projectId); if ("pass".equals(action) && "PENDING_FIRST".equals(p.getStatus())) { p.setStatus("PENDING_FINAL"); } else if ("pass".equals(action) && "PENDING_FINAL".equals(p.getStatus())) { p.setStatus("APPROVED"); } else if ("reject".equals(action)) { p.setStatus("REJECTED"); } else { throw new BusinessException("当前状态不允许该操作"); } projectDao.updateById(p); auditLogDao.insert(new AuditLog(projectId, action, comment)); }

前端页面也要跟着状态变化来控制按钮显示：待初审状态下只显示“提交审批”，已立项状态下显示“申请结题”。状态机这种东西，后端做了限制，前端再做一层限制，才算稳妥。

5.3 论文成果管理

论文模块看着简单，实际上要处理附件上传、作者排序、收录类型这些细节。

我的实现里，论文实体包含标题、期刊名称、发表年份、论文类型、收录情况、作者列表、附件URL等信息。作者列表用JSON存，字段里直接存一个数组的字符串，查询时再解析回数组，这种方案在论文这种固定结构下是够用的。

附件上传这块，后端需要处理文件存储路径。我建议不要把文件存到数据库里，而是存在服务器本地磁盘，数据库只记录文件路径。当然，也可以继承FastDFS或OSS实现更好的存储。对于高校项目，服务器本地路径加一个固定目录就够了。

public String uploadFile(MultipartFile file) { String originalFilename = file.getOriginalFilename(); String suffix = originalFilename.substring(originalFilename.lastIndexOf(".")); String fileName = UUID.randomUUID() + suffix; File dest = new File(uploadDir + "/" + fileName); file.transferTo(dest); return "/files/" + fileName; }

Nginx配置里再给/files/路径加一个静态映射，指向服务器上的上传目录：

location /files/ { alias /data/research/files/; }

这样上传和下载都走Nginx，后端不用处理文件流，性能更好。

5.4 数据统计与导出

管理系统的最终价值在于统计。学校领导最常问的问题就是“今年我们学院发表了多少篇SCI”“各学院的经费执行率是多少”。这类统计需求用SQL分组聚合就能解决，但我建议统计功能单独建一些统计表，或者至少使用视图，不要在原始业务表上做很重的查询。

导出功能我用的方案是EasyExcel。它的优势是占用内存低，支持大数据量导出，不会导致OutOfMemory。核心代码大致是：

String fileName = "科研成果统计.xlsx"; EasyExcel.write(response.getOutputStream(), PaperExportDTO.class) .sheet("论文统计") .doWrite(paperList);

前端导出用axios的blob接收，然后用JS触发下载：

response.blob().then(blob => { const link = document.createElement('a') link.href = URL.createObjectURL(blob) link.download = '科研成果统计.xlsx' link.click() })

统计图表的展示用ECharts。后端返回统计结果数组，前端拿来直接渲染柱状图、折线图、饼图，效果直观。

6. 实战中遇到的典型问题与排查方法

6.1 前后端联调时的跨域问题

这个问题几乎人人都会遇到。表现是前端页面能打开，但登录时请求报错，浏览器控制台出现CORS字样。

先说原理。浏览器同源策略规定，页面所在的域名、端口和请求目标不一致时，浏览器会阻止JS读取响应。开发环境常见的是前端8080端口，后端8081端口，这就是跨域。

我建议用vue.config.js的代理解决，而不是后端开CORS。代理方式对浏览器完全透明，前端代码不用做任何改动。而后端开CORS虽然配置简单，但生产环境如果前后端分开部署，还是要依赖Nginx反代，不如一开始就用代理。

排查跨域问题时先分清楚是开发环境还是生产环境。开发环境看vue.config.js的proxy配置是否生效，注意修改完必须重启npm run serve。生产环境看Nginx的location /api/配置是否正确。

6.2 数据库连接失败与时区问题

部署时最常见的报错是：

Access denied for user 'root'@'localhost' Communications link failure The server time zone value 'CST' is unrecognized

第一个错误是账号密码错，检查yml里的MySQL用户名密码和服务器实际是否一致。

第二个错误是网络不通或端口不对。如果在服务器本机连接，host用127.0.0.1而不是localhost，因为MySQL驱动解析localhost在某些版本下会走IPv6导致连接异常。

第三个错误是时区问题，解决办法就是前面说的在JDBC url后加serverTimezone=Asia/Shanghai。

还有一类情况在MySQL 8里偶尔遇到，报Public Key Retrieval is not allowed。这是MySQL 8默认的caching_sha2_password插件引起的，加allowPublicKeyRetrieval=true参数即可。这个方法实测有效。

6.3 前端打包后路由刷新404

本地开发时一切正常，部署到Nginx后，刷新页面就404。问题就出在Vue Router使用的是history模式。

开发环境下，devServer会帮你处理路由回退，所以一切正常。生产环境Nginx不会自动认识前端的路由，你必须显式配置try_files让所有路径都回退到index.html：

location / { try_files $uri $uri/ /index.html; }

如果你用的是hash模式，就是网址里带/#/那种，不会有这个问题，但我不推荐生产环境用hash模式，URL不好看，也不利于分享。配置history模式加try_files回退，是标准做法。

6.4 内存溢出与性能优化

小规模高校系统一般不会遇到高并发问题，但跑久了JVM内存还是可能涨上去。我们遇到过的情况是：系统连续运行半个月后，接口响应越来越慢，最后直接卡死。

排查先用jstat看一下GC情况：

jstat -gcutil <pid> 1000 10

如果Full GC频繁且老年代回收不掉，大概率是内存泄漏。常见原因有三个：

第一，数据库连接池没有释放连接。如果使用MyBatis-Plus，数据源默认的HikariCP一般还能自动管理，但要确保Service里没有手动创建Connection不关闭的情况。

第二，导出Excel时一次性加载过多数据。解决方式是用EasyExcel的流式写入，分批读取数据库，不要list转一次内存。

第三，文件上传后临时文件没有清理。临时文件堆积在/tmp目录，也会拖垮系统，建议定期清理。

调优的话，JVM堆和元空间给适量就行，不要盲目加大。本身就4G内存的服务器，JVM堆设1G，剩下的留给操作系统和Nginx，性能反而更均衡。

7. 源码文档与二次开发建议

7.1 文档应该包含哪些内容

拿到源码之后，很多人只看代码，忽略文档。我觉得一套好用的源码，文档比代码更重要。部署文档至少要包含：环境要求、数据库初始化步骤、后端启动步骤、前端启动步骤、生产部署步骤、初始账号、常见问题。

代码讲解文档要能回答三个问题：项目结构是怎样的、接口有哪些、业务流转是怎么实现的。接口文档用Swagger生成即可，Swagger接入Spring Boot非常方便，自动把Controller里的接口列表呈现出来，支持在线调试。

7.2 二次开发时最容易改错的地方

如果你准备在这个基础上加功能，有几个地方一定要小心。

第一，不要直接改表结构而不改实体类。很多初学者在数据库工具里加了一个字段，代码里没同步，Mapper查询时要么报错要么查不到。

第二，加接口时要遵守现有的返回格式。项目统一用Result对象包返回，格式是：

{ "code": 200, "message": "操作成功", "data": {} }

你如果自己返回一个裸对象，前端axios拦截器统一处理时就会出错。

第三，权限控制别只在前端做隐藏按钮。后端接口一定要加权限注解，不然别人直接构造请求就能绕过页面操作。

@PreAuthorize("hasRole('ADMIN')") @GetMapping("/admin/stats") public Result getStats() { // 只有管理员能访问 }

第四，新增字段需要在前端表单验证、列表展示、导出Excel三处同步修改，漏一处都显得不完整。

7.3 如何用这套项目写论文或做课设

这类高校科研管理系统，毕业生拿去当课题设计或毕业论文的素材是很常见的。如果你的目标是写论文，建议不要只停留在“系统能做增删改查”这一步，而是要围绕某个点做深入。

比如你可以把核心研究点放在“科研项目全生命周期管理”，把状态流转、审核流程、权限控制作为创新点；也可以放在“基于Spring Boot的高校科研信息统计分析系统”，重点讲数据可视化和报表生成。

论文结构和项目结构可以对应起来：绪论里写现状与问题，背景技术里写Spring Boot、Vue、MySQL，系统设计里写架构和数据库表设计，系统实现里贴核心代码和截图，最后做测试。这样整套逻辑是自洽的。

8. 个人实操体会与最后提醒

系统部署踩坑一段时间之后，我个人的体会是：这类管理系统的难点从来不是某个技术点特别难，而是“全链路跑通”这件事本身。从数据库脚本到后端启动，从前端代理到Nginx配置，从JWT鉴权到文件上传，每一个环节单独看都不复杂，但串起来之后，任何一个节点的疏漏都会导致整个系统不能用。所以我强烈建议拿到源码之后先别急着改代码，老老实实按部署文档走一遍，确认本地跑通、页面能登录、增删改查正常，再谈二次开发。

还有一点，代码讲解这个事值得认真对待。源码给到手并不代表对方能吸收，把Controller到Service到Mapper的调用关系标注清楚，把核心业务的流转画出来，才是真正有用的交付。

最后再分享一个实用小技巧：在application.yml里把Spring Boot的启动日志级别从INFO调整成WARN，启动速度快很多，日志也干净。需排查问题时再临时调回DEBUG，不要一直开着。这样系统跑起来，你才能把精力放在业务和功能上，而不是被一堆没用的日志刷屏。