简介:这是一套基于Python与Django框架开发的视频点播网站系统完整实现,专为本科毕业设计及Web全栈入门者打造,可直接运行部署,覆盖在线教育、短视频分享等典型应用场景。资源包共128个文件,包含40个核心Python后端逻辑文件(含models、views、urls及admin配置)、48个HTML模板(如index、detail、profile、video_edit等,支撑前后端分离式渲染)、20个JavaScript交互脚本(含视频播放控制、评论提交、下拉加载等)、6个PNG/JPG图标资源及5个CSS样式文件(含semantic.custom.css、admin.css等),整体压缩包仅3.23MB,轻量易上手。已有243人下载学习。用户可获得结构清晰的Django标准项目目录、开箱即用的用户认证与权限体系、视频上传/分类/播放/评论/反馈全流程功能模块、适配移动端的响应式前端界面,以及完整的数据库迁移脚本与基础安全防护实践(如CSRF防护、表单验证),是理解Web应用MVC架构与媒体类系统开发的优质实战样本。

1. 项目概述:一个拿来即用的Django视频点播系统

最近几年,带我的学弟学妹做毕业设计,十个里有八个会问有没有现成的、能直接跑起来的视频网站项目。市面上很多源码要么残缺不全,要么环境配置复杂到让人崩溃,对于急着交差的毕业生来说,简直就是灾难。所以,当我手头这个基于Python+Django的视频点播网站系统逐渐成型后,我就决定把它整理出来。这不仅仅是一套代码,更是一个完整的、经过实际部署验证的解决方案。从数据库设计、后端API到前端页面模板,所有文件都齐备,你只需要按步骤配置好Python和Django环境,导入数据,就能在本地看到一个功能完整的视频网站。

这个系统麻雀虽小,五脏俱全。它实现了视频点播网站最核心的几个模块:用户注册登录、视频分类浏览、视频上传与管理(后台)、视频播放与搜索,以及基础的会员或积分体系(视具体设计而定)。对于计算机、软件工程相关专业的同学来说,用它作为毕设基础,可以省去大量从零搭建框架的时间,让你能更专注于业务逻辑的深化、界面美化、性能优化或者扩展新功能(比如弹幕、点赞收藏、推荐算法等),从而做出更有亮点的毕业设计。

2. 系统核心设计与技术栈选型

2.1 为什么选择Python + Django组合?

做Web开发,技术选型是第一步。我选择Python和Django,是基于几个非常实际的考量,尤其对于毕设这种场景。

首先, Python的语法简洁明了 ,接近自然语言。这意味着你写代码和读代码的效率都很高。对于需要在有限时间内完成开发的毕设来说,学习成本和开发成本都更低。你不用在复杂的语法细节上纠缠太久,可以快速把想法变成可运行的代码。像处理视频信息、用户数据这些任务,Python有大量现成的库支持,事半功倍。

其次, Django是一个“功能齐全”的Web框架 。它奉行“开箱即用”的理念,自带了许多Web开发必需的组件:强大的对象关系映射(ORM)让你用Python类就能操作数据库,无需写复杂的SQL语句;自带的后台管理界面(Admin),让你在项目初期就能有一个功能强大的内容管理后台,这对于视频的上传、分类、下架等管理操作来说简直是神器;还有用户认证系统、表单处理、安全防护(如CSRF、SQL注入防护)等,Django都帮你考虑好了。

注意:很多同学会纠结于Django和Flask。简单来说,Django像一套精装修的房子,拎包入住;Flask像毛坯房,自由度高但什么都要自己装。对于毕设这种需要快速呈现完整功能系统的项目,Django的“大而全”优势非常明显。

最后, 生态成熟,资料丰富 。无论是中文还是英文社区,关于Django的教程、问答、第三方插件都非常多。你在开发过程中遇到的绝大多数问题,几乎都能在网上找到解决方案。这能极大降低你在调试和排错阶段耗费的时间。

