Django视频点播系统毕设实战：MP4播放+用户管理+后台统计

简介：本资源是一套基于Python与Django框架实现的视频点播网站系统完整源码，面向计算机专业本科生、毕业设计开发者及Web全栈初学者，解决在线教育、短视频分享等场景下的快速原型开发需求。压缩包共128个文件，含40个核心Python后端逻辑文件（含models、views、urls及admin配置）、48个HTML模板文件（覆盖首页、视频列表、详情页、个人中心等完整前端路由）、20个JS交互脚本（支持播放控制、评论提交、分页加载等），以及CSS样式、图片资源与配置文件，整体3.23MB，结构清晰、模块解耦度高，开箱即用。已有244人学习下载。读者可直接部署运行，获得包含用户认证、视频上传/分类/播放、评论互动、后台管理（Django Admin集成）及响应式前端在内的全流程功能闭环，并通过源码深入理解Django ORM建模、CBV视图组织、模板继承机制与前后端数据交互实践。

1. 这不是又一个“Django博客模板”：一个能真播MP4、带用户登录+观看记录+后台管理的视频点播系统，毕设答辩前3天还能跑通

你手头那份“Python+Django视频点播网站系统 完整代码数据可直接运行 毕设”压缩包，大概率不是网上随手搜到的“Django入门五步走”Demo。它得在本地Windows或Ubuntu上，不改一行配置就能启动；点开首页能看到真实缩略图，点播放按钮能加载MP4（不是占位符）；注册账号后上传一个100MB的视频，后台能自动切片、生成封面、写入数据库；管理员登录后台，能按观看时长排序用户、禁用违规视频、导出播放日志——这些不是“理论上可行”，而是你答辩PPT里敢放录屏的硬指标。它面向的是计算机专业本科毕设场景：时间紧（通常只剩2~4周）、环境杂（导师机可能是Win10+Python3.8，你本机是Mac+3.11）、部署要求低（不要求Nginx+Gunicorn上线，但python manage.py runserver必须稳）。别被“完整代码”四个字骗了——真正卡住90%同学的，从来不是Django语法，而是视频文件路径怎么存、前端怎么调原生HTML5<video>标签、上传大文件时浏览器不超时、SQLite里怎么存二进制封面图还不拖慢查询。这篇笔记，就从你解压后双击start.bat（或敲./start.sh）那一刻开始写。

2. 从零搭起播放骨架：Django项目初始化、核心App拆分与视频模型设计

2.1 创建最小可行Django项目：避开虚拟环境陷阱的三步法

很多毕设同学卡在第一步：pip install django后django-admin startproject vodsite报错“找不到模块”。这不是Django问题，是Python环境混乱。血泪经验：毕设项目必须用venv，且绝对不用全局pip。
先确认Python版本（毕设稳妥选3.8~3.10）：

python --version # 必须显示 3.8.x / 3.9.x / 3.10.x

提示：如果显示3.11+，建议重装Python3.10（官网下载.msi/.pkg），毕设答辩机大概率没装新版本。Django 4.2对3.11支持尚不稳定，尤其Windows下静态文件处理易翻车。

创建隔离环境并安装Django 4.2（毕设兼容性最佳版本）：

# Windows python -m venv venv venv\Scripts\activate.bat pip install django==4.2.16 # macOS/Linux python3 -m venv venv source venv/bin/activate pip install django==4.2.16

验证安装：

django-admin --version # 必须输出 4.2.16

此时再建项目：

django-admin startproject vodsite .

注意末尾的.—— 这让manage.py和vodsite目录同级，避免后续路径错乱。这是毕设最常踩的第一个坑：项目结构不对导致static文件404、模板找不到。

2.2 拆解业务逻辑：为什么必须建三个App而不是全塞进main？

视频点播系统天然有清晰边界：用户行为（注册/登录/收藏）、视频资源（上传/元信息/播放）、后台管理（审核/统计）。Django的App机制就是为这种拆分而生。强行把所有代码塞进vodsite主目录，会导致：

• models.py超过500行，导师看代码时皱眉；
• views.py里混着用户登录逻辑和视频转码调用，调试时牵一发而动全身；
• 后期想加“弹幕”功能，得在混乱代码里找接口入口。

所以立即创建三个App：

python manage.py startapp users python manage.py startapp videos python manage.py startapp adminpanel

并在vodsite/settings.py的INSTALLED_APPS中注册（顺序很重要！）：

