基于HBuilderX与UniCloud的学生成绩管理系统实战：从Schema设计到云函数调用的全流程解析

1次阅读

共计 3150 个字符，预计需要花费 8 分钟才能阅读完成。

在传统教育场景中，成绩管理通常依赖 Excel 或单机版软件，存在数据易丢失、多端同步困难、权限控制薄弱等问题。例如某中学使用 FTP 共享 Excel 文件，曾因误操作导致全年级数据被覆盖。云原生方案通过以下优势解决这些问题：

实时协同：教师可即时更新成绩，学生端自动同步
权限颗粒化：按角色（管理员 / 教师 / 学生）控制数据可见性
灾备能力：云端自动多重备份
跨平台访问：无需安装专用客户端

UniCloud 提供两种数据操作方式，需根据场景选择：

维度	ClientDB	云函数
响应速度	快（直接前端操作）	中等（需网络请求）
安全性	依赖 ACL 配置	可自定义校验逻辑
适用场景	简单 CRUD	复杂事务 / 敏感操作
代码量	少（自动生成 API）	多（需手动编写）

推荐策略：
1. 成绩查询使用 ClientDB（高频且低风险）
2. 成绩修改使用云函数（需教师权限校验）

在 uniCloud/database 目录创建scores.schema.json：

{
  "bsonType": "object",
  "required": ["student_id", "course"],
  "permission": {
    "read": "auth.uid != null",
    "create": "doc.teacher_id == auth.uid",
    "update": "doc.teacher_id == auth.uid"
  },
  "properties": {
    "student_id": {
      "bsonType": "string",
      "title": "学号",
      "foreignKey": "students._id"
    },
    "course": {
      "bsonType": "string",
      "enum": ["math", "physics", "chemistry"]
    },
    "score": {
      "bsonType": "int",
      "minimum": 0,
      "maximum": 100
    }
  }
}

关键设计点：
– 通过 foreignKey 关联学生表实现参照完整性
– enum限制课程类型避免脏数据
– 权限规则确保：
– 学生只能查自己成绩（需额外前端过滤）
– 只有录入教师可修改

使用 uni-app 的 easycom 模式创建组件：

登录页（/pages/login/login.vue）：

<template>
  <uni-forms :model="formData" @submit="submit">
    <uni-forms-item label="账号" name="username">
      <uni-easyinput v-model="formData.username" />
    </uni-forms-item>
    <uni-forms-item label="密码" name="password">
      <uni-easyinput type="password" v-model="formData.password" />
    </uni-forms-item>
    <button form-type="submit"> 登录 </button>
  </uni-forms>
</template>

<script>
export default {
  methods: {async submit() {const { username, password} = this.formData
      await uniCloud.loginWithJWT({
        username,
        password
      })
      uni.reLaunch({url: '/pages/scores/list'})
    }
  }
}
</script>

成绩列表页实现 ClientDB 查询：

const db = uniCloud.database()
// 学生只能查看自己的记录
const query = auth.role === 'student' 
  ? db.collection('scores').where(`student_id=='${auth.uid}'`)
  : db.collection('scores')

const res = await query
  .field('student_id,course,score,teacher_id')
  .orderBy('score desc')
  .get()

创建uniCloud/cloudfunctions/update-score：

'use strict';
const db = uniCloud.database()
const checkPermission = require('permission-utils')

exports.main = async (event, context) => {
  // 参数校验
  if (!event.course || !event.score) {return { code: 400, msg: '参数不完整'}
  }

  // 权限验证（需教师角色且是记录创建者）const permission = await checkPermission({
    collection: 'scores',
    docId: event.id,
    operation: 'update'
  })

  if (!permission) {return { code: 403, msg: '无操作权限'}
  }

  // 执行更新
  try {const res = await db.collection('scores')
      .doc(event.id)
      .update({
        score: event.score,
        updated_at: Date.now()})

    return {code: 200, data: res}
  } catch (e) {return { code: 500, msg: e.message}
  }
}

索引设计：

// 在 schema.json 中添加
"indexes": [
  {
    "name": "student_course_idx",
    "fields": ["student_id", "course"],
    "unique": true
  }
]

批量插入 使用 add 替代循环：

// 批量导入成绩
const data = csvData.map(item => ({student_id: item[0],
  course: item[1],
  score: parseInt(item[2])
}))

await db.collection('scores')
  .add(data)
  .catch(console.error)

防注入措施：

// 错误做法（直接拼接）const badQuery = `name=='${userInput}'`

// 正确做法（使用条件对象）db.collection('scores')
  .where({name: userInput})

权限分层：
学生：read(self)
教师：create/update(own)
管理员：delete

本地调试问题：
现象：云函数本地运行报PERMISSION_DENIED
解决：在 uni-config-center 中配置服务空间 ID
数据库连接失败：
检查 uni-id 的config.json是否启用
确认网络环境未屏蔽 unicloud 域名

本系统核心模式可复用于考勤、作业等场景，扩展建议：

数据分析模块：

// 按班级统计平均分
const res = await db.collection('scores')
  .aggregate()
  .match({class: '2023-1'})
  .group({
    _id: '$course',
    avgScore: $.avg('$score')
  })
  .end()