2.2 系统架构与功能模块拆解

这套系统的设计遵循典型的前后端分离思想,但在初期为了简化部署,采用了Django内置的模板引擎来渲染前端页面。这是一种非常高效且适合毕设的MVT(Model-View-Template)模式。

后端核心(Django) :

  • 模型层(Models) :这是系统的数据心脏。我设计了几个核心数据表:
    • User :扩展自Django自带的用户模型,可能增加了头像、简介、积分等字段。
    • Video :视频主表,包含标题、描述、封面图URL、视频文件URL、所属分类、上传者、播放量、点赞数、上传时间等。
    • VideoCategory :视频分类表。
    • Comment :视频评论表。
    • UserFavorite 或 PlayHistory :用户收藏夹或播放历史表,用于实现个性化功能。
  • 视图层(Views) :处理业务逻辑。例如, video_list 视图负责查询并返回视频列表, video_play 视图处理播放请求并更新播放量, video_upload 视图处理视频文件上传和保存。
  • 路由层(URLs) :将用户的访问地址(如 /video/play/3/ )映射到对应的视图函数。
  • 模板层(Templates) :HTML页面,其中嵌入了Django模板语言,用于动态展示后端传递过来的数据(如视频列表、用户信息)。

前端呈现 :

  • 使用HTML5、CSS3和JavaScript(可能搭配了Bootstrap这类前端框架)来构建用户界面。
  • 视频播放器是关键,通常集成开源的播放器库,如 Video.js 或 DPlayer 。它们功能强大、兼容性好,并且支持自定义皮肤,能轻松实现播放、暂停、进度条、清晰度切换(如果有多清晰度视频)等功能。
  • 通过Ajax技术与后端交互,实现无刷新加载、点赞、发表评论等动态效果。

数据处理与存储 :

  • 数据库 :开发环境常用轻量级的SQLite,便于迁移和演示;部署到服务器时,可以无缝切换到更健壮的MySQL或PostgreSQL。
  • 文件存储 :视频和图片这类静态文件,在开发阶段可以放在项目的 media 目录下。但在生产环境, 务必使用独立的对象存储服务(如阿里云OSS、腾讯云COS)或专门的静态文件服务器 。绝对不要把用户上传的大文件直接保存在Django应用服务器上,这会导致服务器磁盘快速耗尽,且访问性能极差。

3. 环境准备与项目初始化实操

3.1 Python与虚拟环境搭建

第一步是准备好Python环境。我强烈建议使用 Python 3.8 或 3.9 版本,它们在兼容性和稳定性上取得了很好的平衡。不要使用Python 2.x,它已经停止维护。

  1. 安装Python :从Python官网下载对应操作系统的安装包。安装时,务必勾选“Add Python to PATH”,这样就能在命令行中直接使用 python 和 pip 命令。
  2. 验证安装 :打开命令行(Windows的CMD或PowerShell,Mac/Linux的Terminal),输入 python --version 和 pip --version ,能显示版本号即成功。
  3. 创建虚拟环境 :这是至关重要的一步!虚拟环境能为每个项目创建独立的Python包安装空间,避免不同项目间的依赖冲突。
    # 进入你的项目打算存放的目录,例如 D:\Projects
    cd D:\Projects
    # 创建虚拟环境,环境文件夹名为 venv(可自定义)
    python -m venv venv
    
  4. 激活虚拟环境 :
    • Windows : venv\Scripts\activate
    • Mac/Linux : source venv/bin/activate 激活后,命令行提示符前会出现 (venv) 标识,表示你已进入该虚拟环境。

3.2 安装Django与项目依赖

在激活的虚拟环境中,使用pip安装Django。对于这个视频点播项目,我们通常还需要一些额外的库。

# 升级pip工具本身
pip install --upgrade pip

# 安装Django,指定一个长期支持版本,如4.2.x,非常稳定
pip install django==4.2.13

