用 Spring Boot 搭一个学生成绩管理系统：从需求到踩坑

核心逻辑的几个关键点

业务代码是 MVC 那套，controller、service、repository 分得清楚。成绩相关的几个流程：

• 录入：先查学生选课状态，没问题就存库。
• 汇总：捞已审核的成绩项，按预设权重加权求和。
• 审核：确认是待审核的，更新审核标记。
• 留痕：每次修改往 score_history 表写一条旧值，方便回溯。

踩坑与处理

浮点精度
直接用 double 算分数肯定不行，加权后经常差个零点几。换成 BigDecimal 精确控制，四舍五入到两位：

BigDecimal usualRatio = new BigDecimal(scoreRule.getUsualRatio()).divide(new BigDecimal(100));
BigDecimal totalScore = usualScore.multiply(usualRatio)
    .add(midtermScore.multiply(midtermRatio))
    .setScale(2, BigDecimal.ROUND_HALF_UP);

查得太频繁
缓存统计结果很有必要。用 Spring Cache 接 Redis，按学生 ID + 课程 ID 做键：

@Cacheable(value = "score:student", key = "#studentId + ':' + #courseId")
public ScoreInfo getStudentCourseScore(Long studentId, Long courseId) {
    return scoreMapper.selectByStudentAndCourse(studentId, courseId);
}

修改痕迹
加一张 score_history 表，更新前把旧记录塞进去，出问题能追。

几段关键的代码

课程服务，创建和分页查都是常规操作：

package com.example.service.impl;

import com.example.dto.request.*;
import com.example.entity.CourseInfo;
import com.example.repository.CourseRepository;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
import org.springframework.transaction.annotation.Transactional;

@Slf4j
@Service
@Transactional
public class CourseServiceImpl implements CourseService {
    @Autowired
    private CourseRepository courseRepository;

    @Override
    public RestResult<Object> createCourse(CreateCourseRequest request) {
        if (courseRepository.findByCourseName(request.getCourseName()) != null) {
            return RestResult.error("课程名称已存在");
        }
        CourseInfo courseInfo = new CourseInfo();
        // BeanUtils.copyProperties...
        courseInfo.setCreateTime(LocalDateTime.now());
        try {
            courseRepository.save(courseInfo);
            return RestResult.success(courseInfo);
        } catch (Exception e) {
            log.error("创建课程失败", e);
            return RestResult.error("系统错误");
        }
    }

    @Override
    public RestResult<Object> queryCourseList(Integer pageNo, Integer pageSize, String keyword) {
        int page = (pageNo == null || pageNo <= 0) ? 1 : pageNo;
        int size = (pageSize == null || pageSize <= 0) ? 10 : pageSize;
        Pageable pageable = PageRequest.of(page - 1, size);
        Page<CourseInfo> coursePage = courseRepository.findAll(pageable);
        return RestResult.success(coursePage);
    }
}

成绩服务，录入前要校验选课，计算时只算已审核的：

package com.example.service.impl;

import com.example.dto.request.ScoreRecordRequest;
import com.example.entity.ScoreRecord;
import com.example.repository.ScoreRepository;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
import org.springframework.transaction.annotation.Transactional;

@Slf4j
@Service
@Transactional
public class ScoreServiceImpl implements ScoreService {
    @Autowired
    private ScoreRepository scoreRepository;

    @Override
    public RestResult recordScore(ScoreRecordRequest request) {
        if (!checkStudentSelectCourse(request.getStudentId(), request.getCourseId())) {
            return RestResult.error("学生未选该课程或课程不存在");
        }
        try {
            ScoreRecord scoreRecord = new ScoreRecord();
            scoreRecord.setStudentId(request.getStudentId());
            scoreRecord.setScoreValue(BigDecimal.valueOf(request.getScore()));
            scoreRecord.setIsReviewed(0);
            scoreRecord.setCreateTime(LocalDateTime.now());
            scoreRepository.save(scoreRecord);
            return RestResult.success("录入成功");
        } catch (Exception e) {
            log.error("录入成绩失败", e);
            return RestResult.error("系统异常");
        }
    }

    @Override
    public RestResult calculateScore(Long studentId, Long courseId) {
        List<ScoreRecord> records = scoreRepository.findByStudentIdAndCourseIdOrderByCreateTimeAsc(studentId, courseId);
        if (records.isEmpty()) return RestResult.error("无相关成绩记录");
        
        double totalScore = 0.0;
        for (ScoreRecord record : records) {
            if (record.getIsReviewed() == 1) {
                totalScore += record.getScoreValue().doubleValue() * record.getScoreWeight().doubleValue();
            }
        }
        return RestResult.success(totalScore);
    }
}

这套下来有什么好处

说实话，这种系统写起来不复杂，但收益看得见：

• 原来老师录成绩、算总评要折腾好久，现在自动化后省了大概 70% 的机械操作，人力能放到教学改进上。
• 基于角色的权限配上操作日志，追责有据，比 Excel 传来传去安全得多。
• 结构上留了扩展口子，后面接教务系统、加考勤关联都方便。

用 AI 辅助出代码，省了不少琐碎时间，规范上也勉强说得过去，中小型教学系统拿这个当底子够用了。