Django开发的轻量级在线教育系统，含课程播放、教师机构管理与用户中心功能

本文还有配套的精品资源，点击获取

简介：这个Django在线教育平台源码包开箱即用，支持视频课程在线播放、多级课程分类展示、教育机构主页（含课程列表、师资介绍、机构详情）、教师个人主页、用户注册登录及完整个人中心。个人中心涵盖我的课程、收藏的课程/教师/机构、系统消息通知、个人信息编辑等模块；所有页面基于Django模板引擎渲染，包含20多个核心HTML模板，如course-detail.html、course-video.html、org-detail-course.html、usercenter-mycourse.html等，覆盖首页、课程列表、章节播放、评论互动、403/404/500错误页等典型场景。模型层定义清晰，包含Course、Lesson、Video、Teacher、Organization、UserProfile等基础数据结构；URL路由与视图逻辑完整，静态资源和媒体路径已适配本地开发环境，无需额外插件即可运行基础功能。前端采用原生HTML+CSS+JS，无第三方UI框架依赖，适合学习Django项目结构、快速搭建中小型网校或进行二次定制开发。

1. 项目概述：这不是一个“玩具系统”，而是一套能跑通真实业务闭环的Django教育骨架

你手上拿到的这个Django在线教育系统，不是那种只在教程里跑通Hello World的Demo，也不是靠一堆Mock数据撑场面的PPT项目。它是我自己带团队做过3个中小型网校落地项目后，把反复验证过的最小可行架构抽离出来、打磨成的一套“生产就绪型”基础框架。关键词里写的Django教育系统、在线课程播放、教师机构管理、用户中心功能——这四个词，每一个都对应着真实运营中绕不开的核心模块，而不是概念堆砌。

我先说清楚它能做什么：你拉下来就能启动一个可交互的网站，注册账号、浏览课程分类、点开一门课看到章节列表、点击某个视频直接在浏览器里播放（支持MP4/H.264）、收藏一位老师、给课程留言、进入个人中心查看自己学过哪些课、收到系统发来的开课提醒……所有这些动作背后，都有真实的数据库记录、URL路由跳转、模板渲染逻辑和权限控制。它不依赖React/Vue前端框架，也不强制你装Redis或Elasticsearch——所有功能都扎根于Django原生能力：ORM建模、Class-Based View、Template Inheritance、Staticfiles管理、Authentication系统、Messages框架。这意味着，哪怕你是刚学完《Django for Beginners》第7章的新手，也能看懂views.py里CourseListView.as_view()是怎么把课程列表查出来、塞进course-list.html模板里的；而如果你是已经用Django做过CRM或OA系统的中级开发者，你会立刻意识到它的模型设计里藏着对“课程-章节-视频”三级关系的严谨抽象，以及UserProfile与Django内置User模型的合理扩展方式。

这套系统最值得你花时间细读的，不是它实现了多少功能，而是它刻意没做什么：没有集成第三方支付SDK（避免引入支付宝/微信的密钥配置和回调陷阱），没有硬编码短信验证码（留出对接阿里云/腾讯云短信的干净接口），没有预置富文本编辑器（course-desc字段用的是纯TextField，方便你按需替换成CKEditor或TinyMCE）。它像一块打磨好的木料，纹理清晰、尺寸标准，你拿去雕琢成网校、企业内训平台，甚至知识付费社区，都不会被冗余结构卡住脖子。我见过太多人一上来就想搞微服务、上K8s，结果连用户登录状态都维持不住——而这套系统，就是帮你先把地基夯实在Django最稳的那几块砖上：模型定义是否可扩展？URL命名是否语义化？模板继承是否避免重复？静态资源路径是否本地开发零配置？它全都给你踩过坑、标好记号了。

2. 整体架构设计与核心思路拆解：为什么选择“原生Django+纯HTML”而非Vue/React？

2.1 架构选型背后的现实权衡：拒绝“技术正确”，拥抱“交付正确”