# 安装其他可能需要的依赖(根据项目源码中的requirements.txt来)
# 例如,处理视频缩略图可能需要Pillow
pip install pillow
# 连接MySQL数据库可能需要mysqlclient或pymysql
# pip install mysqlclient  # 在Windows上安装可能麻烦,可以用pymysql替代
pip install pymysql

通常,完整的项目源码会提供一个 requirements.txt 文件,里面列出了所有依赖。你可以用一条命令安装所有依赖:

pip install -r requirements.txt

3.3 获取源码、数据库配置与初始化

  1. 获取项目源码 :将完整的项目文件夹(假设名为 videosite )下载或解压到你的工作目录。
  2. 配置数据库 :打开项目中的 settings.py 文件,找到 DATABASES 配置部分。如果项目默认使用SQLite,你会看到类似下面的配置,它指向一个本地的 db.sqlite3 文件,通常无需修改即可直接运行。
    DATABASES = {
        'default': {
            'ENGINE': 'django.db.backends.sqlite3',
            'NAME': BASE_DIR / 'db.sqlite3',
        }
    }
    
    如果你想使用MySQL,需要先创建好数据库(例如名为 video_db ),然后修改配置:
    DATABASES = {
        'default': {
            'ENGINE': 'django.db.backends.mysql',
            'NAME': 'video_db',      # 数据库名
            'USER': 'your_username', # 数据库用户名
            'PASSWORD': 'your_password', # 数据库密码
            'HOST': 'localhost',     # 数据库地址
            'PORT': '3306',          # 端口
        }
    }
    
    同时,需要在 __init__.py 文件中加入:
    import pymysql
    pymysql.install_as_MySQLdb()
    
  3. 生成数据表与初始化数据 :Django通过“迁移(Migration)”来管理数据库结构的变更。
    # 进入项目根目录(manage.py所在的目录)
    cd videosite
    
    # 生成数据库迁移文件(根据models.py的变化)
    python manage.py makemigrations
    
    # 执行迁移,在数据库中创建所有表
    python manage.py migrate
    
    # 如果项目提供了初始数据(fixtures),如默认的分类、管理员账号等,可以加载
    python manage.py loaddata initial_data.json
    
  4. 创建超级管理员 :用于登录Django自带的后台管理界面。
    python manage.py createsuperuser
    
    按照提示输入用户名、邮箱和密码。

3.4 运行开发服务器与首次访问

完成以上步骤后,激动人心的时刻就到了——启动项目。

# 在项目根目录下执行
python manage.py runserver

命令行会输出类似 Starting development server at http://127.0.0.1:8000/ 的信息。打开浏览器,访问这个地址,你应该能看到网站的首页。

  • 访问 http://127.0.0.1:8000/admin/ ,用刚才创建的超级管理员账号登录,可以进入功能强大的后台,在这里你可以管理视频、用户、分类等所有数据。
  • 前台网站就是用户看到的界面,你可以尝试注册账号、浏览视频、播放视频。

至此,一个完整的视频点播网站已经在你的本地运行起来了。

4. 核心功能模块深度解析与二次开发指南

4.1 视频上传与管理模块的实现细节

这是系统的核心。在 models.py 中, Video 模型是关键。

from django.db import models
from django.contrib.auth.models import User

class VideoCategory(models.Model):
    name = models.CharField(max_length=50, verbose_name='分类名称')
    created_time = models.DateTimeField(auto_now_add=True)

    def __str__(self):
        return self.name

