Django集成django-simple-captcha实现防机器人验证码功能

半杯拿铁

发布时间：2026-10-13| 6人浏览过

原创

本文详解如何在Django项目中集成django-simple-captcha模块以增强表单安全性。内容涵盖模块安装、INSTALLED_APPS配置、数据库迁移、URL路由设置及CaptchaField在ModelForm中的具体应用，帮助开发者快速实现防机器人提交功能。

Django集成防机器人验证码方案

为Django项目添加防机器人验证码功能，推荐使用 django-simple-captcha 模块。该模块的官方文档及源码托管于 GitHub，地址为：https://github.com/mbi/django-simple-captcha。

首先，通过命令行工具执行一键安装命令：

模块安装与配置


pip install django-simple-captcha

安装完成后，需修改 Django 项目的 settings.py 配置文件。在 INSTALLED_APPS 列表中注册 'captcha' 应用，确保 Django 能识别该模块。


INSTALLED_APPS = （
  # ...
  'captcha',
  # ... 
）

由于 django-simple-captcha 需要在数据库中创建专用的数据表以存储验证码信息，因此必须执行数据库迁移操作。请在项目根目录下运行以下命令：

数据库迁移


python manage.py migrate

接下来，配置 URL 路由。在 urls.py 文件中引入 captcha 模块的 URL 配置，确保前端页面可以访问验证码生成接口。具体配置如下：

URL路由配置


from django.urls import path, re_path, include
urlpatterns = [
  #...
  url(r'^captcha/', include('captcha.urls'),
  # ...
]

在定义表单类时，需导入 CaptchaField 并将其作为字段添加到窗体类中。以下示例展示了如何在 PostForm 中集成验证码字段，同时保留其他原有字段的标签定义：

表单类集成


from captcha.fields import CaptchaField
class PostForm(forms.ModelForm):
  captcha = CaptchaField() #CaptchaField 字段
  class Meta:
    model = models.Post
    fields = ['mood', 'nickname', 'message', 'del_pass']

  def __init__(self, *args, **kwargs):
    super(PostForm, self).__init__(*args, **kwargs)
    self.fields['mood'].label = '现在的心情'
    self.fields['nickname'].label = '您的昵称'
    self.fields['message'].label = '心情留言'
    self.fields['del_pass'].label = '设置密码'
    self.fields['captcha'].label = '请输入验证码'

完成上述配置后运行项目，前端页面将显示验证码输入框，效果如下：