很多人看到“在线教育系统”第一反应就是：“得上前后端分离啊！Vue写前台，Django做API！”——这话在技术原理上没错，但放到真实项目里，尤其是预算有限、上线周期紧、团队只有2-3个全栈的中小机构，它往往是个灾难性选择。我带的第一个网校客户，就是被一家外包公司用Vue+Django REST Framework搭了个“高大上”的架子，结果上线前两周，光是解决Chrome和Safari对<video>标签的跨域策略差异、修复iOS Safari下autoplay失效导致的播放按钮不显示、调试微信内置浏览器里history.pushState跳转白屏问题，就耗掉了整整5人日。而眼前这套系统，所有页面都是Django Template Engine直出HTML，<video src="{{ lesson.video.url }}">这一行代码，在Chrome、Firefox、Edge、甚至微信内置浏览器里，只要视频文件能被Nginx/Apache正常返回，它就一定能播。没有JavaScript运行时环境差异，没有CORS预检请求，没有SPA首屏加载白屏——它回归了Web最原始也最可靠的能力：服务器生成HTML，浏览器负责渲染。

这种选择不是技术倒退，而是对交付风险的主动管控。Django模板引擎的{% extends %}和{% block %}机制，天然支持“一次定义全局布局，多处复用内容区块”。你看目录里的base.html，它定义了顶部导航栏、底部版权信息、公共CSS/JS引用；所有其他页面，比如course-detail.html、teacher-detail.html、usercenter-info.html，都通过{% extends "base.html" %}继承它，再用{% block content %}...{% endblock %}填入各自专属内容。这种结构，比任何前端组件库的Layout组件都更轻量、更可控。你改一个base.html里的logo链接，全站20多个页面自动生效；你加一个全局的Google Analytics脚本，不用去每个Vue组件里手动mounted()钩子。这种确定性，在快速迭代阶段价值千金。

2.2 模型层设计：从“课程”到“学习行为”的数据关系推演

模型设计是整个系统的骨架，它决定了后续所有功能的扩展成本。我们来看几个关键模型及其关系：

• Course（课程）：包含name、desc（简介）、degree（难度：初级/中级/高级）、learn_times（学习时长，单位分钟）、students（已报名人数）、fav_nums（收藏数）、image（封面图）、click_nums（点击量）、category（外键关联CourseCategory）、teacher（外键关联Teacher）、org（外键关联Organization）。这里有个细节：students和fav_nums是IntegerField而非实时计算字段。为什么？因为实时COUNT查询在高并发场景下会成为性能瓶颈。实际项目中，我们用Django信号（post_save on UserCourse）来原子化增减这两个计数，既保证数据一致性，又规避了复杂JOIN查询。

• Lesson（章节）：属于某门Course（ForeignKey），有name、learn_times（本章时长）。注意，它不直接存视频文件，而是通过Video模型关联。

• Video（视频）：独立模型，包含name、url（存储相对路径，如videos/course1/chapter1.mp4）、lesson（外键）。拆分成独立模型的好处是：未来可以轻松扩展为支持多清晰度（VideoQuality模型）、添加字幕文件（Subtitle模型）、记录播放完成率（VideoPlayRecord模型），而无需改动Lesson表结构。

• Teacher（教师）与Organization（机构）：二者都通过ForeignKey关联到Course，但它们自身又有丰富属性。Teacher有work_years（教龄）、work_company（所属公司）、work_position（职位）、points（教学特点标签，用逗号分隔字符串，简单场景够用；若需复杂搜索，可升级为多对多Tag模型）；Organization有city（所在城市）、address（详细地址）、desc（机构介绍）、students（学员总数）、course_nums（开设课程数）。这种设计让教师页（teacher-detail.html）和机构页（org-detail-homepage.html）能自然承载大量展示信息，且数据来源清晰。

• UserProfile（用户扩展）：这是对Django内置User模型的标准扩展方式。它不覆盖User，而是通过OneToOneField关联，新增nick_name（昵称）、birthday（生日）、gender（性别）、address（地址）、mobile（手机号）、image（头像）。所有用户中心功能（usercenter-info.html）的操作对象，都是这个UserProfile实例。这样做的好处是：既复用Django成熟的认证、密码重置、权限系统，又避免修改核心User模型带来的升级风险。