class Video(models.Model):
    title = models.CharField(max_length=200, verbose_name='视频标题')
    desc = models.TextField(verbose_name='视频描述', blank=True)
    # 重点:FileField 用于存储上传的文件,upload_to指定子目录
    video_file = models.FileField(upload_to='videos/%Y/%m/%d/', verbose_name='视频文件')
    # ImageField 用于存储图片,需要安装Pillow库
    cover_image = models.ImageField(upload_to='covers/%Y/%m/%d/', verbose_name='封面图', blank=True)
    category = models.ForeignKey(VideoCategory, on_delete=models.SET_NULL, null=True, verbose_name='分类')
    author = models.ForeignKey(User, on_delete=models.CASCADE, verbose_name='上传者')
    views = models.PositiveIntegerField(default=0, verbose_name='播放量')
    likes = models.PositiveIntegerField(default=0, verbose_name='点赞数')
    created_time = models.DateTimeField(auto_now_add=True, verbose_name='上传时间')
    status = models.CharField(max_length=10, choices=(('pending', '审核中'), ('published', '已发布'), ('banned', '已下架')), default='pending')

    def __str__(self):
        return self.title

    def increase_views(self):
        """播放量自增,使用F函数避免并发问题"""
        self.views = models.F('views') + 1
        self.save(update_fields=['views'])

关键点解析 :

  • upload_to 参数:定义了文件在 MEDIA_ROOT 目录下的存储路径。 %Y/%m/%d/ 会自动按年月日生成子目录,避免单个文件夹内文件过多,影响性能。
  • FileField 和 ImageField :它们只存储文件的相对路径(相对于 MEDIA_ROOT )。你需要正确配置 settings.py :
    # 指定用户上传文件(媒体文件)的存储根目录
    MEDIA_ROOT = os.path.join(BASE_DIR, 'media')
    # 指定通过URL访问这些文件的起始路径
    MEDIA_URL = '/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)
    
  • 视图层处理上传 :在 views.py 中,处理上传的视图需要接收 POST 请求和 request.FILES 。
    from django.shortcuts import render, redirect
    from django.contrib.auth.decorators import login_required
    from .forms import VideoUploadForm
    
    @login_required
    def video_upload(request):
        if request.method == 'POST':
            form = VideoUploadForm(request.POST, request.FILES)
            if form.is_valid():
                video = form.save(commit=False)
                video.author = request.user
                video.save()
                return redirect('video_detail', video_id=video.id)
        else:
            form = VideoUploadForm()
        return render(request, 'video/upload.html', {'form': form})
    
  • 表单定义 :在 forms.py 中,使用 ModelForm 可以快速创建表单。
    from django import forms
    from .models import Video
    
    class VideoUploadForm(forms.ModelForm):
        class Meta:
            model = Video
            fields = ['title', 'desc', 'video_file', 'cover_image', 'category']
            widgets = {
                'desc': forms.Textarea(attrs={'rows': 4}),
            }
    

4.2 视频播放与前端播放器集成

播放页面的核心是将视频文件的URL传递给前端播放器。在播放视图 video_play 中,我们取出视频对象,并将其传递给模板。

def video_play(request, video_id):
    video = get_object_or_404(Video, id=video_id, status='published')
    # 播放量增加(使用模型中的方法)
    video.increase_views()
    # 获取相关推荐视频(例如同分类的视频)
    related_videos = Video.objects.filter(category=video.category, status='published').exclude(id=video_id)[:6]
    return render(request, 'video/play.html', {'video': video, 'related_videos': related_videos})

在模板 play.html 中,我们集成 Video.js:

<!-- 在head中引入Video.js的CSS -->
<link href="https://vjs.zencdn.net/7.20.3/video-js.css" rel="stylesheet" />

<!-- 在body中播放器容器 -->
<video
    id="my-video"
    class="video-js vjs-big-play-centered vjs-fluid"
    controls
    preload="auto"
    poster="{{ video.cover_image.url }}" <!-- 封面图 -->
    data-setup="{}"
>
    <source src="{{ video.video_file.url }}" type="video/mp4" /> <!-- 视频源 -->
    <p class="vjs-no-js">
        您的浏览器不支持HTML5视频,请升级浏览器。
    </p>
</video>

<!-- 在body底部引入Video.js的JS -->
<script src="https://vjs.zencdn.net/7.20.3/video.min.js"></script>

