尧图网站建设 
简介这是一套面向计算机专业本科生的高分毕业设计级学生综合素质评价系统采用前后端分离架构基于Vue实现管理界面、SpringBoot构建后端服务完整覆盖学生自评、教师评价、教务审核及加权评分等核心业务流程同时集成用户管理、角色权限、文件上传、操作日志等通用模块适用于毕设开发、课程设计或Java全栈实战训练。资源包共343个文件含173个Java后端逻辑类、72个Vue组件与页面、41个JS交互脚本、18个PNG界面图标以及SQL建表语句、YML配置、LESS样式和BTL模板文件等结构规范、模块解耦清晰1.34MB压缩包开箱即用。已有532人学习下载提供完整可运行源码、MySQL数据库脚本及详细需求文档无需额外配置即可本地启动特别适合缺乏项目经验但需快速交付毕设成果的学习者。1. 为什么一个学生综合素质评价系统要同时用 Vue 和 SpringBoot你可能刚接手教务处提的需求要一个能录入德智体美劳五维数据、支持教师打分、学生自评、家长查看、自动计算雷达图和成长档案的 Web 系统。不是简单增删改查——它得实时响应评分变化、动态渲染多维度权重、导出 PDF 报告、对接教务系统已有学号库还要在校园内网低带宽环境下稳定运行。这时候单页应用SPA前端 RESTful 后端的组合就不是“选型偏好”而是工程约束下的必然解Vue 负责把复杂的评分表单、拖拽式指标配置、实时权重联动、图表渲染封装成可复用组件SpringBoot 则承担身份校验对接 LDAP/统一认证、事务控制多张表批量更新不能丢分、Excel 导入解析处理教师上传的千行 Excel、以及最关键的——把“德育加分项”“体育达标阈值”“美育活动类型”这些业务规则固化进 Service 层避免前端 JS 里写满 if-else。标题里强调“源代码数据库需求文档”恰恰说明这不是玩具项目它需要可交付、可审计、可交接。新手能照着跑通老手能快速定位“为什么艺术类活动权重没生效”——这背后是 MyBatis 的 resultMap 映射逻辑、Vue 的 computed 依赖追踪、以及需求文档里第 3.2.4 条对“跨学期累计加分”的明确定义。2. 搭建最小可运行骨架从初始化到首页渲染2.1 初始化 SpringBoot 后端服务2.7.x 版本兼容性最稳学生评价系统对实时性要求不高但对事务一致性和 SQL 可读性要求高。SpringBoot 2.7.x 是当前高校 Java 课程教学主流版本与 JDK 8/11 兼容性好且spring-boot-starter-data-jpa对 MySQL 5.7 支持成熟。避免使用 3.x 的 Jakarta EE 9 命名空间否则会和现有教务系统 jar 包冲突。# 使用 Spring Initializr CLI或访问 start.spring.io 手动勾选 # 必选依赖Spring Web, Spring Data JPA, MySQL Driver, Lombok, Validation curl https://start.spring.io/starter.zip \ -d dependenciesweb,jpa,mysql,lombok,validation \ -d javaVersion11 \ -d bootVersion2.7.18 \ -d packageNamecom.example.edu \ -d namestudent-assessment \ -o student-assessment-backend.zip提示不要用 SpringBoot 3.x 初始化。其默认启用 Jakarta EE 9如jakarta.persistence.*而多数高校实验室 MySQL 驱动mysql-connector-java 8.0.28仍基于javax.*包直接导致ClassNotFoundException。2.7.18 是最后一个支持javax.*的 LTS 版本。解压后在application.yml中配置数据库连接注意时区和字符集spring: datasource: url: jdbc:mysql://localhost:3306/student_assessment?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghaiallowPublicKeyRetrievaltrueuseSSLfalse username: root password: your_password driver-class-name: com.mysql.cj.jdbc.Driver jpa: hibernate: ddl-auto: none # 绝不设为 update 或 create生产环境必须由 DBA 执行 SQL 脚本 show-sql: true properties: hibernate: format_sql: true dialect: org.hibernate.dialect.MySQL8Dialect2.1.1 创建核心实体Student、Indicator、AssessmentRecord学生评价的核心不是“人”而是“评价行为”。因此实体设计以AssessmentRecord为中心关联Student和Indicator指标而非传统的一对多学生表Entity Table(name t_assessment_record) Data public class AssessmentRecord { Id GeneratedValue(strategy GenerationType.IDENTITY) private Long id; ManyToOne(fetch FetchType.LAZY) JoinColumn(name student_id, nullable false) private Student student; ManyToOne(fetch FetchType.LAZY) JoinColumn(name indicator_id, nullable false) private Indicator indicator; Column(name score, nullable false, precision 3, scale 1) // 保留1位小数如 8.5 private BigDecimal score; Column(name semester, length 20, nullable false) // 如 2023-2024-1 private String semester; Column(name evaluator_type, length 10, nullable false) // teacher, self, parent private String evaluatorType; Column(name created_at, nullable false, updatable false) CreationTimestamp private LocalDateTime createdAt; }参数说明precision3, scale1确保分数存储为DECIMAL(3,1)覆盖 0.0~99.9 分区间避免浮点误差CreationTimestamp自动填充时间省去 Controller 层手动 setFetchType.LAZY防止查询记录时级联加载全部学生信息提升列表页性能。2.2 初始化 Vue 前端项目v3.4.x Composition API 标准实践使用 Vite 创建 Vue 项目比 Vue CLI 更轻量启动快且天然支持 TypeScript——这对定义评分规则这类强类型场景至关重要npm create vitelatest student-assessment-frontend -- --template vue-ts cd student-assessment-frontend npm install # 安装关键依赖 npm install axios1.6.7 element-plus2.7.8 echarts5.4.3 pinia2.2.3注意axios1.6.7是当前与 Vue 3.4 兼容性最好的版本element-plus2.7.8提供稳定的 Table、Form、Dialog 组件echarts5.4.3渲染雷达图时对移动端适配更优pinia2.2.3替代 Vuex状态管理更简洁。2.2.1 配置 Axios 请求拦截器统一处理认证与错误学生系统需区分角色管理员、教师、学生、家长所有请求必须携带Authorization头。在src/utils/request.ts中import axios from axios const request axios.create({ baseURL: /api, // 代理到后端见 vite.config.ts timeout: 10000, }) // 请求拦截从 localStorage 读 token request.interceptors.request.use( (config) { const token localStorage.getItem(auth_token) if (token) { config.headers.Authorization Bearer ${token} } return config }, (error) Promise.reject(error) ) // 响应拦截统一处理 401/403 request.interceptors.response.use( (response) response.data, // 直接返回 data省去 .data 嵌套 (error) { if (error.response?.status 401) { localStorage.removeItem(auth_token) window.location.href /login // 强制跳登录页 } return Promise.reject(error) } ) export default request2.2.2 创建首页路由与基础布局在src/router/index.ts中定义路由重点体现角色权限隔离import { createRouter, createWebHistory } from vue-router import HomeView from ../views/HomeView.vue import LoginView from ../views/LoginView.vue import ScoreInputView from ../views/ScoreInputView.vue import ReportView from ../views/ReportView.vue const router createRouter({ history: createWebHistory(), routes: [ { path: /, redirect: /home }, { path: /login, component: LoginView, meta: { public: true } }, // 公共路由 { path: /home, component: HomeView, meta: { requiresAuth: true, roles: [admin, teacher, student, parent] } }, { path: /score-input, component: ScoreInputView, meta: { requiresAuth: true, roles: [teacher, admin] } // 仅教师和管理员可录入 }, { path: /report/:studentId, component: ReportView, props: true, meta: { requiresAuth: true, roles: [admin, teacher, student, parent] } } ] }) // 全局守卫检查角色权限 router.beforeEach((to, from, next) { const token localStorage.getItem(auth_token) if (!token !to.meta.public) return next(/login) if (to.meta.requiresAuth) { const userRole localStorage.getItem(user_role) if (to.meta.roles !to.meta.roles.includes(userRole || )) { return next(/home) // 无权限跳首页 } } next() }) export default router逻辑说明meta.roles字段声明路由所需角色beforeEach守卫读取localStorage中的user_role进行比对。这种方式比后端鉴权更轻量适合内部系统真实项目中user_role应由登录接口返回并存入本地避免伪造。3. 实现核心业务五维指标录入与雷达图生成3.1 后端提供指标配置 API支持动态增删改查学生综合素质评价的指标如“课堂参与度”“志愿服务时长”“艺术展演等级”不是固定死的教务处可能每学期调整。因此Indicator实体需支持 CRUD并通过PreUpdate自动维护更新时间Entity Table(name t_indicator) Data public class Indicator { Id GeneratedValue(strategy GenerationType.IDENTITY) private Long id; Column(name code, length 50, unique true, nullable false) // 如 DE_001 private String code; Column(name name, length 100, nullable false) // 如 德育-课堂表现 private String name; Column(name category, length 20, nullable false) // moral, intellectual, physical, aesthetic, labor private String category; // 五维分类 Column(name weight, nullable false, precision 3, scale 2) // 0.00~1.00 private BigDecimal weight; Column(name max_score, nullable false) // 满分如 100 private Integer maxScore; Column(name is_enabled, nullable false) private Boolean enabled true; Column(name updated_at) UpdateTimestamp private LocalDateTime updatedAt; }3.1.1 编写 IndicatorController暴露 REST 接口RestController RequestMapping(/indicators) RequiredArgsConstructor public class IndicatorController { private final IndicatorService indicatorService; GetMapping public ResultListIndicator listAll() { return Result.success(indicatorService.findAllEnabled()); } PostMapping public ResultIndicator create(Valid RequestBody Indicator indicator) { return Result.success(indicatorService.save(indicator)); } PutMapping(/{id}) public ResultIndicator update(PathVariable Long id, Valid RequestBody Indicator indicator) { indicator.setId(id); return Result.success(indicatorService.save(indicator)); } DeleteMapping(/{id}) public ResultVoid delete(PathVariable Long id) { indicatorService.deleteById(id); return Result.success(); } }参数说明Valid触发NotNull,Min,Max等注解校验ResultT是自定义响应包装类统一包含code,message,data字段避免前端反复判断response.data.datafindAllEnabled()方法只返回enabledtrue的指标保证前端下拉框不显示已停用项。3.2 前端实现指标选择与评分录入表单在ScoreInputView.vue中使用el-form动态渲染指标template el-form :modelform label-width120px el-form-item label学生学号 el-input v-modelform.studentId / /el-form-item el-form-item v-forindicator in indicators :keyindicator.id :labelindicator.name el-input-number v-modelform.scores[indicator.id] :min0 :maxindicator.maxScore :step0.5 :precision1 placeholder请输入分数 / div classel-form-item__description 满分 {{ indicator.maxScore }}权重 {{ indicator.weight }} /div /el-form-item el-form-item el-button typeprimary clicksubmit提交评分/el-button /el-form-item /el-form /template script setup langts import { ref, onMounted } from vue import request from /utils/request interface Indicator { id: number code: string name: string category: string weight: number maxScore: number } const indicators refIndicator[]([]) const form ref({ studentId: , scores: {} as Recordnumber, number // key: indicator.id, value: score }) onMounted(async () { const res await request.get(/indicators) indicators.value res.data }) const submit async () { const records Object.entries(form.value.scores) .filter(([, score]) score ! undefined score 0) .map(([indicatorId, score]) ({ studentId: form.value.studentId, indicatorId: Number(indicatorId), score, semester: 2023-2024-2, evaluatorType: teacher })) await request.post(/assessment-records/batch, records) ElMessage.success(评分提交成功) } /script逻辑说明v-for动态生成表单项form.scores是一个对象键为指标 ID值为分数submit方法将非空分数构造成数组调用/assessment-records/batch批量插入避免 N 次 HTTP 请求。filter确保只提交有值的项map构造后端所需的 DTO 结构。3.3 生成雷达图ECharts 封装与数据映射雷达图是综合素质评价的视觉核心。后端需按五维聚合数据前端用 ECharts 渲染3.3.1 后端提供聚合接口/reports/summary/{studentId}GetMapping(/reports/summary/{studentId}) public ResultMapString, Object getSummary(PathVariable String studentId) { // 按 category 分组计算加权平均分 MapString, BigDecimal categoryScores assessmentRecordRepository .findCategoryWeightedAverage(studentId); // 获取各维度指标详情用于雷达图标签 ListIndicator indicators indicatorService.findByCategories( Arrays.asList(moral, intellectual, physical, aesthetic, labor) ); MapString, Object result new HashMap(); result.put(categories, Arrays.asList(德育, 智育, 体育, 美育, 劳育)); result.put(scores, categoryScores.values().stream() .map(BigDecimal::doubleValue).collect(Collectors.toList())); result.put(indicators, indicators.stream() .map(i - Map.of(name, i.getName(), weight, i.getWeight())) .collect(Collectors.toList())); return Result.success(result); }3.3.2 前端使用 ECharts 渲染雷达图template div refchartRef stylewidth: 600px; height: 400px;/div /template script setup langts import { ref, onMounted, onUnmounted } from vue import * as echarts from echarts import request from /utils/request const chartRef refHTMLDivElement | null(null) let chart: echarts.ECharts | null null onMounted(() { if (!chartRef.value) return chart echarts.init(chartRef.value) // 初始化配置 const option { tooltip: {}, radar: { indicator: [ { name: 德育, max: 100 }, { name: 智育, max: 100 }, { name: 体育, max: 100 }, { name: 美育, max: 100 }, { name: 劳育, max: 100 } ], center: [50%, 45%], radius: 60% }, series: [{ type: radar, data: [{ value: [60, 75, 80, 65, 70], // 示例数据 name: 学生综合得分 }] }] } chart.setOption(option) }) onUnmounted(() { if (chart) chart.dispose() }) /script关键点radar.indicator数组顺序必须与后端返回的categories顺序严格一致series.data[0].value是五维分数数组需按“德育、智育、体育、美育、劳育”顺序排列center和radius参数确保图表在容器中居中且大小合适避免移动端挤压。4. 数据库设计与初始化从 ER 图到可执行 SQL4.1 核心表 ER 关系与字段设计依据学生综合素质评价系统的数据库不是范式优先而是业务可读性优先。以下是四张核心表的字段设计逻辑表名字段类型说明设计依据t_studentid,student_id,name,grade,class_namePK, VARCHAR, VARCHAR, VARCHAR, VARCHARstudent_id为业务主键学号非自增 IDgrade和class_name用于筛选统计学号是教务系统唯一标识避免用自增 ID 关联防止跨系统数据迁移失败t_indicatorid,code,name,category,weight,max_score,enabledPK, VARCHAR, VARCHAR, ENUM, DECIMAL, INT, TINYINTcategory用 ENUM 而非外键因只有 5 个固定值减少 JOIN 开销五维分类极少变动ENUM 比关联表查询更快且便于 SQL 聚合如GROUP BY categoryt_assessment_recordid,student_id,indicator_id,score,semester,evaluator_type,created_atPK, VARCHAR, BIGINT, DECIMAL, VARCHAR, VARCHAR, DATETIMEsemester为字符串如 2023-2024-2非日期类型因学期非标准日历周期学期标识含学年学期无法用 DATE 类型表达字符串更直观且支持模糊查询如LIKE 2023%t_userid,username,password,role,real_name,departmentPK, VARCHAR, VARCHAR, ENUM, VARCHAR, VARCHARrole为 ENUM(admin,teacher,student,parent)非外键角色固定且少ENUM 比关联表节省空间且WHERE roleteacher查询更快4.1.1 创建数据库与表结构的完整 SQL 脚本-- 创建数据库UTF8MB4 支持 emoji如学生留言用 CREATE DATABASE IF NOT EXISTS student_assessment CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; USE student_assessment; -- 学生表 CREATE TABLE t_student ( id BIGINT PRIMARY KEY AUTO_INCREMENT, student_id VARCHAR(20) NOT NULL UNIQUE COMMENT 学号业务主键, name VARCHAR(50) NOT NULL COMMENT 姓名, grade VARCHAR(10) NOT NULL COMMENT 年级如 高一、大二, class_name VARCHAR(30) NOT NULL COMMENT 班级名称, created_at DATETIME DEFAULT CURRENT_TIMESTAMP, updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT学生基本信息; -- 指标表 CREATE TABLE t_indicator ( id BIGINT PRIMARY KEY AUTO_INCREMENT, code VARCHAR(50) NOT NULL UNIQUE COMMENT 指标编码如 DE_001, name VARCHAR(100) NOT NULL COMMENT 指标名称, category ENUM(moral,intellectual,physical,aesthetic,labor) NOT NULL COMMENT 五维分类, weight DECIMAL(3,2) NOT NULL DEFAULT 0.00 COMMENT 权重0.00~1.00, max_score INT NOT NULL DEFAULT 100 COMMENT 满分, enabled TINYINT(1) NOT NULL DEFAULT 1 COMMENT 是否启用1启用0停用, created_at DATETIME DEFAULT CURRENT_TIMESTAMP, updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT评价指标配置; -- 评分记录表 CREATE TABLE t_assessment_record ( id BIGINT PRIMARY KEY AUTO_INCREMENT, student_id VARCHAR(20) NOT NULL COMMENT 学号, indicator_id BIGINT NOT NULL COMMENT 指标ID, score DECIMAL(3,1) NOT NULL COMMENT 得分0.0~99.9, semester VARCHAR(20) NOT NULL COMMENT 学期标识如 2023-2024-2, evaluator_type ENUM(admin,teacher,student,parent) NOT NULL COMMENT 评价者类型, created_at DATETIME DEFAULT CURRENT_TIMESTAMP, INDEX idx_student_semester (student_id, semester), INDEX idx_indicator (indicator_id), FOREIGN KEY (student_id) REFERENCES t_student(student_id) ON DELETE CASCADE, FOREIGN KEY (indicator_id) REFERENCES t_indicator(id) ON DELETE RESTRICT ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT学生评分记录; -- 用户表用于登录 CREATE TABLE t_user ( id BIGINT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(50) NOT NULL UNIQUE COMMENT 登录账号, password VARCHAR(100) NOT NULL COMMENT BCRYPT 加密密码, role ENUM(admin,teacher,student,parent) NOT NULL COMMENT 角色, real_name VARCHAR(50) NOT NULL COMMENT 真实姓名, department VARCHAR(100) COMMENT 所属部门/班级, created_at DATETIME DEFAULT CURRENT_TIMESTAMP, updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT系统用户;参数说明FOREIGN KEY ... ON DELETE CASCADE保证删除学生时自动清理其评分记录ON DELETE RESTRICT防止误删指标导致历史记录丢失INDEX idx_student_semester加速按学生学期查询如生成学期报告ENGINEInnoDB支持事务和外键CHARSETutf8mb4避免微信昵称等特殊字符乱码。4.2 初始化测试数据插入 5 个典型指标与 10 名学生执行以下 SQL 插入基础数据确保首次启动即可演示-- 插入五维指标权重总和为 1.00 INSERT INTO t_indicator (code, name, category, weight, max_score) VALUES (DE_001, 课堂参与度, moral, 0.20, 100), (IN_001, 学业成绩排名, intellectual, 0.30, 100), (PH_001, 体质健康测试, physical, 0.20, 100), (AE_001, 艺术特长等级, aesthetic, 0.15, 100), (LA_001, 劳动实践时长, labor, 0.15, 100); -- 插入 10 名学生模拟高一某班 INSERT INTO t_student (student_id, name, grade, class_name) VALUES (2023001, 张三, 高一, 1班), (2023002, 李四, 高一, 1班), (2023003, 王五, 高一, 1班), (2023004, 赵六, 高一, 1班), (2023005, 钱七, 高一, 1班), (2023006, 孙八, 高一, 1班), (2023007, 周九, 高一, 1班), (2023008, 吴十, 高一, 1班), (2023009, 郑十一, 高一, 1班), (2023010, 王十二, 高一, 1班); -- 插入管理员用户密码为 123456实际需 BCrypt 加密 INSERT INTO t_user (username, password, role, real_name) VALUES (admin, $2a$10$uQXqJZzYVpKxRcLmNnOoPqRsTuVwXyZaBcDeFgHiJkLmNoPqRsTuVwXyZ, admin, 系统管理员);安全提示示例密码已用 BCrypt 加密$2a$10$...是标准前缀实际部署时需用 Spring Security 的PasswordEncoder生成t_user.password字段长度设为 100足够存储 BCrypt 哈希值通常 60 字符。5. 需求文档落地技巧把 Word 条款转成可验证的代码逻辑5.1 将“跨学期累计加分”需求转化为数据库查询与 Service 逻辑需求文档第 3.2.4 条原文“志愿服务类指标code LIKE VO%允许跨学期累计同一学生在所有学期的得分之和作为最终分用于评优。” 这不是一句空话而是要落实到三层5.1.1 数据库层添加累计视图View简化查询-- 创建累计得分视图供报表模块直接 SELECT CREATE VIEW v_student_volunteer_total AS SELECT student_id, SUM(score) AS total_score, COUNT(*) AS record_count FROM t_assessment_record r JOIN t_indicator i ON r.indicator_id i.id WHERE i.code LIKE VO% GROUP BY student_id;优势视图封装复杂 JOIN 和 WHERE报表 SQL 只需SELECT * FROM v_student_volunteer_total WHERE student_id ?DBA 可独立优化视图底层索引无需修改 Java 代码。5.1.2 Service 层编写专用方法明确事务边界Service RequiredArgsConstructor public class VolunteerScoreService { private final AssessmentRecordRepository recordRepo; private final IndicatorRepository indicatorRepo; Transactional(readOnly true) public BigDecimal getTotalVolunteerScore(String studentId) { // 先查出所有志愿服务类指标 ID ListLong volunteerIndicatorIds indicatorRepo.findIdsByCodeLike(VO%); // 再查这些指标下该学生的全部记录 return recordRepo.sumScoresByStudentAndIndicators(studentId, volunteerIndicatorIds); } }5.1.3 Controller 层暴露为独立接口避免污染通用接口GetMapping(/volunteer-total/{studentId}) public ResultBigDecimal getVolunteerTotal(PathVariable String studentId) { return Result.success(volunteerScoreService.getTotalVolunteerScore(studentId)); }验证方法用 Postman 调用GET /volunteer-total/2023001对比数据库SELECT SUM(score) FROM t_assessment_record r JOIN t_indicator i ON r.indicator_idi.id WHERE r.student_id2023001 AND i.code LIKE VO%结果是否一致。不一致则说明 Service 层逻辑有误而非前端展示问题。5.2 “家长只能查看自己孩子”需求的双重校验实现需求文档第 4.1.2 条“家长登录后仅能查看其绑定学生的评价报告不可越权访问。” 这需要前后端协同防御前端校验登录后后端返回studentIds: [2023001]前端路由/report/:studentId的beforeRouteEnter守卫检查to.params.studentId是否在studentIds数组中后端校验ReportController的每个方法都接收AuthenticationPrincipal User user并在 Service 层查询时强制WHERE student_id ? AND parent_id ?t_parent_student关联表需提前创建。// 在 ReportService 中 public ReportData getReport(String studentId, User currentUser) { // 1. 检查该学生是否属于当前家长 boolean isChild parentStudentRepository.existsByParentIdAndStudentId( currentUser.getId(), studentId ); if (!isChild) { throw new AccessDeniedException(无权查看该学生报告); } // 2. 查询报告数据此处省略具体 SQL return buildReport(studentId); }关键点后端校验是最后一道防线绝不能只靠前端隐藏按钮。即使黑客绕过前端路由直接调用/report/2023002后端也会抛出AccessDeniedException并返回 403。Spring Security 的PreAuthorize注解也可实现但显式 Service 层校验更易单元测试和调试。5.3 使用 Swagger 生成可交互的 API 文档替代静态 Word将springdoc-openapi-ui依赖加入pom.xml启动后访问http://localhost:8080/swagger-ui.html即可看到自动生成的 API 文档且支持在线调试dependency groupIdorg.springdoc/groupId artifactIdspringdoc-openapi-ui/artifactId version1.6.14/version /dependency落地价值测试人员不用再翻 Word 文档找接口地址直接在 Swagger 页面点击Try it out输入参数前端开发可一键生成 Mock 数据教务处老师能直观看到“哪些字段必填、哪些有枚举值”减少沟通成本。这才是真正“活”的需求文档。本文还有配套的精品资源点击获取 Vue+SpringBoot构建学生综合素质评价系统实战
简介这是一套面向计算机专业本科生的高分毕业设计级学生综合素质评价系统采用前后端分离架构基于Vue实现管理界面、SpringBoot构建后端服务完整覆盖学生自评、教师评价、教务审核及加权评分等核心业务流程同时集成用户管理、角色权限、文件上传、操作日志等通用模块适用于毕设开发、课程设计或Java全栈实战训练。资源包共343个文件含173个Java后端逻辑类、72个Vue组件与页面、41个JS交互脚本、18个PNG界面图标以及SQL建表语句、YML配置、LESS样式和BTL模板文件等结构规范、模块解耦清晰1.34MB压缩包开箱即用。已有532人学习下载提供完整可运行源码、MySQL数据库脚本及详细需求文档无需额外配置即可本地启动特别适合缺乏项目经验但需快速交付毕设成果的学习者。1. 为什么一个学生综合素质评价系统要同时用 Vue 和 SpringBoot你可能刚接手教务处提的需求要一个能录入德智体美劳五维数据、支持教师打分、学生自评、家长查看、自动计算雷达图和成长档案的 Web 系统。不是简单增删改查——它得实时响应评分变化、动态渲染多维度权重、导出 PDF 报告、对接教务系统已有学号库还要在校园内网低带宽环境下稳定运行。这时候单页应用SPA前端 RESTful 后端的组合就不是“选型偏好”而是工程约束下的必然解Vue 负责把复杂的评分表单、拖拽式指标配置、实时权重联动、图表渲染封装成可复用组件SpringBoot 则承担身份校验对接 LDAP/统一认证、事务控制多张表批量更新不能丢分、Excel 导入解析处理教师上传的千行 Excel、以及最关键的——把“德育加分项”“体育达标阈值”“美育活动类型”这些业务规则固化进 Service 层避免前端 JS 里写满 if-else。标题里强调“源代码数据库需求文档”恰恰说明这不是玩具项目它需要可交付、可审计、可交接。新手能照着跑通老手能快速定位“为什么艺术类活动权重没生效”——这背后是 MyBatis 的 resultMap 映射逻辑、Vue 的 computed 依赖追踪、以及需求文档里第 3.2.4 条对“跨学期累计加分”的明确定义。2. 搭建最小可运行骨架从初始化到首页渲染2.1 初始化 SpringBoot 后端服务2.7.x 版本兼容性最稳学生评价系统对实时性要求不高但对事务一致性和 SQL 可读性要求高。SpringBoot 2.7.x 是当前高校 Java 课程教学主流版本与 JDK 8/11 兼容性好且spring-boot-starter-data-jpa对 MySQL 5.7 支持成熟。避免使用 3.x 的 Jakarta EE 9 命名空间否则会和现有教务系统 jar 包冲突。# 使用 Spring Initializr CLI或访问 start.spring.io 手动勾选 # 必选依赖Spring Web, Spring Data JPA, MySQL Driver, Lombok, Validation curl https://start.spring.io/starter.zip \ -d dependenciesweb,jpa,mysql,lombok,validation \ -d javaVersion11 \ -d bootVersion2.7.18 \ -d packageNamecom.example.edu \ -d namestudent-assessment \ -o student-assessment-backend.zip提示不要用 SpringBoot 3.x 初始化。其默认启用 Jakarta EE 9如jakarta.persistence.*而多数高校实验室 MySQL 驱动mysql-connector-java 8.0.28仍基于javax.*包直接导致ClassNotFoundException。2.7.18 是最后一个支持javax.*的 LTS 版本。解压后在application.yml中配置数据库连接注意时区和字符集spring: datasource: url: jdbc:mysql://localhost:3306/student_assessment?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghaiallowPublicKeyRetrievaltrueuseSSLfalse username: root password: your_password driver-class-name: com.mysql.cj.jdbc.Driver jpa: hibernate: ddl-auto: none # 绝不设为 update 或 create生产环境必须由 DBA 执行 SQL 脚本 show-sql: true properties: hibernate: format_sql: true dialect: org.hibernate.dialect.MySQL8Dialect2.1.1 创建核心实体Student、Indicator、AssessmentRecord学生评价的核心不是“人”而是“评价行为”。因此实体设计以AssessmentRecord为中心关联Student和Indicator指标而非传统的一对多学生表Entity Table(name t_assessment_record) Data public class AssessmentRecord { Id GeneratedValue(strategy GenerationType.IDENTITY) private Long id; ManyToOne(fetch FetchType.LAZY) JoinColumn(name student_id, nullable false) private Student student; ManyToOne(fetch FetchType.LAZY) JoinColumn(name indicator_id, nullable false) private Indicator indicator; Column(name score, nullable false, precision 3, scale 1) // 保留1位小数如 8.5 private BigDecimal score; Column(name semester, length 20, nullable false) // 如 2023-2024-1 private String semester; Column(name evaluator_type, length 10, nullable false) // teacher, self, parent private String evaluatorType; Column(name created_at, nullable false, updatable false) CreationTimestamp private LocalDateTime createdAt; }参数说明precision3, scale1确保分数存储为DECIMAL(3,1)覆盖 0.0~99.9 分区间避免浮点误差CreationTimestamp自动填充时间省去 Controller 层手动 setFetchType.LAZY防止查询记录时级联加载全部学生信息提升列表页性能。2.2 初始化 Vue 前端项目v3.4.x Composition API 标准实践使用 Vite 创建 Vue 项目比 Vue CLI 更轻量启动快且天然支持 TypeScript——这对定义评分规则这类强类型场景至关重要npm create vitelatest student-assessment-frontend -- --template vue-ts cd student-assessment-frontend npm install # 安装关键依赖 npm install axios1.6.7 element-plus2.7.8 echarts5.4.3 pinia2.2.3注意axios1.6.7是当前与 Vue 3.4 兼容性最好的版本element-plus2.7.8提供稳定的 Table、Form、Dialog 组件echarts5.4.3渲染雷达图时对移动端适配更优pinia2.2.3替代 Vuex状态管理更简洁。2.2.1 配置 Axios 请求拦截器统一处理认证与错误学生系统需区分角色管理员、教师、学生、家长所有请求必须携带Authorization头。在src/utils/request.ts中import axios from axios const request axios.create({ baseURL: /api, // 代理到后端见 vite.config.ts timeout: 10000, }) // 请求拦截从 localStorage 读 token request.interceptors.request.use( (config) { const token localStorage.getItem(auth_token) if (token) { config.headers.Authorization Bearer ${token} } return config }, (error) Promise.reject(error) ) // 响应拦截统一处理 401/403 request.interceptors.response.use( (response) response.data, // 直接返回 data省去 .data 嵌套 (error) { if (error.response?.status 401) { localStorage.removeItem(auth_token) window.location.href /login // 强制跳登录页 } return Promise.reject(error) } ) export default request2.2.2 创建首页路由与基础布局在src/router/index.ts中定义路由重点体现角色权限隔离import { createRouter, createWebHistory } from vue-router import HomeView from ../views/HomeView.vue import LoginView from ../views/LoginView.vue import ScoreInputView from ../views/ScoreInputView.vue import ReportView from ../views/ReportView.vue const router createRouter({ history: createWebHistory(), routes: [ { path: /, redirect: /home }, { path: /login, component: LoginView, meta: { public: true } }, // 公共路由 { path: /home, component: HomeView, meta: { requiresAuth: true, roles: [admin, teacher, student, parent] } }, { path: /score-input, component: ScoreInputView, meta: { requiresAuth: true, roles: [teacher, admin] } // 仅教师和管理员可录入 }, { path: /report/:studentId, component: ReportView, props: true, meta: { requiresAuth: true, roles: [admin, teacher, student, parent] } } ] }) // 全局守卫检查角色权限 router.beforeEach((to, from, next) { const token localStorage.getItem(auth_token) if (!token !to.meta.public) return next(/login) if (to.meta.requiresAuth) { const userRole localStorage.getItem(user_role) if (to.meta.roles !to.meta.roles.includes(userRole || )) { return next(/home) // 无权限跳首页 } } next() }) export default router逻辑说明meta.roles字段声明路由所需角色beforeEach守卫读取localStorage中的user_role进行比对。这种方式比后端鉴权更轻量适合内部系统真实项目中user_role应由登录接口返回并存入本地避免伪造。3. 实现核心业务五维指标录入与雷达图生成3.1 后端提供指标配置 API支持动态增删改查学生综合素质评价的指标如“课堂参与度”“志愿服务时长”“艺术展演等级”不是固定死的教务处可能每学期调整。因此Indicator实体需支持 CRUD并通过PreUpdate自动维护更新时间Entity Table(name t_indicator) Data public class Indicator { Id GeneratedValue(strategy GenerationType.IDENTITY) private Long id; Column(name code, length 50, unique true, nullable false) // 如 DE_001 private String code; Column(name name, length 100, nullable false) // 如 德育-课堂表现 private String name; Column(name category, length 20, nullable false) // moral, intellectual, physical, aesthetic, labor private String category; // 五维分类 Column(name weight, nullable false, precision 3, scale 2) // 0.00~1.00 private BigDecimal weight; Column(name max_score, nullable false) // 满分如 100 private Integer maxScore; Column(name is_enabled, nullable false) private Boolean enabled true; Column(name updated_at) UpdateTimestamp private LocalDateTime updatedAt; }3.1.1 编写 IndicatorController暴露 REST 接口RestController RequestMapping(/indicators) RequiredArgsConstructor public class IndicatorController { private final IndicatorService indicatorService; GetMapping public ResultListIndicator listAll() { return Result.success(indicatorService.findAllEnabled()); } PostMapping public ResultIndicator create(Valid RequestBody Indicator indicator) { return Result.success(indicatorService.save(indicator)); } PutMapping(/{id}) public ResultIndicator update(PathVariable Long id, Valid RequestBody Indicator indicator) { indicator.setId(id); return Result.success(indicatorService.save(indicator)); } DeleteMapping(/{id}) public ResultVoid delete(PathVariable Long id) { indicatorService.deleteById(id); return Result.success(); } }参数说明Valid触发NotNull,Min,Max等注解校验ResultT是自定义响应包装类统一包含code,message,data字段避免前端反复判断response.data.datafindAllEnabled()方法只返回enabledtrue的指标保证前端下拉框不显示已停用项。3.2 前端实现指标选择与评分录入表单在ScoreInputView.vue中使用el-form动态渲染指标template el-form :modelform label-width120px el-form-item label学生学号 el-input v-modelform.studentId / /el-form-item el-form-item v-forindicator in indicators :keyindicator.id :labelindicator.name el-input-number v-modelform.scores[indicator.id] :min0 :maxindicator.maxScore :step0.5 :precision1 placeholder请输入分数 / div classel-form-item__description 满分 {{ indicator.maxScore }}权重 {{ indicator.weight }} /div /el-form-item el-form-item el-button typeprimary clicksubmit提交评分/el-button /el-form-item /el-form /template script setup langts import { ref, onMounted } from vue import request from /utils/request interface Indicator { id: number code: string name: string category: string weight: number maxScore: number } const indicators refIndicator[]([]) const form ref({ studentId: , scores: {} as Recordnumber, number // key: indicator.id, value: score }) onMounted(async () { const res await request.get(/indicators) indicators.value res.data }) const submit async () { const records Object.entries(form.value.scores) .filter(([, score]) score ! undefined score 0) .map(([indicatorId, score]) ({ studentId: form.value.studentId, indicatorId: Number(indicatorId), score, semester: 2023-2024-2, evaluatorType: teacher })) await request.post(/assessment-records/batch, records) ElMessage.success(评分提交成功) } /script逻辑说明v-for动态生成表单项form.scores是一个对象键为指标 ID值为分数submit方法将非空分数构造成数组调用/assessment-records/batch批量插入避免 N 次 HTTP 请求。filter确保只提交有值的项map构造后端所需的 DTO 结构。3.3 生成雷达图ECharts 封装与数据映射雷达图是综合素质评价的视觉核心。后端需按五维聚合数据前端用 ECharts 渲染3.3.1 后端提供聚合接口/reports/summary/{studentId}GetMapping(/reports/summary/{studentId}) public ResultMapString, Object getSummary(PathVariable String studentId) { // 按 category 分组计算加权平均分 MapString, BigDecimal categoryScores assessmentRecordRepository .findCategoryWeightedAverage(studentId); // 获取各维度指标详情用于雷达图标签 ListIndicator indicators indicatorService.findByCategories( Arrays.asList(moral, intellectual, physical, aesthetic, labor) ); MapString, Object result new HashMap(); result.put(categories, Arrays.asList(德育, 智育, 体育, 美育, 劳育)); result.put(scores, categoryScores.values().stream() .map(BigDecimal::doubleValue).collect(Collectors.toList())); result.put(indicators, indicators.stream() .map(i - Map.of(name, i.getName(), weight, i.getWeight())) .collect(Collectors.toList())); return Result.success(result); }3.3.2 前端使用 ECharts 渲染雷达图template div refchartRef stylewidth: 600px; height: 400px;/div /template script setup langts import { ref, onMounted, onUnmounted } from vue import * as echarts from echarts import request from /utils/request const chartRef refHTMLDivElement | null(null) let chart: echarts.ECharts | null null onMounted(() { if (!chartRef.value) return chart echarts.init(chartRef.value) // 初始化配置 const option { tooltip: {}, radar: { indicator: [ { name: 德育, max: 100 }, { name: 智育, max: 100 }, { name: 体育, max: 100 }, { name: 美育, max: 100 }, { name: 劳育, max: 100 } ], center: [50%, 45%], radius: 60% }, series: [{ type: radar, data: [{ value: [60, 75, 80, 65, 70], // 示例数据 name: 学生综合得分 }] }] } chart.setOption(option) }) onUnmounted(() { if (chart) chart.dispose() }) /script关键点radar.indicator数组顺序必须与后端返回的categories顺序严格一致series.data[0].value是五维分数数组需按“德育、智育、体育、美育、劳育”顺序排列center和radius参数确保图表在容器中居中且大小合适避免移动端挤压。4. 数据库设计与初始化从 ER 图到可执行 SQL4.1 核心表 ER 关系与字段设计依据学生综合素质评价系统的数据库不是范式优先而是业务可读性优先。以下是四张核心表的字段设计逻辑表名字段类型说明设计依据t_studentid,student_id,name,grade,class_namePK, VARCHAR, VARCHAR, VARCHAR, VARCHARstudent_id为业务主键学号非自增 IDgrade和class_name用于筛选统计学号是教务系统唯一标识避免用自增 ID 关联防止跨系统数据迁移失败t_indicatorid,code,name,category,weight,max_score,enabledPK, VARCHAR, VARCHAR, ENUM, DECIMAL, INT, TINYINTcategory用 ENUM 而非外键因只有 5 个固定值减少 JOIN 开销五维分类极少变动ENUM 比关联表查询更快且便于 SQL 聚合如GROUP BY categoryt_assessment_recordid,student_id,indicator_id,score,semester,evaluator_type,created_atPK, VARCHAR, BIGINT, DECIMAL, VARCHAR, VARCHAR, DATETIMEsemester为字符串如 2023-2024-2非日期类型因学期非标准日历周期学期标识含学年学期无法用 DATE 类型表达字符串更直观且支持模糊查询如LIKE 2023%t_userid,username,password,role,real_name,departmentPK, VARCHAR, VARCHAR, ENUM, VARCHAR, VARCHARrole为 ENUM(admin,teacher,student,parent)非外键角色固定且少ENUM 比关联表节省空间且WHERE roleteacher查询更快4.1.1 创建数据库与表结构的完整 SQL 脚本-- 创建数据库UTF8MB4 支持 emoji如学生留言用 CREATE DATABASE IF NOT EXISTS student_assessment CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; USE student_assessment; -- 学生表 CREATE TABLE t_student ( id BIGINT PRIMARY KEY AUTO_INCREMENT, student_id VARCHAR(20) NOT NULL UNIQUE COMMENT 学号业务主键, name VARCHAR(50) NOT NULL COMMENT 姓名, grade VARCHAR(10) NOT NULL COMMENT 年级如 高一、大二, class_name VARCHAR(30) NOT NULL COMMENT 班级名称, created_at DATETIME DEFAULT CURRENT_TIMESTAMP, updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT学生基本信息; -- 指标表 CREATE TABLE t_indicator ( id BIGINT PRIMARY KEY AUTO_INCREMENT, code VARCHAR(50) NOT NULL UNIQUE COMMENT 指标编码如 DE_001, name VARCHAR(100) NOT NULL COMMENT 指标名称, category ENUM(moral,intellectual,physical,aesthetic,labor) NOT NULL COMMENT 五维分类, weight DECIMAL(3,2) NOT NULL DEFAULT 0.00 COMMENT 权重0.00~1.00, max_score INT NOT NULL DEFAULT 100 COMMENT 满分, enabled TINYINT(1) NOT NULL DEFAULT 1 COMMENT 是否启用1启用0停用, created_at DATETIME DEFAULT CURRENT_TIMESTAMP, updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT评价指标配置; -- 评分记录表 CREATE TABLE t_assessment_record ( id BIGINT PRIMARY KEY AUTO_INCREMENT, student_id VARCHAR(20) NOT NULL COMMENT 学号, indicator_id BIGINT NOT NULL COMMENT 指标ID, score DECIMAL(3,1) NOT NULL COMMENT 得分0.0~99.9, semester VARCHAR(20) NOT NULL COMMENT 学期标识如 2023-2024-2, evaluator_type ENUM(admin,teacher,student,parent) NOT NULL COMMENT 评价者类型, created_at DATETIME DEFAULT CURRENT_TIMESTAMP, INDEX idx_student_semester (student_id, semester), INDEX idx_indicator (indicator_id), FOREIGN KEY (student_id) REFERENCES t_student(student_id) ON DELETE CASCADE, FOREIGN KEY (indicator_id) REFERENCES t_indicator(id) ON DELETE RESTRICT ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT学生评分记录; -- 用户表用于登录 CREATE TABLE t_user ( id BIGINT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(50) NOT NULL UNIQUE COMMENT 登录账号, password VARCHAR(100) NOT NULL COMMENT BCRYPT 加密密码, role ENUM(admin,teacher,student,parent) NOT NULL COMMENT 角色, real_name VARCHAR(50) NOT NULL COMMENT 真实姓名, department VARCHAR(100) COMMENT 所属部门/班级, created_at DATETIME DEFAULT CURRENT_TIMESTAMP, updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT系统用户;参数说明FOREIGN KEY ... ON DELETE CASCADE保证删除学生时自动清理其评分记录ON DELETE RESTRICT防止误删指标导致历史记录丢失INDEX idx_student_semester加速按学生学期查询如生成学期报告ENGINEInnoDB支持事务和外键CHARSETutf8mb4避免微信昵称等特殊字符乱码。4.2 初始化测试数据插入 5 个典型指标与 10 名学生执行以下 SQL 插入基础数据确保首次启动即可演示-- 插入五维指标权重总和为 1.00 INSERT INTO t_indicator (code, name, category, weight, max_score) VALUES (DE_001, 课堂参与度, moral, 0.20, 100), (IN_001, 学业成绩排名, intellectual, 0.30, 100), (PH_001, 体质健康测试, physical, 0.20, 100), (AE_001, 艺术特长等级, aesthetic, 0.15, 100), (LA_001, 劳动实践时长, labor, 0.15, 100); -- 插入 10 名学生模拟高一某班 INSERT INTO t_student (student_id, name, grade, class_name) VALUES (2023001, 张三, 高一, 1班), (2023002, 李四, 高一, 1班), (2023003, 王五, 高一, 1班), (2023004, 赵六, 高一, 1班), (2023005, 钱七, 高一, 1班), (2023006, 孙八, 高一, 1班), (2023007, 周九, 高一, 1班), (2023008, 吴十, 高一, 1班), (2023009, 郑十一, 高一, 1班), (2023010, 王十二, 高一, 1班); -- 插入管理员用户密码为 123456实际需 BCrypt 加密 INSERT INTO t_user (username, password, role, real_name) VALUES (admin, $2a$10$uQXqJZzYVpKxRcLmNnOoPqRsTuVwXyZaBcDeFgHiJkLmNoPqRsTuVwXyZ, admin, 系统管理员);安全提示示例密码已用 BCrypt 加密$2a$10$...是标准前缀实际部署时需用 Spring Security 的PasswordEncoder生成t_user.password字段长度设为 100足够存储 BCrypt 哈希值通常 60 字符。5. 需求文档落地技巧把 Word 条款转成可验证的代码逻辑5.1 将“跨学期累计加分”需求转化为数据库查询与 Service 逻辑需求文档第 3.2.4 条原文“志愿服务类指标code LIKE VO%允许跨学期累计同一学生在所有学期的得分之和作为最终分用于评优。” 这不是一句空话而是要落实到三层5.1.1 数据库层添加累计视图View简化查询-- 创建累计得分视图供报表模块直接 SELECT CREATE VIEW v_student_volunteer_total AS SELECT student_id, SUM(score) AS total_score, COUNT(*) AS record_count FROM t_assessment_record r JOIN t_indicator i ON r.indicator_id i.id WHERE i.code LIKE VO% GROUP BY student_id;优势视图封装复杂 JOIN 和 WHERE报表 SQL 只需SELECT * FROM v_student_volunteer_total WHERE student_id ?DBA 可独立优化视图底层索引无需修改 Java 代码。5.1.2 Service 层编写专用方法明确事务边界Service RequiredArgsConstructor public class VolunteerScoreService { private final AssessmentRecordRepository recordRepo; private final IndicatorRepository indicatorRepo; Transactional(readOnly true) public BigDecimal getTotalVolunteerScore(String studentId) { // 先查出所有志愿服务类指标 ID ListLong volunteerIndicatorIds indicatorRepo.findIdsByCodeLike(VO%); // 再查这些指标下该学生的全部记录 return recordRepo.sumScoresByStudentAndIndicators(studentId, volunteerIndicatorIds); } }5.1.3 Controller 层暴露为独立接口避免污染通用接口GetMapping(/volunteer-total/{studentId}) public ResultBigDecimal getVolunteerTotal(PathVariable String studentId) { return Result.success(volunteerScoreService.getTotalVolunteerScore(studentId)); }验证方法用 Postman 调用GET /volunteer-total/2023001对比数据库SELECT SUM(score) FROM t_assessment_record r JOIN t_indicator i ON r.indicator_idi.id WHERE r.student_id2023001 AND i.code LIKE VO%结果是否一致。不一致则说明 Service 层逻辑有误而非前端展示问题。5.2 “家长只能查看自己孩子”需求的双重校验实现需求文档第 4.1.2 条“家长登录后仅能查看其绑定学生的评价报告不可越权访问。” 这需要前后端协同防御前端校验登录后后端返回studentIds: [2023001]前端路由/report/:studentId的beforeRouteEnter守卫检查to.params.studentId是否在studentIds数组中后端校验ReportController的每个方法都接收AuthenticationPrincipal User user并在 Service 层查询时强制WHERE student_id ? AND parent_id ?t_parent_student关联表需提前创建。// 在 ReportService 中 public ReportData getReport(String studentId, User currentUser) { // 1. 检查该学生是否属于当前家长 boolean isChild parentStudentRepository.existsByParentIdAndStudentId( currentUser.getId(), studentId ); if (!isChild) { throw new AccessDeniedException(无权查看该学生报告); } // 2. 查询报告数据此处省略具体 SQL return buildReport(studentId); }关键点后端校验是最后一道防线绝不能只靠前端隐藏按钮。即使黑客绕过前端路由直接调用/report/2023002后端也会抛出AccessDeniedException并返回 403。Spring Security 的PreAuthorize注解也可实现但显式 Service 层校验更易单元测试和调试。5.3 使用 Swagger 生成可交互的 API 文档替代静态 Word将springdoc-openapi-ui依赖加入pom.xml启动后访问http://localhost:8080/swagger-ui.html即可看到自动生成的 API 文档且支持在线调试dependency groupIdorg.springdoc/groupId artifactIdspringdoc-openapi-ui/artifactId version1.6.14/version /dependency落地价值测试人员不用再翻 Word 文档找接口地址直接在 Swagger 页面点击Try it out输入参数前端开发可一键生成 Mock 数据教务处老师能直观看到“哪些字段必填、哪些有枚举值”减少沟通成本。这才是真正“活”的需求文档。本文还有配套的精品资源点击获取