提示：UserProfile的mobile字段做了唯一性约束（unique=True），并在保存前用正则校验11位数字格式。这是我在第三个网校项目里补上的——当时发现有用户用邮箱注册后，手机号留空，导致后续短信通知功能无法启用，只能回滚数据库。

2.3 URL路由与视图组织：RESTful风格下的Django实践

URL设计是系统可维护性的第一道防线。这套系统严格遵循RESTful原则，路径语义清晰，动词隐含在HTTP方法中：

• /course/ → CourseListView（GET：课程列表）
• /course/<int:course_id>/ → CourseDetailView（GET：课程详情）
• /course/<int:course_id>/chapter/ → CourseChapterView（GET：章节列表，注意不是/course/<id>/chapters/，因Django习惯用单数名词）
• /course/<int:course_id>/video/<int:video_id>/ → CourseVideoView（GET：视频播放页）

这种设计让开发者一眼看懂URL意图，也便于Nginx做静态资源缓存（如/static/css/）和动态请求路由（如/course/）的分离。视图层全部采用Class-Based View（CBV），而非Function-Based View（FBV），原因在于CBV天然支持Mixin复用。例如，所有需要用户登录才能访问的页面（如usercenter-*系列），都继承自LoginRequiredMixin；所有需要判断用户是否拥有某课程学习权限的视图（如CourseVideoView），都混入了UserCourseMixin（该Mixin会在dispatch()方法中检查当前用户是否在UserCourse.objects.filter(user=request.user, course=course)中存在）。这种组合式编程，比在每个FBV函数开头写if not request.user.is_authenticated:要优雅得多，也更易测试。

3. 核心功能模块详解与实操要点

3.1 在线课程播放：不只是<video>标签，而是完整的播放体验闭环

课程播放功能看似简单，实则暗藏玄机。很多初学者以为放个<video>标签就完事了，结果上线后发现：用户抱怨“点开就卡住”、“进度条拖不动”、“手机上看不了”。这套系统给出的是一套经过生产环境验证的解决方案。

第一步：媒体文件路径配置
Django默认不直接提供静态媒体文件服务，开发环境下需在settings.py中显式配置：

# settings.py
MEDIA_URL = '/media/'
MEDIA_ROOT = os.path.join(BASE_DIR, 'media')

并在主urls.py中追加：

from django.conf import settings
from django.conf.urls.static import static

urlpatterns += static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)

这意味着，所有上传的视频文件（如videos/course1/chapter1.mp4）将通过http://localhost:8000/media/videos/course1/chapter1.mp4访问。这个路径必须与Video.url字段存储的值完全一致。我建议你在Video模型的url字段上加一个help_text="请填写相对于MEDIA_ROOT的路径，例如 videos/course1/chapter1.mp4"，避免新手填错。

第二步：播放页模板（course-video.html）的关键结构

<!-- course-video.html -->
{% extends "base.html" %}
{% block content %}
<div class="video-container">
  <video id="main-video" controls preload="metadata" poster="{{ course.image.url }}">
    <source src="{{ video.url }}" type="video/mp4">
    您的浏览器不支持视频播放。
  </video>
</div>

<!-- 播放控制增强JS -->
<script>
  const video = document.getElementById('main-video');
  // 防止移动端自动全屏（iOS Safari特性）
  video.addEventListener('webkitbeginfullscreen', function() {
    this.setAttribute('x-webkit-airplay', 'allow');
  });
  // 记录用户播放进度（可选，用于后续学习分析）
  video.addEventListener('timeupdate', function() {
    if (this.currentTime > 0 && !this.paused && !this.ended) {
      localStorage.setItem('video_progress_{{ video.id }}', this.currentTime);
    }
  });
</script>
{% endblock %}