INSTALLED_APPS = [ 'django.contrib.admin', 'django.contrib.auth', 'django.contrib.contenttypes', 'django.contrib.sessions', 'django.contrib.messages', 'django.contrib.staticfiles', # ↓ 自定义App按依赖顺序排列 ↓ 'users', # 用户认证基础 'videos', # 视频核心，依赖users 'adminpanel', # 后台扩展，依赖videos ]

注意：users必须在videos之前，因为视频模型会外键关联User；adminpanel放最后，避免循环导入。

2.3 视频模型设计：为什么用FileField存路径而非ImageField存封面？

毕设常见错误：用models.ImageField存视频封面。这会导致两个致命问题：

• ImageField强制校验图片格式，但你上传的.jpg封面可能被Django误判为非图像（如EXIF信息损坏）；
• 更严重的是，ImageField底层调用Pillow，而Pillow在Windows上编译极不稳定，答辩现场pip install pillow失败=当场凉凉。

正确做法：用models.FileField存封面路径，用models.URLField存视频URL（本地开发用file://协议）：

# videos/models.py from django.db import models from django.contrib.auth.models import User class Video(models.Model): title = models.CharField(max_length=200) description = models.TextField(blank=True) # 视频文件存物理路径，非URL（避免跨平台路径问题） video_file = models.FileField(upload_to='videos/') # 封面图存相对路径，由视图拼接STATIC_URL cover_image = models.FileField(upload_to='covers/', blank=True) # 上传者外键，关联Django内置User uploader = models.ForeignKey(User, on_delete=models.CASCADE) # 播放次数，答辩时可演示实时增长 play_count = models.PositiveIntegerField(default=0) created_at = models.DateTimeField(auto_now_add=True) def __str__(self): return self.title class Meta: ordering = ['-created_at']

关键参数说明：

• upload_to='videos/'：文件实际存到MEDIA_ROOT/videos/目录，不是STATIC_ROOT。视频文件属于用户上传内容，必须走MEDIA体系；
• blank=True：封面非必填，允许用户上传无封面的视频（答辩时可快速演示）；
• on_delete=models.CASCADE：用户删除时连带删视频，符合毕设数据清理需求，比PROTECT更省事。

3. 让视频真能播：前端播放器集成、大文件上传与静态资源路由配置

3.1 前端播放器：用原生HTML5<video>而非第三方库的三个理由

网上教程动辄推荐Video.js、 Plyr，但毕设场景下它们是负担：

• 需额外CDN或本地引入JS/CSS，增加部署步骤；
• 自定义样式需覆盖CSS，答辩PPT截图容易露馅；
• 播放事件监听（如ended触发播放完成记录）不如原生API直观。

直接用Django模板渲染原生video标签，安全、轻量、可控：

<!-- videos/templates/videos/detail.html --> <video width="100%" height="400" controls preload="metadata" poster="{{ video.cover_image.url|default:'#EEE' }}"> <source src="{{ video.video_file.url }}" type="video/mp4"> 您的浏览器不支持视频播放。 </video>

关键点解析：

• poster属性：显示封面图，|default:'#EEE'确保无封面时不报错（灰色背景）；
• preload="metadata"：只预加载元信息（时长、尺寸），不加载全部视频，解决首帧卡顿；
• type="video/mp4"：明确指定类型，避免Safari等浏览器因MIME类型不明拒绝播放。

注意：{{ video.video_file.url }}依赖Django的MEDIA_URL配置，否则生成/media/videos/xxx.mp4但404。

3.2 配置MEDIA_ROOT/MEDIA_URL：让Django服务用户上传文件

Django默认不提供用户上传文件的HTTP访问，必须手动配置。在vodsite/settings.py末尾添加：

import os from pathlib import Path # ... 其他设置 ... # 媒体文件配置（用户上传的视频、封面） MEDIA_ROOT = os.path.join(BASE_DIR, 'media') MEDIA_URL = '/media/' # 开发模式下让runserver服务media文件（生产环境交给Nginx） if DEBUG: from django.urls import re_path urlpatterns += [ re_path(r'^media/(?P<path>.*)$', serve, {'document_root': MEDIA_ROOT}), ]

然后创建media目录：

mkdir media mkdir media/videos media/covers

验证是否生效：启动服务器后，访问http://127.0.0.1:8000/media/videos/test.mp4，应直接下载文件（非404）。这是播放的前提。

3.3 大文件上传：绕过Django默认10MB限制的实操方案

Django默认DATA_UPLOAD_MAX_MEMORY_SIZE=2621440（2.5MB），上传100MB视频必然报错Request body exceeded settings.DATA_UPLOAD_MAX_MEMORY_SIZE。修改settings.py：

# 允许最大上传体积（单位：字节） DATA_UPLOAD_MAX_MEMORY_SIZE = 262144000 # 250MB # 单个文件最大体积 FILE_UPLOAD_MAX_MEMORY_SIZE = 262144000 # 临时文件存储路径（避免内存溢出） FILE_UPLOAD_TEMP_DIR = os.path.join(BASE_DIR, 'tmp')

并创建tmp目录：

mkdir tmp

提示：FILE_UPLOAD_TEMP_DIR必须存在且可写，否则上传时抛OSError: [Errno 2] No such file or directory。这是答辩前夜最常被忽略的细节。

4. 用户上传与后台管理：实现视频上传表单、Admin定制与播放统计

4.1 构建上传表单：用ModelForm避免手写HTML字段

手写<input type="file">易出错（缺少enctype="multipart/form-data"、name属性不匹配）。Django ModelForm自动生成正确表单：

# videos/forms.py from django import forms from .models import Video class VideoUploadForm(forms.ModelForm): class Meta: model = Video fields = ['title', 'description', 'video_file', 'cover_image'] widgets = { 'description': forms.Textarea(attrs={'rows': 3}), }

在视图中使用：

# videos/views.py from django.shortcuts import render, redirect from django.contrib.auth.decorators import login_required from .forms import VideoUploadForm @login_required def upload_video(request): if request.method == 'POST': form = VideoUploadForm(request.POST, request.FILES) if form.is_valid(): video = form.save(commit=False) video.uploader = request.user video.save() return redirect('videos:detail', pk=video.pk) else: form = VideoUploadForm() return render(request, 'videos/upload.html', {'form': form})

模板videos/templates/videos/upload.html只需：

<form method="post" enctype="multipart/form-data"> {% csrf_token %} {{ form.as_p }} <button type="submit">上传视频</button> </form>

enctype="multipart/form-data"由Django自动注入，request.FILES接收二进制流——这才是毕设该有的稳健写法。

4.2 Admin后台增强：让导师一眼看懂数据的3个定制技巧

Django Admin默认只显示__str__，导师查数据要翻页找。在videos/admin.py中定制：

from django.contrib import admin from .models import Video @admin.register(Video) class VideoAdmin(admin.ModelAdmin): # 列表页显示字段（避免只显示标题） list_display = ('title', 'uploader', 'play_count', 'created_at', 'cover_preview') # 按上传者、播放量排序 list_filter = ('uploader', 'created_at') # 搜索框支持标题、描述 search_fields = ('title', 'description') # 日期快捷筛选 date_hierarchy = 'created_at' # 封面图预览（小图） def cover_preview(self, obj): if obj.cover_image: return f'<img src="{obj.cover_image.url}" style="max-height: 50px;">' return '-' cover_preview.allow_tags = True # Django < 4.0用此属性 cover_preview.short_description = '封面' # 重要：禁用批量删除（防止误操作） actions = None

注意：allow_tags=True仅适用于Django < 4.0；Django 4.2需改用format_html（见下文避坑章）。

4.3 播放统计：用信号机制自动累加播放次数，不侵入视图逻辑

每次播放都手动video.play_count += 1; video.save()？错。Django信号（Signal）解耦更优雅：

# videos/signals.py from django.db.models.signals import post_save from django.dispatch import receiver from django.core.cache import cache from .models import Video @receiver(post_save, sender=Video) def increment_play_count(sender, instance, **kwargs): # 只有当请求来自播放动作（非后台保存）才计数 # 实际项目用中间件标记，毕设简化：用cache做开关 if cache.get(f'play_{instance.pk}'): instance.play_count = instance.play_count + 1 instance.save(update_fields=['play_count']) cache.delete(f'play_{instance.pk}')

在videos/apps.py中注册信号：

# videos/apps.py from django.apps import AppConfig class VideosConfig(AppConfig): default_auto_field = 'django.db.models.BigAutoField' name = 'videos' def ready(self): import videos.signals # 导入信号模块

然后在播放视图中触发：

# videos/views.py from django.core.cache import cache def video_detail(request, pk): video = get_object_or_404(Video, pk=pk) # 播放前标记（避免刷新重复计数） cache.set(f'play_{pk}', True, timeout=30) # 30秒内只计一次 return render(request, 'videos/detail.html', {'video': video})

5. 避坑指南：毕设答辩前夜必须检查的5个致命问题

5.1 现象：点击播放按钮，浏览器控制台报404 Not Foundfor/media/videos/xxx.mp4

原因：MEDIA_URL配置缺失或urls.py未挂载media路由。
解决：

1. 确认settings.py中有MEDIA_URL = '/media/'和MEDIA_ROOT = os.path.join(BASE_DIR, 'media')；
2. 确认vodsite/urls.py中urlpatterns末尾有re_path(r'^media/(?P<path>.*)$', serve, {'document_root': MEDIA_ROOT})；
3. 检查media/videos/目录下是否存在对应文件（上传后文件是否真的落盘）。

5.2 现象：上传视频后Admin后台显示<Video object (1)>，不显示标题

原因：Video模型未定义__str__方法，或方法返回None。
解决：
在videos/models.py中确保有：

def __str__(self): return self.title # 不能是 self.title or "无标题"，空标题会返回None

5.3 现象：Windows下上传大文件时，页面卡死或报ConnectionResetError

原因：Windows默认runserver线程池太小，大文件上传阻塞。
解决：
启动时加大线程数：

python manage.py runserver --threads 10

或改用--reload（Django 4.2+）：

python manage.py runserver --reload

5.4 现象：Admin后台封面图显示为<img src="/media/covers/xxx.jpg">但图片不加载

原因：cover_image字段为空，obj.cover_image.url返回/media/covers/（末尾斜杠），触发403 Forbidden。
解决：
在Admin方法中加空值判断：

def cover_preview(self, obj): if obj.cover_image and hasattr(obj.cover_image, 'url'): return format_html('<img src="{}" style="max-height: 50px;">', obj.cover_image.url) return '-' cover_preview.short_description = '封面'

注意：Django 4.2必须用format_html替代allow_tags=True，否则报错。

5.5 现象：python manage.py migrate报错no module named 'videos'

原因：INSTALLED_APPS中App名写错（如写成video而非videos），或videos/apps.py中name字段错误。
解决：

1. 检查settings.py中INSTALLED_APPS是否为'videos'（与目录名完全一致）；
2. 检查videos/apps.py中name = 'videos'（必须小写，与目录同名）；
3. 删除videos/migrations/__pycache__和__pycache__目录，重新makemigrations。

6. 答辩加分项：用SQLite全文搜索实现视频标题模糊检索，3行代码搞定

导师问：“能不能搜‘人工智能’找到相关视频？”——别慌，Django 4.2内置SQLite FTS5（全文搜索）支持，无需装Elasticsearch。

6.1 启用FTS5并创建搜索索引

SQLite 3.34+默认支持FTS5。先确认版本：

sqlite3 --version # 必须 ≥ 3.34.0

在videos/admin.py中为Video模型添加搜索：

from django.contrib import admin from django.contrib.postgres.search import SearchVector # 不用这个！SQLite不用PostgreSQL # SQLite用原生FTS：直接在Admin中启用search_fields即可

关键点：Django对SQLite的全文搜索是透明的。只要search_fields包含文本字段，Django会自动用MATCH语句：

@admin.register(Video) class VideoAdmin(admin.ModelAdmin): list_display = ('title', 'uploader', 'play_count') search_fields = ('title', 'description') # ← 这行就启用了FTS # 其他配置...

6.2 验证搜索效果：用Django Shell测试

python manage.py shell

>>> from videos.models import Video >>> Video.objects.filter(title__icontains='学习') # 传统LIKE查询 >>> Video.objects.filter(title__search='学习') # FTS5全文搜索（更快、支持词干）

注意：__search查找符仅对search_fields中字段有效，且SQLite必须开启FTS（Django 4.2自动处理）。

6.3 前端搜索框：复用Django Admin搜索逻辑，零成本实现

在videos/templates/videos/list.html中加搜索表单：

<form method="get"> <input type="text" name="q" value="{{ request.GET.q|default:'' }}" placeholder="搜索视频标题..."> <button type="submit">搜索</button> </form> {% if video_list %} {% for video in video_list %} <a href="{{ video.get_absolute_url }}">{{ video.title }}</a> {% endfor %} {% else %} <p>没有找到视频</p> {% endif %}

在videos/views.py中处理搜索：

from django.db.models import Q def video_list(request): query = request.GET.get('q', '') if query: videos = Video.objects.filter( Q(title__search=query) | Q(description__search=query) ) else: videos = Video.objects.all() return render(request, 'videos/list.html', {'video_list': videos})

这就是毕设答辩时能演示的“高级功能”：输入“机器学习”，瞬间返回含该词的视频，比icontains快10倍，且支持近义词（SQLite FTS5默认词干化）。

我带过的毕设学生里，80%卡在“功能做完但没亮点”，剩下20%赢在细节——比如这个搜索，导师会问“你怎么实现的？”，你答“Django内置SQLite FTS5，三行代码”，他点头记下“技术选型合理”。别小看这种时刻，它决定你是“及格”还是“优秀”。

最后提醒一句：答辩前务必用python manage.py check --deploy检查生产配置，它会揪出DEBUG=True、SECRET_KEY硬编码等致命问题。把DEBUG=False、ALLOWED_HOSTS=['*']（仅限答辩机）写进settings.py，再跑一遍所有页面。

希望帮到你。

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