1. 项目概述在线教育平台后端开发是一个典型的Web应用场景Django作为Python生态中最成熟的全栈Web框架其自带的管理后台、ORM系统和安全机制特别适合快速构建教育类平台。我在过去三年中参与过三个不同规模在线教育系统的开发发现用Django实现后端API既能保证开发效率又能满足教育业务特有的复杂数据关系处理需求。这个项目将展示如何用Django REST framework构建完整的在线教育API体系包含课程管理、用户权限、支付对接等核心模块。不同于简单CRUD示例我会重点分享教育业务中特有的技术难点解决方案比如课程章节树形结构存储、视频播放权限校验、学习进度跟踪等实际开发经验。2. 技术选型与架构设计2.1 为什么选择Django教育平台后端需要处理几种典型场景结构化数据存储课程、章节、用户信息复杂业务逻辑购买流程、权限控制高安全性要求支付、用户数据Django的优势在于ORM系统能优雅处理课程→章节→知识点这种多层嵌套关系自带Admin后台适合快速搭建内容管理系统Auth权限系统开箱即用配合DRF可快速实现JWT认证完善的中间件机制便于实现全局功能如访问日志、限流等2.2 数据库设计要点教育平台核心表结构示例class Course(models.Model): title models.CharField(max_length200) teacher models.ForeignKey(User, on_deletemodels.CASCADE) price models.DecimalField(max_digits10, decimal_places2) cover_img models.ImageField(upload_tocovers/) # 其他字段... class Chapter(models.Model): course models.ForeignKey(Course, on_deletemodels.CASCADE, related_namechapters) title models.CharField(max_length100) order models.PositiveIntegerField() # 用于排序 # 使用MPTT实现树形结构 parent TreeForeignKey(self, on_deletemodels.CASCADE, nullTrue, blankTrue) class Enrollment(models.Model): user models.ForeignKey(User, on_deletemodels.CASCADE) course models.ForeignKey(Course, on_deletemodels.CASCADE) purchase_date models.DateTimeField(auto_now_addTrue) # 学习进度状态字段...特别要注意使用django-mptt处理课程章节的无限级嵌套为常用查询字段添加db_index如enrollment表的user和course大文本字段如课程详情建议单独建表3. 核心接口开发实战3.1 课程列表API优化教育平台的核心接口需要考虑分页性能千万级课程数据复杂过滤条件按价格、评分、分类等搜索结果高亮DRF视图示例class CourseListView(ListAPIView): serializer_class CourseListSerializer filter_backends [DjangoFilterBackend, SearchFilter] filterset_fields [category, difficulty] search_fields [title, teacher__name] def get_queryset(self): queryset Course.objects.select_related(teacher)\ .prefetch_related(tags)\ .filter(is_publishedTrue) # 添加自定义过滤逻辑 if min_price : self.request.query_params.get(min_price): queryset queryset.filter(price__gtemin_price) return queryset # 使用缓存装饰器减少数据库压力 method_decorator(cache_page(60*5)) def list(self, request, *args, **kwargs): return super().list(request, *args, **kwargs)性能优化技巧使用select_related/prefetch_related避免N1查询对稳定数据添加缓存层为列表接口编写专用Serializer不同于详情接口3.2 视频播放权限校验教育平台最关键的权限控制场景用户必须购买课程视频必须在有效期内同时观看设备数限制实现方案class VideoView(APIView): permission_classes [IsAuthenticated] def get(self, request, video_id): video get_object_or_404(Video, pkvideo_id) course video.chapter.course # 检查购买状态 if not Enrollment.objects.filter( userrequest.user, coursecourse, is_activeTrue ).exists(): raise PermissionDenied(请先购买课程) # 检查设备数 cache_key fuser_{request.user.id}_devices current_devices cache.get(cache_key, []) if request.META[REMOTE_ADDR] not in current_devices: if len(current_devices) MAX_DEVICES: raise PermissionDenied(设备数已达上限) current_devices.append(request.META[REMOTE_ADDR]) cache.set(cache_key, current_devices, TIMEOUT) # 返回视频播放地址带时效签名 signed_url generate_signed_url(video.file.path) return Response({url: signed_url})安全注意事项视频URL必须使用时效签名如AWS S3 Presigned URL敏感操作记录审计日志使用速率限制防止盗链4. 支付系统对接4.1 支付流程设计教育平台典型支付场景用户发起支付请求生成平台订单跳转支付网关异步通知处理关键代码实现class PaymentView(APIView): def post(self, request): serializer PaymentSerializer(datarequest.data) serializer.is_valid(raise_exceptionTrue) # 创建订单 order Order.objects.create( userrequest.user, courseserializer.validated_data[course], amountserializer.validated_data[course].price, statuspending ) # 调用支付网关 payment_data { order_id: order.order_no, amount: float(order.amount), return_url: settings.PAYMENT_RETURN_URL } result PaymentGateway.create_payment(payment_data) # 记录支付会话 PaymentSession.objects.create( orderorder, gateway_idresult[transaction_id], payment_urlresult[payment_url] ) return Response({payment_url: result[payment_url]}) csrf_exempt def payment_callback(request): # 验证签名 if not verify_signature(request.POST): return HttpResponseBadRequest() # 更新订单状态 order Order.objects.get(order_norequest.POST[order_id]) order.status completed if request.POST[status] success else failed order.save() # 如果支付成功创建选课记录 if order.status completed: Enrollment.objects.get_or_create( userorder.user, courseorder.course, defaults{is_active: True} ) return HttpResponse(OK)支付系统注意事项订单号使用UUID避免可预测金额比较使用Decimal而非Float异步通知必须验证签名和幂等处理关键状态变更记录操作日志5. 部署与性能优化5.1 生产环境部署推荐部署方案Nginx静态文件/负载均衡 ↑ Gunicorn/UvicornASGI支持 ↑ Django启用生产配置 ↑ PostgreSQL主从复制 ↑ Redis缓存/消息队列关键配置示例# settings/prod.py DEBUG False ALLOWED_HOSTS [yourdomain.com] DATABASES { default: { ENGINE: django.db.backends.postgresql, HOST: os.getenv(DB_HOST), NAME: os.getenv(DB_NAME), USER: os.getenv(DB_USER), PASSWORD: os.getenv(DB_PASSWORD), CONN_MAX_AGE: 600, # 连接池 } } # 使用Redis作为缓存 CACHES { default: { BACKEND: django_redis.cache.RedisCache, LOCATION: redis://redis:6379/1, OPTIONS: { CLIENT_CLASS: django_redis.client.DefaultClient, } } }5.2 性能优化技巧数据库层面为常用查询添加索引使用annotate替代多个查询定期执行VACUUM ANALYZE缓存策略课程详情使用TemplateFragment缓存列表接口使用Page缓存用户权限数据使用对象缓存异步任务使用Celery处理视频转码邮件通知数据统计报表# tasks.py app.task def process_video_upload(video_id): video Video.objects.get(pkvideo_id) input_path video.original_file.path output_path generate_output_path() # 使用FFmpeg转码 subprocess.run([ ffmpeg, -i, input_path, -c:v, libx264, -preset, fast, -crf, 22, -c:a, aac, -b:a, 128k, output_path ]) # 更新视频记录 video.processed_file output_path video.status processed video.save()6. 常见问题与解决方案6.1 性能瓶颈排查典型问题1课程列表接口响应慢检查是否缺少select_related使用django-debug-toolbar分析SQL考虑添加缓存层典型问题2视频播放卡顿检查CDN配置实现分段加载Range Request转码为多种分辨率1080p/720p/480p6.2 安全防护措施SQL注入防护永远使用ORM或参数化查询定期进行安全扫描XSS防护模板中自动转义富文本内容使用bleach清洗CSRF防护确保所有修改操作都要求CSRF token敏感操作要求二次验证6.3 监控与日志推荐监控指标接口响应时间P99数据库查询耗时错误率5xx状态码日志配置示例LOGGING { version: 1, handlers: { file: { level: INFO, class: logging.handlers.TimedRotatingFileHandler, filename: /var/log/django/app.log, when: midnight, }, }, loggers: { django: { handlers: [file], level: INFO, }, }, }在实际项目中我们会为关键业务操作添加详细日志import logging logger logging.getLogger(__name__) class EnrollmentView(APIView): def post(self, request): try: # ...注册逻辑... logger.info( fUser {request.user.id} enrolled course {course_id}, extra{user: request.user.id, course: course_id} ) except Exception as e: logger.error( fEnrollment failed: {str(e)}, exc_infoTrue, extra{request: request} ) raise