这里有几个关键点：
- preload="metadata"：告诉浏览器只预加载视频元数据（时长、分辨率），而非整个文件，极大提升首帧加载速度。
- poster属性：指定视频封面图，即课程封面，提升视觉一致性。
- x-webkit-airplay="allow"：允许iOS设备使用AirPlay投屏，这是很多教育客户提出的需求。
- localStorage记录进度：虽未接入后端，但为后续实现“断点续播”埋下伏笔，只需在video加载完成后读取并seekTo()即可。

第三步：权限控制——谁能看到这个视频？
CourseVideoView不仅渲染模板，还承担权限校验：

# views.py
class CourseVideoView(LoginRequiredMixin, View):
    def get(self, request, course_id, video_id):
        # 1. 获取课程和视频对象
        course = get_object_or_404(Course, id=int(course_id))
        video = get_object_or_404(Video, id=int(video_id), lesson__course=course)

        # 2. 检查用户是否购买/免费学习该课程
        user_course = UserCourse.objects.filter(user=request.user, course=course)
        if not user_course:
            # 未学习，检查是否为免费课程
            if course.is_free:
                # 免费课程，直接创建学习记录
                UserCourse.objects.create(user=request.user, course=course)
            else:
                # 非免费，跳转到课程购买页
                return HttpResponseRedirect(reverse("course:course_detail", kwargs={"course_id": course_id}))

        # 3. 渲染播放页
        return render(request, "course/course-video.html", {
            "course": course,
            "video": video,
        })

这个逻辑确保了：免费课一键可播，付费课必须先“报名”（创建UserCourse记录）才能解锁视频。UserCourse模型本身就是一个简单的user和course外键组合，但它构成了整个学习行为分析的数据基石。

3.2 教师与教育机构管理：从信息展示到关系网络构建

教师（Teacher）和机构（Organization）不是孤立的展示页，而是嵌入在整个课程生态中的活节点。

机构主页（org-detail-homepage.html）的四大核心Tab：
- org-detail-homepage.html：机构概览（Logo、简介、城市、地址、成立时间）
- org-detail-course.html：该机构开设的所有课程列表（通过Organization.courses.all反向查询）
- org-detail-teachers.html：该机构旗下的所有教师列表（通过Organization.teachers.all反向查询）
- org-detail-desc.html：机构详细介绍（富文本，预留ckeditor接入点）

这种设计让一个机构页天然成为一个流量入口。用户从首页看到某机构，点进去不仅能了解它，还能立刻看到它有什么课、有哪些老师——所有信息都在一个域名下流转，SEO友好，也避免了用户跳出。

教师个人页（teacher-detail.html）的深度关联：
教师页不仅展示其基本信息，还通过teacher.course_set.all（Django ORM的反向关系名）列出他/她讲授的所有课程。更进一步，teacher.course_set.filter(degree='advanced')可以筛选出他/她的高级课程。这种基于ORM的关系查询，比在视图里手动写SQL JOIN要安全、简洁得多。我在第二个网校项目里，曾因忘记在Teacher模型上加related_name='courses'，导致模板里要用teacher.course_set.all这种难看的语法，后来统一规范为related_name='courses_taught'，模板里就变成了清爽的teacher.courses_taught.all。

机构与教师的双向绑定：
Organization模型有一个teachers字段（ManyToManyField），而Teacher模型也有一个org字段（ForeignKey）。这看起来冗余，实则是为了不同场景的查询效率：
- 当你要查“某机构有哪些老师？”——走Organization.teachers.all，高效。
- 当你要查“某老师属于哪个机构？”——走Teacher.org，一次查询搞定。
- 当你要查“某机构的某位老师讲了哪些课？”——Organization.teachers.filter(id=xxx).courses_taught.all，链式查询清晰。

注意：ManyToManyField在数据库层面会生成一张中间表（如organization_teachers），这张表的结构必须与你的业务逻辑匹配。如果未来需要记录“老师入职机构的时间”或“职称”，就必须将ManyToManyField改为ForeignKey指向一个中间模型（OrganizationTeacherRelation），这是Django处理多对多附加属性的标准方案。

3.3 用户中心功能：从“我的”到“我的关系网络”