播放量统计的注意点 :直接使用 video.views += 1; video.save() 在并发访问时会导致计数不准。上面模型中使用的 F 函数,是直接在数据库层面进行原子操作,能有效避免这个问题。

4.3 用户系统与权限控制

Django自带的用户认证系统 django.contrib.auth 非常强大,我们在此基础上进行扩展。

  1. 扩展用户模型 :推荐使用“Profile”模式,即创建一个与内置User模型一对一关联的模型。
    from django.db import models
    from django.contrib.auth.models import User
    from django.db.models.signals import post_save
    from django.dispatch import receiver
    
    class Profile(models.Model):
        user = models.OneToOneField(User, on_delete=models.CASCADE)
        avatar = models.ImageField(upload_to='avatars/%Y/%m/%d/', default='default_avatar.png')
        bio = models.TextField(max_length=500, blank=True)
        points = models.IntegerField(default=0) # 积分
    
        def __str__(self):
            return self.user.username
    
    # 使用信号,在User对象创建时自动创建对应的Profile
    @receiver(post_save, sender=User)
    def create_user_profile(sender, instance, created, **kwargs):
        if created:
            Profile.objects.create(user=instance)
    
    @receiver(post_save, sender=User)
    def save_user_profile(sender, instance, **kwargs):
        instance.profile.save()
    
  2. 登录与注册视图 :可以使用Django内置的 LoginView 、 LogoutView 和 UserCreationForm ,也可以自己编写视图实现更复杂的逻辑,如邮箱验证、手机号注册等。
  3. 权限控制装饰器 :
    • @login_required :要求用户必须登录才能访问某个视图,否则跳转到登录页。
    • @user_passes_test :可以自定义检查函数,例如检查用户是否有上传视频的权限(如是否VIP会员)。
    • 在模板中,可以使用 {% if user.is_authenticated %} 来判断用户是否登录,并显示不同内容。

4.4 搜索与筛选功能的实现

一个基本的搜索功能可以通过Django的 Q 对象和 icontains 查询来实现。

from django.db.models import Q

def video_search(request):
    query = request.GET.get('q', '') # 获取搜索关键词
    category_id = request.GET.get('category', '')

    videos = Video.objects.filter(status='published')

    if query:
        # 在标题和描述中搜索,不区分大小写
        videos = videos.filter(Q(title__icontains=query) | Q(desc__icontains=query))

    if category_id:
        videos = videos.filter(category_id=category_id)

    # 排序
    sort_by = request.GET.get('sort', 'new')
    if sort_by == 'hot':
        videos = videos.order_by('-views')
    else: # 'new'
        videos = videos.order_by('-created_time')

    categories = VideoCategory.objects.all()
    return render(request, 'video/search.html', {
        'videos': videos,
        'query': query,
        'categories': categories,
        'selected_category': int(category_id) if category_id.isdigit() else None,
        'sort_by': sort_by
    })

在前端,一个简单的搜索表单如下:

<form action="{% url 'video_search' %}" method="get" class="form-inline">
    <input type="text" name="q" class="form-control" placeholder="搜索视频..." value="{{ query }}">
    <select name="category" class="form-control">
        <option value="">全部分类</option>
        {% for cat in categories %}
        <option value="{{ cat.id }}" {% if selected_category == cat.id %}selected{% endif %}>{{ cat.name }}</option>
        {% endfor %}
    </select>
    <select name="sort" class="form-control">
        <option value="new" {% if sort_by == 'new' %}selected{% endif %}>最新发布</option>
        <option value="hot" {% if sort_by == 'hot' %}selected{% endif %}>最热播放</option>
    </select>
    <button type="submit" class="btn btn-primary">搜索</button>
</form>

对于更复杂的全文搜索,可以考虑集成 Django Haystack 搭配 Whoosh (轻量级)或 Elasticsearch (高性能)等搜索引擎。

5. 项目部署上线与性能优化考量

5.1 从开发到生产环境的关键配置变更

