小程序 + Django 的大学生支教管理系统,这个组合在最近的毕业设计和实际项目里出现频率很高。我接触过不少类似的项目,有的做成了纯粹的报名工具,有的做成了后台管理面板,真正把“支教全流程”跑通的其实不多。
这个项目标题里有两个关键词值得注意:一是“小程序”,说明前端形态锁定在微信生态里;二是“Django”,后端框架选择了 Python 系最成熟的重量级方案。整套系统要解决的核心问题,是把大学生支教从报名、审核、课程安排到反馈总结的完整链路线上化,让管理员、支教学生、受援学校三方在同一个平台里协作。
如果你是正在做毕业设计、或者想给学校社团搭建一套支教管理工具,这篇文章可以给你提供一套能够直接复用的设计与实现方案。我会从技术选型、数据模型、核心功能实现、部署上线这几个维度拆开讲,全程结合真实踩坑经验。
1. 项目整体设计与技术选型思路
1.1 为什么用 Django 做后端
Django 在 Python Web 框架里的地位类似“全家桶”,它自带 Admin 后台、ORM、认证体系、表单处理、分页组件,这对支教管理系统这种典型的管理类应用来说,性价比非常高。
先说 ORM。支教管理系统的数据模型不算复杂,但关联关系很多:一个支教项目关联多个志愿者,一个志愿者报名多个项目,每个项目又包含多节课程安排。如果用原生 SQL 硬写,光是多表联查就能写到手软。Django 的 ORM 可以直接用 Student.objects.filter(project__status='ongoing') 这种双下划线语法跨表查询,代码简洁,还能避免手动拼接 SQL 带来的注入风险。
再说 Admin 后台。大学生支教管理系统的大部分操作都是增删改查,Django Admin 可以零代码生成一个完整的管理界面。我在实际开发中一般是先让管理员用 Admin 录入基础数据,等接口写完后再切到自定义前端页面。这样项目的开发周期能压缩三分之一以上。
Django 自带的后台管理系统,你不用白不用,它能让项目在早期快速跑通业务闭环。
第三是认证体系。Django 的 django.contrib.auth 提供了用户注册、登录、Session 管理、权限分组,这些都是现成的。对于支教系统来说,需要区分超管、学院负责人、支教学生、受援学校老师等角色,直接基于 Django 的 Group 和 Permission 扩展就行,不用自己从零写一套权限系统。
1.2 为什么用微信小程序做前端
支教学生的使用场景非常碎片化:在宿舍用手机报名、在支教路上查看日程、用手机提交课程反馈。微信小程序“即用即走”的特性天然适配这种移动场景,学生不用下载 App,扫码就能用。
小程序端的技术选型有两条路:原生开发,或者使用 uni-app / Taro 等跨端框架。我个人的建议是:如果只针对微信小程序一个平台,用原生开发就够了。原生小程序的 WXML + WXSS 结构清晰,微信开发者工具里的调试体验也最好。如果后续想同时上线支付宝小程序或抖音小程序,再考虑换成 uni-app。
需要注意的是,小程序和 Django 后端的通信没有“跨域”问题,这一点和 Web 前端完全不同。小程序通过 wx.request 直接请求域名接口即可,但要求该域名必须已经备案,并且在小程序后台配置为 request 合法域名。这个环节是新手最容易卡住的地方,后面我会单独讲。
1.3 系统模块与角色设计
支教管理系统从业务上看,可以拆成几个核心模块:
- 用户管理:学生注册、登录、身份认证、个人信息维护;
- 支教项目管理:发布支教项目、设置招募时间、人数上限、项目地点与周期;
- 报名与审核:学生提交报名申请,管理员审核通过后纳入项目成员;
- 课程与排课管理:支教期间的上课安排、课程表生成与调整;
- 签到与考勤:支教出勤记录,用于后期志愿时长认定;
- 反馈与总结:支教结束后提交个人总结、支教心得,管理员可以进行评分归档;
- 数据统计:按学院、按时间统计报名人数、支教时长等数据。
从角色权限上看,我把系统分成四类用户:
| 角色 | 核心权限 | 使用端 |
|---|---|---|
| 超级管理员 | 全模块管理、数据导出、用户分配 | 管理后台 |
| 学院负责人 | 审核本院学生报名、查看本院统计数据 | 管理后台 |
| 支教学生 | 报名项目、查看课表、签到、提交总结 | 微信小程序 |
| 受援学校教师 | 确认支教课程安排、提交验收评价 | 微信小程序 |
小程序端不需要承担所有功能,它主要负责学生端的高频操作,管理类的功能还是放到 Django Admin 或者自建的 Web 管理端更高效。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 核心模型设计与数据库方案
2.1 数据模型设计
数据模型是整个系统的基础,设计不好后面改起来非常痛苦。支教管理系统的核心模型我建议这样设计:
python复制from django.db import models
from django.contrib.auth.models import AbstractUser
class UserProfile(AbstractUser):
"""扩展用户模型"""
USER_TYPE_CHOICES = (
('admin', '管理员'),
('student', '学生'),
('teacher', '受援学校老师'),
)
user_type = models.CharField('用户类型', max_length=20, choices=USER_TYPE_CHOICES, default='student')
phone = models.CharField('手机号', max_length=11, blank=True)
student_no = models.CharField('学号', max_length=20, blank=True)
school = models.CharField('所属院校', max_length=50, blank=True)
college = models.CharField('学院', max_length=50, blank=True)
class Meta:
verbose_name = '用户信息'
verbose_name_plural = verbose_name
class TeachingProject(models.Model):
"""支教项目表"""
STATUS_CHOICES = (
('recruiting', '招募中'),
('ongoing', '支教中'),
('finished', '已结束'),
)
title = models.CharField('项目名称', max_length=100)
location = models.CharField('支教地点', max_length=200)
description = models.TextField('项目介绍')
start_date = models.DateField('开始日期')
end_date = models.DateField('结束日期')
quota = models.IntegerField('招募人数')
current_count = models.IntegerField('已报名人数', default=0)
status = models.CharField('状态', max_length=20, choices=STATUS_CHOICES, default='recruiting')
created_at = models.DateTimeField(auto_now_add=True)
class Meta:
verbose_name = '支教项目'
verbose_name_plural = verbose_name
class VolunteerApplication(models.Model):
"""报名申请表"""
STATUS_CHOICES = (
('pending', '待审核'),
('approved', '已通过'),
('rejected', '已拒绝'),
)
project = models.ForeignKey(TeachingProject, on_delete=models.CASCADE, verbose_name='支教项目')
student = models.ForeignKey(UserProfile, on_delete=models.CASCADE, verbose_name='报名学生')
motivation = models.TextField('报名动机')
self_intro = models.TextField('个人简介')
status = models.CharField('审核状态', max_length=20, choices=STATUS_CHOICES, default='pending')
applied_at = models.DateTimeField(auto_now_add=True)
reviewed_by = models.ForeignKey(UserProfile, on_delete=models.SET_NULL, null=True, blank=True, related_name='reviewed_applications')
class Meta:
unique_together = ('project', 'student')
verbose_name = '报名申请'
这段代码里有两个容易忽略的细节:
UserProfile 继承 AbstractUser,这是 Django 推荐的自定义用户方式。你需要在 settings.py 里设置 AUTH_USER_MODEL = 'your_app.UserProfile',并且必须在第一次 migrate 前完成设置,否则后面改起来会牵扯到数据库迁移,非常麻烦。
VolunteerApplication 里用 unique_together 约束了同一个学生对同一个项目只能报名一次,数据库层面做了唯一性校验,避免用户重复提交。这是我在实际开发中吃过亏后补上的,初期没有这个约束,有学生连点了两次报名按钮,生成了两条重复记录。
2.2 课程与课时安排的建模
支教课程表是一个典型的“一个项目多节课”结构,但这里有个设计上的坑:课程表的周期是固定的,还是可以由支教学生自己上传安排?
我建议做成两种模式兼容。项目发布时可以指定一个“按周排课”的固定课表模式,也可以开放“自定义课时”模式,由支教队长上传每日课程安排(包括上课时间、年级科目、对应讲师)。模型可以这样建:
python复制class CourseSlot(models.Model):
"""课时表"""
project = models.ForeignKey(TeachingProject, on_delete=models.CASCADE, related_name='course_slots')
course_name = models.CharField('课程名称', max_length=50)
course_date = models.DateField('上课日期')
start_time = models.TimeField('开始时间')
end_time = models.TimeField('结束时间')
teacher = models.ForeignKey(UserProfile, on_delete=models.SET_NULL, null=True, blank=True, related_name='teaching_courses')
location = models.CharField('上课地点', max_length=100)
note = models.CharField('备注', max_length=200, blank=True)
class Meta:
ordering = ['course_date', 'start_time']
课时表的意义不仅仅是排课,它还能作为后面“签到”和“志愿时长统计”的关联依据。每个课时可以继续扩展一个 AttendanceRecord 模型,记录学生是否到场、签到时间、代签标记等。
2.3 数据库迁移与初始化数据
模型设计完成后,几个操作顺序很重要:
- 先在
settings.py里配置好数据库连接(开发环境用 SQLite 就够,生产环境建议切到 MySQL); - 执行
python manage.py makemigrations生成迁移文件; - 执行
python manage.py migrate生成数据表; - 执行
python manage.py createsuperuser创建管理员账号; - 进入 Admin 后台录入测试数据。
如果用了 MySQL,建议在 settings.py 里额外设置 CONN_MAX_AGE=60,减少频繁建立数据库连接的开销。另外,字符集一定要配置成 utf8mb4,否则用户在小程序里输入 emoji 表情会直接报错:
python复制DATABASES = {
'default': {
'ENGINE': 'django.db.backends.mysql',
'NAME': 'teaching_db',
'USER': 'root',
'PASSWORD': 'your_password',
'HOST': '127.0.0.1',
'PORT': '3306',
'CONN_MAX_AGE': 60,
'OPTIONS': {
'charset': 'utf8mb4',
},
}
}
3. 小程序端核心功能实现
3.1 微信登录:从 wx.login 到自定义登录态
小程序登录是支教系统用户身份识别的第一步。微信的登录流程本身不复杂,但很多初学者会在这里摔跟头,尤其是遇到“获取登录后的微信用户失败”这类报错时容易一头雾水。
整个登录链路是这样的:
- 小程序端调用
wx.login()获取一个临时凭证code; - 小程序把
code发送到 Django 后端; - 后端拿着
code向微信接口jscode2session换取openid和session_key; - 后端用
openid查找或创建用户,生成本站的token返回给小程序; - 小程序把
token存到storage,后续请求都带上这个token。
Django 端的核心代码可以这样实现:
python复制import requests
import hashlib
from django.conf import settings
from django.http import JsonResponse
from django.views.decorators.csrf import csrf_exempt
from .models import UserProfile
@csrf_exempt
def wx_login(request):
"""微信小程序登录接口"""
if request.method != 'POST':
return JsonResponse({'code': 405, 'msg': '请求方式错误'})
code = request.POST.get('code')
if not code:
return JsonResponse({'code': 400, 'msg': '缺少code参数'})
# 向微信接口换取 openid
appid = settings.WX_APPID
secret = settings.WX_APPSECRET
url = f'https://api.weixin.qq.com/sns/jscode2session?appid={appid}&secret={secret}&js_code={code}&grant_type=authorization_code'
resp = requests.get(url).json()
openid = resp.get('openid')
if not openid:
return JsonResponse({'code': 500, 'msg': f'微信登录失败: {resp.get("errmsg")}'})
# 使用 openid 查找或创建用户
user, created = UserProfile.objects.get_or_create(
username=f'wx_{openid[:20]}',
defaults={'user_type': 'student'}
)
# 生成自定义 token(这里用 openid 的哈希值+随机盐)
token = hashlib.sha256(f'{openid}{settings.SECRET_KEY}'.encode()).hexdigest()
request.session[token] = user.id
return JsonResponse({'code': 0, 'data': {'token': token, 'is_new': created}})
这里有一个重要的安全细节:** session_key 永远不要返回给小程序端,也不要存储到数据库只用于前端展示**。session_key 是微信用于解密用户手机号、UnionID 等敏感数据的密钥,一旦泄露到前端,攻击者可以利用它获取到用户的敏感数据。正确做法是在后端使用完就丢弃,不落库。
另外,get_or_create 用 username 作为查找条件是刻意为之。因为微信的 openid 差不多有 28 个字符,直接做用户名会超长,所以我截取前 20 个字符再加前缀。但这样做有问题:如果同一个 openid 前缀相同,可能碰撞。更稳妥的做法是给模型加一个 openid 字段,用 openid 做唯一键,而不是为了省事拼到 username 里。这块我在后期重构时改掉了,建议你直接一步到位。
3.2 请求封装与登录态失效处理
小程序的 wx.request 有太多重复代码,如果不加封装,每个页面都要写一遍 header 和 url 前缀,维护成本极高。我习惯在 utils/request.js 里统一封装:
javascript复制const BASE_URL = 'https://your-domain.com/api'
function request(path, method = 'GET', data = {}) {
return new Promise((resolve, reject) => {
const token = wx.getStorageSync('token')
wx.request({
url: BASE_URL + path,
method: method,
data: data,
header: {
'content-type': 'application/json',
'Authorization': token ? `Token ${token}` : ''
},
success: (res) => {
// 判断 token 是否过期
if (res.statusCode === 401) {
wx.removeStorageSync('token')
wx.navigateTo({ url: '/pages/login/login' })
reject(res.data)
return
}
if (res.data.code !== 0) {
wx.showToast({ title: res.data.msg, icon: 'none' })
reject(res.data)
return
}
resolve(res.data.data)
},
fail: (err) => {
wx.showToast({ title: '网络异常', icon: 'none' })
reject(err)
}
})
})
}
module.exports = { request, BASE_URL }
所有接口统一走这个请求封装,好处是:登录态失效统一跳转登录页、错误提示不用每个页面重复写、接口地址统一管理。后续如果要加接口签名或者防重放机制,只需要改这一处。
3.3 单选框、表单校验与用户信息采集
支教报名表单是个典型的小程序表单场景:有输入框、有下拉选择、有单选框、有多行文本。这里有个使用原生组件时的细节:picker 组件在 iOS 和 Android 上的表现略有差异,特别是点击“取消”时返回的 change 事件要判断一下:
xml复制<picker mode="selector" range="{{colleges}}" bindchange="onCollegeChange">
<view class="picker-value">{{selectedCollege || '请选择学院'}}</view>
</picker>
javascript复制onCollegeChange(e) {
// 注意 e.detail.value 在取消时是 undefined,需要做兜底
if (e.detail.value !== undefined) {
this.setData({ selectedCollege: this.data.colleges[e.detail.value] })
}
}
再强调一下,小程序的 picker 组件 bindchange 事件,当用户点击取消时也会触发,此时 e.detail.value 是 undefined。如果不判断,表单会出现“用户没选学院但显示了一个学院”的诡异问题。
支教报名表单里经常需要用户填写“可支教科目”“支教时间意向”等信息,这些用单选框和 checkbox 表现比较直观。提交前做表单校验也很关键,可以在小程序端写一个 validateForm 方法统一校验必填项,减少无效请求对服务器的压力。
3.4 消息推送:订阅消息的最佳实践
支教系统里有一个高频需求:管理员审核通过学生报名后,要通过微信通知到学生。微信小程序的消息能力是“订阅消息”,和公众号模板消息完全不同——小程序必须先让用户主动订阅,才能给用户下发消息,而且一次订阅只能下发一次。
这意味着你在设计功能时,不能只在后端“想发就发”,必须在前端引导用户完成订阅动作。比如在报名提交成功的回调里弹出一个订阅请求:
javascript复制wx.requestSubscribeMessage({
tmplIds: ['YOUR_TEMPLATE_ID'],
success(res) {
// res['YOUR_TEMPLATE_ID'] === 'accept' 表示用户同意订阅
if (res['YOUR_TEMPLATE_ID'] === 'accept') {
// 后端记录该用户已订阅,后续审核结果可以推送
}
}
})
后端发送订阅消息时,需要先获取 access_token:
python复制def get_access_token():
"""获取微信全局access_token(需缓存)"""
url = f'https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid={settings.WX_APPID}&secret={settings.WX_APPSECRET}'
resp = requests.get(url).json()
return resp.get('access_token')
access_token 有效期 7200 秒,且每天有获取次数限制,绝对不能每次发送都请求一次微信接口。我见过有人把 access_token 单独存数据库表,每次先查库再用,这个思路是对的,但实现上更优雅的方案是存 Django 的缓存中:
python复制from django.core.cache import cache
def get_access_token():
token = cache.get('wx_access_token')
if token:
return token
# 重新获取并写入缓存,过期时间设为 7000 秒
token = request_wx_token()
cache.set('wx_access_token', token, 7000)
return token
订阅消息的发送本质上是把用户的 openid、模板 ID、页面跳转路径、数据组装好 POST 到微信接口。这里有一个长期存在的问题:用户如果订阅了但没有报名成功,或者报名了但已失效,推消息时就会报“用户拒绝接收消息”或“模板状态不正确”,这类失败得在后端做异常兜底,不要让报错影响主流程。
4. Django 后端接口与查询优化
4.1 接口风格选择:FBV 还是 CBV
Django 开发接口有函数视图(FBV)和类视图(CBV)两种风格,新手往往纠结怎么选。我的经验是:接口数量少、逻辑简单用 FBV,代码直观;接口数量多、且 CURD 模式明显用 CBV,可以继承 Django 自带的 ViewSet 减少样板代码。
如果是在 Django 里配合小程序做纯接口,不引入 Django REST Framework(DRF),我一般这样写路由和视图:
python复制from django.urls import path
from . import views
urlpatterns = [
path('api/projects', views.project_list, name='project_list'),
path('api/projects/<int:project_id>', views.project_detail, name='project_detail'),
path('api/apply', views.apply_project, name='apply_project'),
]
python复制def project_list(request):
"""获取支教项目列表(分页)"""
page = int(request.GET.get('page', 1))
page_size = int(request.GET.get('page_size', 10))
start = (page - 1) * page_size
end = page * page_size
projects = TeachingProject.objects.filter(status__in=['recruiting', 'ongoing']).order_by('-created_at')[start:end]
total = TeachingProject.objects.filter(status__in=['recruiting', 'ongoing']).count()
data = [{
'id': p.id,
'title': p.title,
'location': p.location,
'start_date': p.start_date.strftime('%Y-%m-%d'),
'end_date': p.end_date.strftime('%Y-%m-%d'),
'quota': p.quota,
'current_count': p.current_count,
'status': p.status,
} for p in projects]
return JsonResponse({'code': 0, 'data': {'list': data, 'total': total, 'page': page}})
如果不考虑引入 DRF,你可以用 JsonResponse 手动序列化数据,字段控制更精细。但如果项目里接口数量超过 30 个,强烈建议引入 DRF,它的序列化器、权限类、分页器能帮你省下大量时间。
4.2 删除对象时,请先想清楚 on_delete
Django 的 models.ForeignKey 必须指定 on_delete 参数,这个参数直接决定删除关联数据时的行为。支教系统里最常见的两个使用场景:
on_delete=models.CASCADE:删除项目时,连同报名记录、课表一起删除。适合“项目废弃后不保留任何痕迹”的场景。on_delete=models.SET_NULL:删除用户时,保留他名下的课时记录,但把teacher字段置空。适合“学生退出支教后,课程表里不再显示其信息但保留课程记录”的场景。
我踩过一个坑:某次测试删除了一个支教项目,结果发现关联的学生报名表数据被连坐清空了,导致统计报表里的历史数据全部丢失。后来我把核心“操作日志”相关的外键统一改成了 PROTECT,删除时会主动抛错,需要先处理下游数据才能删除父表数据。对于支教管理系统,PROTECT 比 CASCADE 更安全,它能防止误删。
4.3 常用查询的优化技巧
支教系统有几个高频查询,它们会成为性能瓶颈,需要特别优化:
第一个是列表页的 N+1 查询问题。比如查询项目列表时,需要显示“每个项目报名了多少人”,如果在 ORM 里没有预取关联数据,很容易出现一次查询项目列表后,又对每个项目单独执行一次 count 查询。正确做法是使用 annotate:
python复制from django.db.models import Count
projects = TeachingProject.objects.annotate(
apply_count=Count('volunteerapplication')
).order_by('-created_at')
这样一条 SQL 就搞定了,不会产生 N+1 次查询。
第二个是时间范围的筛选。支教课程表需要按日期范围查询,Django 的 __date 和 __range 非常方便:
python复制# 查询 2025 年 3 月 1 日到 3 月 7 日的课程
CourseSlot.objects.filter(
course_date__range=['2025-03-01', '2025-03-07']
)
需要注意:__range 边界是包含的,也就是 >= '2025-03-01' AND <= '2025-03-07',如果要排除当天,可以用 course_date__gte 和 course_date__lt 组合。
第三个是全文搜索。项目名称或地点的模糊搜索用 icontains,但它无法利用索引,数据量大了以后查询很慢。数据量超过 10 万条时,建议引入全文搜索引擎或者用 PostgreSQL 的 SearchVector。对于支教系统这个量级,前期用 icontains 没有大问题。
5. 部署上线与常见问题排查
5.1 宝塔面板部署 Django 项目
开发环境跑通后,部署上线是另一个大坑。我用宝塔面板部署过多个 Django 项目,可以给你一套成熟的路径。
第一步,准备服务器环境。在宝塔面板里安装 Python 3.8+、Nginx,以及 MySQL 或 SQLite 的运行时。宝塔的“Python 项目管理器”可以直接创建 Python 项目,选择 Python 版本后自动创建虚拟环境。
第二步,把项目代码上传到服务器,安装依赖:
bash复制pip install -r requirements.txt
python manage.py collectstatic
python manage.py migrate
这里特别提醒:collectstatic 必须执行,并且 settings.py 里要正确配置 STATIC_ROOT,否则 Django Admin 的样式文件会全部 404,后台管理页面会变成光秃秃的纯 HTML。
第三步,配置 WSGI。Django 项目用 gunicorn 作为生产服务器,宝塔里可以在 Python 项目管理器里直接配置启动命令:
bash复制gunicorn core.wsgi:application --bind 0.0.0.0:8000 --workers 2 --timeout 60
workers 的数量一般设置为 CPU 核心数×2+1,比如 2 核 CPU 就用 5 个 worker,不过对支教管理系统这个访问量级别,2 个 worker 完全够跑。
第四步,在 Nginx 里配置反向代理:
nginx复制server {
listen 80;
server_name your-domain.com;
location /static/ {
alias /www/wwwroot/your_project/static/;
}
location / {
proxy_pass http://127.0.0.1:8000;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}
}
这个配置最核心的是 proxy_pass 指向 gunicorn 监听的端口,以及 location /static/ 指向 collectstatic 收集的静态文件目录。如果静态文件配置不对,打开 Django Admin 时所有 CSS 都会丢失。
5.2 小程序上线前的必要检查
小程序上线前,有几个环节是很多开发者容易漏掉的:
第一,request 合法域名必须配 HTTPS。小程序请求的接口地址必须是 HTTPS 域名,不能用 IP,不能有端口号(默认 443 可以),而且域名必须已经完成 ICP 备案。你需要在微信公众平台的小程序后台,进入“开发管理”->“开发设置”->“服务器域名”,把接口域名加到 request 合法域名列表里。
第二,注册和登录的开放能力。如果小程序里需要获取用户的手机号,这个能力需要企业主体的小程序才能申请,个人主体小程序无法调用 getPhoneNumber。支教系统的学生身份如果依赖手机号绑定,个人开发者要谨慎设计认证逻辑。
第三,真机测试与模拟器的差异。开发工具模拟器里的表现不能 100% 代表真机,特别是网络请求的 TLS 版本、定位授权、相册权限这些。建议在提审前用预览版在至少两台不同品牌手机上跑一遍核心流程。
5.3 上线前要不要做压力测试
小程序压力测试这个话题,我的答案是:分阶段看。
如果你这个支教系统只是校内社团用,并发量可能就几十人,压力测试不是必须的。用 locust 或者 wrk 简单压一下接口,确认系统在 100 并发以下不崩,就够了。如果你的系统要面向全校几千人同时报名,那压力测试必须做,而且要重点压“报名接口”和“课程列表接口”。
我用一个简单的 locust 脚本压过这种系统:
python复制from locust import HttpUser, task, between
class TeachingSystemUser(HttpUser):
wait_time = between(1, 3)
@task(3)
def get_projects(self):
self.client.get('/api/projects')
@task(1)
def apply_project(self):
self.client.post('/api/apply', json={
'project_id': 1,
'motivation': '测试报名'
})
压测的结果重点是看两个指标:接口的 P95 响应时间 和错误率。如果 P95 响应时间超过 1 秒,就要考虑加数据库索引、加缓存或者升级服务器配置。对 Django 后端来说,最简单的抗压手段是给查询频繁且数据变更不频繁的接口加缓存:
python复制from django.core.cache import cache
from django.views.decorators.cache import cache_page
@cache_page(60 * 15)
def project_list(request):
# ...
cache_page 可以把整个列表页缓存 15 分钟,对报名高峰期的接口压力能显著缓解。缓存过期后需要接受请求回源,所以有一个权衡:希望数据实时性高,就不适合长缓存。
5.4 常见问题速查表
我把支教系统开发中遇到的高频问题整理成一个速查表,方便你排查:
| 报错/现象 | 可能原因 | 解决方案 |
|---|---|---|
| 小程序请求接口提示“url not in domain list” | 后端域名未配置到 request 合法域名 | 在小程序后台添加合法域名(需 HTTPS 且已备案) |
wx.login 的 code 换取 openid 失败:invalid code |
code 只能使用一次,或已过期(5 分钟有效) | 重新调用 wx.login 获取新 code |
获取用户手机号报错:invalid errmsg |
个人主体小程序无权限调用 getPhoneNumber | 改用“手动输入手机号”或升级认证主体 |
| Django Admin 页面无样式 | STATIC_ROOT 未配置或 collectstatic 未执行 |
配置 STATIC_ROOT 后执行 python manage.py collectstatic |
| 前端显示 Emoji 变成问号 | 数据库字符集不是 utf8mb4 | 修改 MySQL 表和字段字符集为 utf8mb4 |
| 项目列表接口响应慢 | N+1 查询或缺少索引 | 使用 select_related / prefetch_related / annotate 优化 |
| 用户重复点击报名按钮,生成了两条记录 | 后端缺少唯一性约束 | 在模型中加 unique_together = ('project', 'student') |
| 发送订阅消息报“用户拒绝接受消息” | 用户没有订阅或订阅次数已耗尽 | 在关键操作完成后主动引导用户订阅 |
| 上线后小程序打开白屏 | 接口域名未配置、HTTPS 证书异常或服务未启动 | 逐项检查 request 域名、SSL 证书、gunicorn 进程状态 |
| 图片上传失败 | 小程序上传域名未配置 | 在后台把域名添加到 uploadFile 合法域名 |
5.5 开发环境的调试妙招
开发阶段建议在 settings.py 里加一个环境判断,开发时打开日志到控制台:
python复制LOGGING = {
'version': 1,
'disable_existing_loggers': False,
'handlers': {
'console': {
'class': 'logging.StreamHandler',
},
},
'root': {
'handlers': ['console'],
'level': 'DEBUG',
},
}
这样在本地跑 runserver 时,每次请求都会在终端打印出 SQL 语句和请求信息,方便排查 ORM 查询问题。Django 的 connection.queries 里也保存了当前请求执行的所有 SQL,配合 Debug Toolbar 简直不要太舒服。
另外,小程序开发者在调试接口时,可以用微信开发者工具里的“不校验合法域名”开关,避免部署域名还没配置好时反复在手机上测试。但注意这只是本地调试用的,真机预览或提审时必须关闭。
最后分享一个我的个人经验
支教管理系统这个项目做完之后,最大的收获不是因为用了 Django 和小程序这两个技术栈,而是明白了“简单业务也要有复用的思维”。支教系统的核心实体就是“项目—报名—课程—反馈”这条线,很多校内管理系统都能抽象出类似的结构。你把它做透了,下一套社团活动管理系统、志愿服务活动管理系统,改改模型和字段基本就能跑起来。
开发的过程中,我最深的感受是:不要让“看起来简单”的业务骗了你。报名审核、课表安排、状态流转,每个环节都有边界情况要处理。多花时间画清楚业务流程图、理清状态机,比急着写代码更重要。后端 Django 的成熟稳定,加上小程序端的分发便捷,是这类校园管理系统的绝佳组合,也特别适合作为新手完整掌握前后端全栈开发的练手项目。