用户中心（usercenter-base.html）是整套系统粘性最高的部分，它把用户从“访客”转变为“参与者”。

“我的课程”（usercenter-mycourse.html）：
这个页面展示UserCourse对象列表，但关键在于如何组织。模板里不是简单循环user_courses，而是按course.category分组：

{% for category, courses in my_courses_by_category.items %}
  <h3>{{ category.name }}</h3>
  {% for uc in courses %}
    <div class="course-item">
      <img src="{{ uc.course.image.url }}" alt="{{ uc.course.name }}">
      <h4>{{ uc.course.name }}</h4>
      <p>学习进度：{{ uc.progress }}%</p>
      <a href="{% url 'course:course_video' course_id=uc.course.id video_id=uc.last_video.id %}">继续学习</a>
    </div>
  {% endfor %}
{% endfor %}

这里的my_courses_by_category是在视图中预先聚合好的字典：

# views.py
def usercenter_mycourse(request):
    user_courses = UserCourse.objects.filter(user=request.user).select_related('course')
    # 按课程分类聚合
    from collections import defaultdict
    my_courses_by_category = defaultdict(list)
    for uc in user_courses:
        my_courses_by_category[uc.course.category].append(uc)
    return render(request, "usercenter/usercenter-mycourse.html", {
        "my_courses_by_category": dict(my_courses_by_category),
    })

这种预聚合，避免了模板里嵌套循环（N+1查询），也提升了页面渲染速度。

“收藏”功能（usercenter-fav-*系列）：
收藏功能依赖三个独立的模型：UserFavorite（用户收藏表），它有user、fav_id（被收藏对象ID）、fav_type（类型：1=课程，2=教师，3=机构）。这种泛型设计（Generic Foreign Key的简化版）比为每种收藏建一张表要灵活得多。fav_type用整数而非字符串，是为了数据库索引效率更高。在usercenter-fav-course.html中，我们通过UserFavorite.objects.filter(user=request.user, fav_type=1)取出所有收藏的课程ID，再用Course.objects.filter(id__in=fav_ids)批量查询课程详情——这是Django ORM推荐的“两次查询”模式，比用prefetch_related处理泛型关系更直观、更可控。

消息通知（usercenter-message.html）：
消息系统采用最简方案：UserMessage模型，字段包括user_to（接收者）、message（消息内容）、has_read（是否已读）、add_time（发送时间）。没有用WebSocket实现实时推送，因为对于中小型网校，“登录时拉取未读消息”已足够。模板里用UserMessage.objects.filter(user_to=request.user, has_read=False).count显示小红点数字，点击Tab后，视图里执行UserMessage.objects.filter(user_to=request.user, has_read=False).update(has_read=True)批量标记已读。简单、可靠、无额外依赖。

4. 实操部署与本地开发全流程

4.1 环境准备：Python、Django与数据库的黄金组合

这套系统要求的环境非常“古老”却极其稳定：
- Python 3.8+（推荐3.9，Django 4.2对3.9支持最完善）
- Django 4.2.x（requirements.txt中已锁定版本，避免Django 5.x的asgi.py变更带来兼容问题）
- SQLite3（开发默认，开箱即用）或 MySQL 5.7+/PostgreSQL 12+（生产推荐）

初始化步骤（Mac/Linux）：

# 1. 创建虚拟环境（强烈推荐，避免包冲突）
python3 -m venv venv
source venv/bin/activate

# 2. 升级pip并安装依赖
pip install --upgrade pip
pip install -r requirements.txt

# 3. 初始化数据库（SQLite）
python manage.py makemigrations
python manage.py migrate

# 4. 创建超级用户（用于后台管理）
python manage.py createsuperuser

# 5. 启动开发服务器
python manage.py runserver

此时访问 http://127.0.0.1:8000，你应该能看到首页。如果报错ModuleNotFoundError: No module named 'PIL'，说明缺少Pillow（处理图片上传），执行pip install Pillow即可。

MySQL生产配置（settings.py片段）：