在本地跑起来只是第一步,要让别人也能访问,需要部署到服务器。部署前,必须修改 settings.py 中的一些关键配置。

  1. 关闭调试模式 : DEBUG = False 。这是最重要的安全设置,否则错误信息会暴露代码细节。
  2. 设置允许的主机 : ALLOWED_HOSTS = [‘yourdomain.com’, ‘www.yourdomain.com’, ‘服务器IP地址’] 。
  3. 配置静态文件 :开发时 runserver 会处理静态文件,生产环境不行。需要收集所有静态文件到一个目录。
    # 指定静态文件收集后的存放目录
    STATIC_ROOT = os.path.join(BASE_DIR, 'static_collected')
    
    然后运行命令收集: python manage.py collectstatic 。这个目录需要通过Nginx等Web服务器来提供访问。
  4. 处理媒体文件 :如前所述,生产环境必须将 MEDIA_ROOT 指向一个独立的存储位置(如OSS),或者使用Nginx直接代理 media 目录。
  5. 数据库 :正式上线建议使用MySQL或PostgreSQL,并做好备份策略。

5.2 使用Gunicorn和Nginx部署

这是Python Web应用非常经典的部署组合。

  • Gunicorn :一个Python WSGI HTTP服务器,用于处理Django的动态请求。
    pip install gunicorn
    # 在项目根目录下,用Gunicorn启动Django应用
    gunicorn your_project_name.wsgi:application -b 127.0.0.1:8000 -w 4
    
    -w 4 表示启动4个工作进程,根据服务器CPU核心数调整。
  • Nginx :高性能的Web服务器和反向代理。它负责:
    1. 接收用户从80/443端口来的请求。
    2. 直接处理静态文件( CSS , JS , 图片)的请求,效率极高。
    3. 将动态请求(如访问某个页面、提交表单)转发给后端的Gunicorn(运行在127.0.0.1:8000)处理。
    4. 配置SSL证书,实现HTTPS加密访问。

一个简化的Nginx配置片段如下:

