Django框架实现图形验证码的完整指南

Ruby

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

原创

本文详细介绍如何在Django框架中使用Pillow库生成图形验证码，以应对暴力请求和爬虫爬取。内容涵盖从安装依赖、核心API解析到完整的业务逻辑实现，包括随机字符生成、字体加载、噪声添加及HTTP响应处理，并提供HTML模板与视图函数的完整代码示例。

Django验证码实现概述

本文详细介绍Django框架中图形验证码的实现方法，旨在为开发者提供实用的参考方案。

验证码基础

1、应用场景

在用户登录、注册或执行敏感操作时，为防范服务器遭受暴力破解或恶意爬虫抓取，引入验证码机制可有效过滤非法请求，从而降低服务器负载。
生成验证码需依赖绘图库Pillow
- pip3 install Pillow
- 核心API组件
- Image模块
  - 图像模式
  - 图像尺寸
  - 背景颜色
- ImageDraw模块
  - 绑定画布对象
  - 绘图模式
  - 封装绘制接口
  - 文本绘制
  - 点绘制
  - 线条绘制
  - 弧线绘制
- ImageFont模块
  - 手动指定字体文件

验证码业务流程与核心API

2、业务流程

绘制验证码图片


background = (10,20,30) // RGB颜色

初始化画布


image = Image.new(‘RGB',(100,50),background)

获取画笔对象


draw = ImageDraw.Draw(image)

绘制随机四个字符


font = ImageFont.truetype(‘path',size)
fontcolor = (20,40,60)
draw.text((x,y),'R',font,fontcolor)

返回验证码内容


# 删除画笔
del draw
#保存图片到BytesIO对象
Import io
buf = io.BytesIO()
image.save(buf,'png')
#返回BytesIO中的内容
return HttpResponse(buf.getvalue(),'image/png')

完整代码范例与实现细节

3、代码实现

HTML页面结构


<form method="post" action="{% url 'sitesApp:login' %}">
  {% csrf_token %}
    <div class="login">
      <div class="input-group">
       <span class="input-group-addon" id="basic-addon1">用户名</span>
       <input type="text" class="form-control" placeholder="Username" aria-describedby="basic-addon1" name="uName">
      </div>
      <div class="input-group">
       <span class="input-group-addon" id="basic-addon1">密&nbsp;&nbsp;&nbsp;&nbsp;码</span>
       <input type="text" class="form-control" placeholder="Password" aria-describedby="basic-addon1" name="uPswd">
      </div>
      <div class="input-group">
       <span class="input-group-addon" id="basic-addon1">验证码</span>
       <input type="text" class="form-control" placeholder="Auth code" aria-describedby="basic-addon1" name="uCode">
      </div>
      <div class="vcode">
        <img src="/app/getvcode/" id="vcode">
      </div>
      <input type="submit" class="loginBtn" value="登 录"><br>
    </div>
  </form>
  <script type="text/javascript">
    $(function () {
      $('#vcode').click(function () {
        $(this).attr('src',"/app/getvcode"+Math.random())
      })
    })
  </script>

视图逻辑处理


'''
生成并返回验证码
'''
def getvcode(request):
  # 随机生成验证码
  population = string.ascii_letters+string.digits
  letterlist = random.sample(population,4)
  vcode = ''.join(letterlist)
  # 保存该用户的验证码
  request.session['vcode']=vcode
  # 绘制验证码
  # 需要画布,长宽颜色
  image = Image.new('RGB',(176,60),color=getRandomColor())
  # 创建画布的画笔
  draw = ImageDraw.Draw(image)
  # 绘制文字，字体所在位置
  path = os.path.join(BASE_DIR,'static','fonts','ADOBEARABIC-BOLDITALIC.OTF')
  font = ImageFont.truetype(path,50)
  for i in range(len(vcode)):
    draw.text((20+40*i,0),vcode[i],fill=getRandomColor(),font=font)
  # 添加噪声
  for i in range(500):
    position = (random.randint(0,176),random.randint(0,50))
    draw.point(position,fill=getRandomColor())
  # 返回验证码字节数据
  # 创建字节容器
  buffer = io.BytesIO()
  # 将画布内容丢入容器
  image.save(buffer,'png')
  # 返回容器内的字节
  return HttpResponse(buffer.getvalue(),'image/png')
# 获取随机颜色
def getRandomColor():
  red = random.randint(0,255)
  green = random.randint(0,255)
  blue = random.randint(0,255)
  return (red,green,blue)

希望本文所述内容能帮助读者更好地掌握基于Django框架的Python程序设计技巧。