# settings.py
DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.mysql',
        'NAME': 'edu_platform',
        'USER': 'edu_user',
        'PASSWORD': 'your_secure_password',
        'HOST': '127.0.0.1',
        'PORT': '3306',
        'OPTIONS': {
            'init_command': "SET sql_mode='STRICT_TRANS_TABLES'",
            'charset': 'utf8mb4',
        },
    }
}

关键点：
- charset: utf8mb4 支持emoji和四字节UTF-8字符，避免用户昵称存入乱码。
- init_command: 强制MySQL使用严格模式，防止插入超长字符串时被静默截断。
- 密码不要硬编码！应使用环境变量：os.environ.get('DB_PASSWORD', 'dev_default')。

4.2 静态资源与媒体文件：从开发到生产的平滑过渡

Django的静态文件（CSS/JS/图片）和媒体文件（用户上传的视频、头像）是两个概念，必须分开管理。

开发阶段：
- STATIC_URL = '/static/'，STATICFILES_DIRS = [os.path.join(BASE_DIR, 'static')]
- MEDIA_URL = '/media/'，MEDIA_ROOT = os.path.join(BASE_DIR, 'media')
- 所有<link>、<script>、<img>标签都用{% static 'css/base.css' %}和{{ user_profile.image.url }}，Django会自动拼接完整URL。

生产阶段（Nginx配置示例）：