server {
    listen 80;
    server_name yourdomain.com www.yourdomain.com;

    location /static/ {
        alias /path/to/your/project/static_collected/; # 指向STATIC_ROOT
    }

    location /media/ {
        alias /path/to/your/project/media/; # 指向MEDIA_ROOT
    }

    location / {
        proxy_pass http://127.0.0.1:8000; # 转发给Gunicorn
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}

5.3 性能优化与安全加固建议

性能优化 :

  • 数据库查询优化 :使用 select_related 和 prefetch_related 减少查询次数,避免在循环中进行数据库查询(N+1问题)。Django Debug Toolbar 是分析查询性能的神器。
  • 缓存 :对变化不频繁的页面(如首页、分类页)使用Django的缓存框架,可以显著提升响应速度。可以使用内存缓存(如Memcached)或文件缓存。
  • 静态文件CDN :将CSS、JS、图片等静态资源放到CDN上,加速用户加载速度。
  • 视频文件处理 :视频转码、生成缩略图等是CPU密集型操作,务必使用异步任务队列(如Celery + Redis)来处理,避免阻塞Web请求。

安全加固 :

  • HTTPS :使用Let‘s Encrypt免费证书,在Nginx中强制启用HTTPS。
  • 敏感信息 : SECRET_KEY 、数据库密码等绝不能写在代码里。使用环境变量或 .env 文件管理,并通过 python-decouple 或 django-environ 库读取。
  • SQL注入与XSS :Django的ORM和模板系统已经提供了很好的防护。但要警惕用户输入,对富文本评论等内容,可以使用 bleach 库进行过滤。
  • 文件上传安全 :限制上传文件的类型(通过文件扩展名和MIME类型检查)、大小,并对上传的文件进行重命名(如使用UUID),防止恶意文件上传和覆盖。

6. 毕设答辩与项目扩展方向

6.1 如何基于此项目完成一份出色的毕设

拿到一个能运行的系统只是起点,要让它在毕设中脱颖而出,你需要注入自己的思考和劳动。

  1. 功能深化与创新 :

    • 个性化推荐 :实现一个简单的推荐算法。例如,基于用户观看历史,推荐同分类或同标签的视频(协同过滤的雏形)。这能极大提升论文的“技术含量”。
    • 互动功能 :增加弹幕功能(集成DPlayer的弹幕插件)、点赞/踩、收藏夹、视频打赏(模拟积分系统)。
    • 视频处理 :集成FFmpeg,实现上传视频后自动截取关键帧作为封面、转码生成多种清晰度(如360P, 720P)。
    • 后台数据可视化 :使用ECharts等库,在后台展示用户增长、视频播放量趋势、热门分类等统计图表。
  2. 界面与用户体验优化 :

    • 使用更现代的前端框架(如Vue.js或React)重写前端,实现真正的单页面应用(SPA),提升交互体验。这可以作为你“前端技术应用”的亮点。
    • 对网站进行全面的响应式设计优化,确保在手机、平板、电脑上都有良好的浏览体验。
  3. 论文撰写重点 :

    • 不要只讲功能 。重点阐述你 在原有基础上做了哪些改进和扩展 ,以及 为什么这么做 (技术选型理由)。
    • 画出系统的架构图、数据库ER图、核心功能的流程图或时序图。
    • 对关键模块(如推荐算法、视频转码)的实现原理进行详细说明,并附上核心代码片段。
    • 进行简单的性能测试(如使用Apache Bench模拟并发请求),给出优化前后的对比数据。
    • 总结开发过程中遇到的主要问题及解决方案,这体现了你的工程能力。

6.2 常见问题排查与调试技巧

在运行和开发过程中,你肯定会遇到各种报错。这里记录几个最常见的问题和解决思路。

  1. “DisallowedHost” 错误 :部署后访问出现400错误。这是因为 DEBUG=False 时, ALLOWED_HOSTS 没有正确设置。检查并修改 settings.py 中的 ALLOWED_HOSTS 。

  2. 静态文件404(CSS/JS不加载) :页面没有样式。在生产环境,确保:

    • 运行了 python manage.py collectstatic 。
    • Nginx配置中 location /static/ 的 alias 路径指向了正确的 STATIC_ROOT 目录。
    • 静态文件的URL前缀 STATIC_URL 配置正确。
  3. 数据库迁移失败 : python manage.py migrate 时报错,特别是表已存在或字段冲突。

    • 如果是开发初期,可以删除数据库文件(SQLite)或清空数据库(MySQL),然后重新迁移。
    • 如果已有重要数据,需要仔细检查 migrations 文件夹下的迁移文件,可能需要手动修改或使用 --fake 参数。
  4. 视频上传文件过大失败 :默认Django有文件上传大小限制。需要在 settings.py 中调整:

    # 调整请求体最大大小(默认2.5MB)
    DATA_UPLOAD_MAX_MEMORY_SIZE = 104857600  # 100MB
    # 调整文件上传最大数量(可选)
    FILE_UPLOAD_MAX_MEMORY_SIZE = 104857600  # 100MB
    

    注意:Nginx和Gunicorn等服务器也有各自的客户端请求大小限制,需要同步调整。

  5. 使用Pillow处理图片报错 :在Windows上,可能需要安装Microsoft Visual C++ Build Tools。更简单的方法是去Unofficial Windows Binaries for Python Extension Packages这个网站,下载对应Python版本和系统版本的Pillow预编译安装包(.whl文件),然后用pip本地安装。

调试时,善用Django的调试页面(仅在 DEBUG=True 时出现),它会给出详细的错误信息和局部变量值。对于更复杂的逻辑问题,在代码中使用 print() 输出关键变量,或者使用Python的 pdb 调试器进行断点调试,都是非常有效的方法。

本文还有配套的精品资源,点击获取 menu-r.4af5f7ec.gif

Logo

邀请您加入社区

更多推荐