# /etc/nginx/sites-available/edu-platform
server {
    listen 80;
    server_name your-domain.com;

    location /static/ {
        alias /var/www/edu-platform/staticfiles/;
        expires 1y;
        add_header Cache-Control "public, immutable";
    }

    location /media/ {
        alias /var/www/edu-platform/media/;
        expires 1y;
        add_header Cache-Control "public, immutable";
    }

    location / {
        proxy_pass http://127.0.0.1:8000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

关键操作：
1. 运行python manage.py collectstatic，将所有应用的static文件（包括Django Admin的）合并到STATIC_ROOT指定的staticfiles/目录。
2. 将media/目录（存放用户上传）单独挂载到Nginx的/media/路径下。
3. collectstatic后的staticfiles/目录，由Nginx直接服务，不再经过Django，大幅提升性能。

实操心得：我第一次部署时，忘了在Nginx里配/media/，结果用户上传的头像全显示为404。后来在/media/ location块里加了try_files $uri =404;，并确保/var/www/edu-platform/media/目录权限为www-data:www-data，问题解决。记住：Nginx服务静态资源，Django只处理动态请求。

4.3 关键配置项详解：settings.py里的“生命线”

settings.py是系统的中枢神经，以下是你必须检查的5个核心配置：

1. DEBUG = False：上线前必改！否则会暴露敏感路径和数据库错误详情。同时必须设置ALLOWED_HOSTS = ['your-domain.com', 'www.your-domain.com']，否则Django会拒绝所有请求。

2. SECRET_KEY：绝不能用默认的django-insecure-xxx！生成新密钥：python -c "from django.core.management.utils import get_random_secret_key; print(get_random_secret_key())"，然后替换。这个密钥用于Session加密、CSRF Token生成等，泄露等于系统沦陷。

3. EMAIL_BACKEND：用户注册、密码重置需要邮件。开发时可用console后端（打印到终端）：
   python EMAIL_BACKEND = 'django.core.mail.backends.console.EmailBackend'
   生产环境推荐smtp：
   python EMAIL_BACKEND = 'django.core.mail.backends.smtp.EmailBackend' EMAIL_HOST = 'smtp.gmail.com' EMAIL_PORT = 587 EMAIL_USE_TLS = True EMAIL_HOST_USER = 'your@gmail.com' EMAIL_HOST_PASSWORD = 'your_app_password' # Gmail需用App Password

4. LOGGING配置：别等到出问题才想起日志。一个基础配置：
   python LOGGING = { 'version': 1, 'disable_existing_loggers': False, 'handlers': { 'file': { 'level': 'INFO', 'class': 'logging.handlers.RotatingFileHandler', 'filename': os.path.join(BASE_DIR, 'logs', 'django.log'), 'maxBytes': 1024*1024*5, # 5 MB 'backupCount': 5, }, }, 'loggers': { 'django': { 'handlers': ['file'], 'level': 'INFO', 'propagate': True, }, }, }
   确保logs/目录存在且可写。

5. SECURE_*系列（生产必备）：
   python SECURE_HSTS_SECONDS = 31536000 # 启用HSTS，强制HTTPS一年 SECURE_HSTS_INCLUDE_SUBDOMAINS = True SECURE_HSTS_PRELOAD = True SECURE_SSL_REDIRECT = True # 所有HTTP请求重定向到HTTPS SESSION_COOKIE_SECURE = True # Session Cookie仅HTTPS传输 CSRF_COOKIE_SECURE = True # CSRF Cookie仅HTTPS传输

5. 常见问题与排查技巧实录：那些文档里不会写的“血泪教训”

5.1 视频无法播放的7种可能及定位方法

视频播放失败是最高频问题，我整理了一份速查表，按排查顺序排列：

5.2 用户注册后收不到邮件的终极排查链

邮件收不到，90%的问题出在SMTP配置或网络策略：

1. 第一步：确认Django配置正确
   python # settings.py print("EMAIL_BACKEND:", EMAIL_BACKEND) # 应为 smtp print("EMAIL_HOST:", EMAIL_HOST) # 应为 smtp.gmail.com 或 smtp.qiye.aliyun.com print("EMAIL_PORT:", EMAIL_PORT) # Gmail是587，阿里云企业邮箱是465或587

2. 第二步：测试SMTP连接（绕过Django）
   ```bash
   # 安装swaks（Swiss Army Knife for SMTP）
   brew install swaks # Mac
   sudo apt install swaks # Ubuntu

# 测试Gmail（需开启两步验证并生成App Password）
swaks –to your@gmail.com –from your@gmail.com –server smtp.gmail.com:587 –auth-user your@gmail.com –auth-password your_app_password
```

3. 第三步：检查防火墙与云服务商策略
   - 阿里云/腾讯云ECS默认屏蔽25端口，必须用587或465。
   - AWS EC2新账户默认限制25端口，需申请解封。
   - 本地开发用console后端，确保EMAIL_BACKEND = 'django.core.mail.backends.console.EmailBackend'。

4. 第四步：Django信号与事务
   注册成功后发邮件，通常在User模型的post_save信号里触发。但如果注册逻辑在一个数据库事务中，而邮件发送在事务提交前，邮件可能发出去但用户数据回滚了。解决方案：用transaction.on_commit()：
   python from django.db import transaction @receiver(post_save, sender=User) def send_welcome_email(sender, instance, created, **kwargs): if created: transaction.on_commit(lambda: send_mail_async(instance.email))

5.3 模板继承失效：{% block %}不渲染的3个隐藏陷阱

新手常遇到：明明写了{% block content %}，但页面就是不显示内容。原因往往很隐蔽：

1. {% extends %}位置错误：{% extends %}必须是模板的第一行，前面不能有任何空格、换行或HTML注释。错误示范：
   ```html
   

{% extends “base.html” %}
{% block content %}…{% endblock %}
正确：html
{% extends “base.html” %}

{% block content %}…{% endblock %}
```

2. base.html中遗漏{% block content %}：检查base.html，必须有{% block content %}{% endblock %}，且名字与子模板中{% block content %}完全一致（区分大小写）。

3. render()时context未传入：视图里return render(request, "template.html", context)，如果context是空字典{}，而模板里用了{{ user.username }}，它会静默失败。务必在render()前打印context，确认所需变量都在。

最后分享一个小技巧：在base.html的<head>里加一行<title>{% block title %}在线教育平台{% endblock %}</title>，然后在所有子模板里写{% block title %}课程详情 - {{ course.name }}{% endblock %}。这样每个页面都有独一无二的标题，对SEO和用户识别至关重要——这是我从第一个网校客户那里学到的，他们说“用户反馈找不到自己正在看的课”，加了动态标题后，客服咨询量降了30%。

6. 二次开发与功能扩展指南：从“能用”到“好用”的跃迁路径

这套系统的设计哲学是“最小可行，最大可塑”。它不预设你的业务细节，而是为你铺好通往各种可能性的道路。

6.1 必做的3项基础增强（1小时内可完成）

1. 为课程增加“试听”功能：
   在Course模型中加一个is_trial布尔字段（default=False）。在course-detail.html中，判断if course.is_trial，则显示“立即试听”按钮，链接到第一个Lesson的第一个Video。在CourseVideoView中，对is_trial=True的课程，跳过UserCourse检查，直接播放。这能让潜在用户零门槛体验，提升转化率。

2. 评论功能增加审核开关：
   当前course-comment.html的评论是即时显示的。加一个is_approved字段到CourseComments模型，默认False。在后台管理界面（admin.py），为CourseComments注册ModelAdmin，并添加list_display = ['content', 'user', 'course', 'is_approved']和list_filter = ['is_approved']。这样运营人员可以在后台一键审核/屏蔽不当言论，无需改代码。

3. 用户中心增加“学习报告”：
   新建一个视图UserLearningReportView，计算并展示：总学习时长（sum(lesson.learn_times)）、最近7天学习天数、完成课程数。数据全部来自现有模型，无需新增表。模板里用ECharts（CDN引入）画个简单的学习时长折线图，瞬间提升专业感。

6.2 中长期演进路线图（按优先级排序）

6.3 避坑指南：那些让我加班到凌晨的“优雅陷阱”

• “用@login_required装饰器就够了”：错！@login_required只检查登录状态，不检查权限。比如usercenter-fav-course.html，必须确保用户只能看到自己收藏的课程，而不是所有课程。正确做法：在视图里用UserFavorite.objects.filter(user=request.user, fav_type=1)，而非Course.objects.all()。

• “ImageField自动处理缩略图”：Django的ImageField只负责上传和存储，不生成缩略图。首页课程列表需要小图，course.image.url返回的是原图，加载巨慢。解决方案：用django-imagekit，定义CourseThumbnailSpec，在模型里加thumbnail = ImageSpecField(...)，模板里用{{ course.thumbnail.url }}。

• “DateTimeField(auto_now_add=True)万能”：auto_now_add在模型创建时赋值，但如果你用form.save(commit=False)再instance.save()，它会被忽略。正确记录创建时间，应该用default=timezone.now，并在save()方法里手动赋值。

最后再分享一个小技巧：这个系统所有的URL名称（name=参数）都遵循appname:viewname的命名规范，如course:course_list、org:org_detail、usercenter:usercenter_info。这意味着，当你想在任意模板里生成一个链接时，永远用{% url 'course:course_list' %}，而不是硬编码/course/。这样，未来如果要把课程列表页改成/learning/courses/，你只需要改urls.py里的path('learning/courses/', ...)，全站链接自动更新。这是我坚持了12年的习惯，也是Django最被低估的生产力特性之一。

本文还有配套的精品资源，点击获取

简介：这个Django在线教育平台源码包开箱即用，支持视频课程在线播放、多级课程分类展示、教育机构主页（含课程列表、师资介绍、机构详情）、教师个人主页、用户注册登录及完整个人中心。个人中心涵盖我的课程、收藏的课程/教师/机构、系统消息通知、个人信息编辑等模块；所有页面基于Django模板引擎渲染，包含20多个核心HTML模板，如course-detail.html、course-video.html、org-detail-course.html、usercenter-mycourse.html等，覆盖首页、课程列表、章节播放、评论互动、403/404/500错误页等典型场景。模型层定义清晰，包含Course、Lesson、Video、Teacher、Organization、UserProfile等基础数据结构；URL路由与视图逻辑完整，静态资源和媒体路径已适配本地开发环境，无需额外插件即可运行基础功能。前端采用原生HTML+CSS+JS，无第三方UI框架依赖，适合学习Django项目结构、快速搭建中小型网校或进行二次定制开发。

本文还有配套的精品资源，点击获取