Django-验证码
这篇讲什么
- 验证码用在注册、登录这类容易被脚本轰炸的入口,作用是「先挡一道,不合格就不进后面的业务逻辑」;它能减少暴力请求,但不能替代
{% csrf_token %}。 - 这篇先测 Pillow 这条路在 Django 5.2.19 上能不能走通,再指出老笔记那段手写验证码的三个真 bug 并给出修正版,最后对比现成的
django-simple-captcha。
作用
- 在注册、登录页面为了防止暴力请求加入验证码:验证不通过就不进入后面的业务逻辑,省掉服务器和数据库的开销。
- 它也能挡掉一部分自动化 CSRF 攻击(脚本拿不到图里的字符),但不能替代
{% csrf_token %},两者是不同层的防护。 - 老笔记这套 Pillow 手写验证码在 Django 5.2 上仍然能跑,但有三个真 bug(下面实测),这一版把它们补上。
先测 Pillow 这条路能不能走通
-
本机
Pillow 13.0.0,画图三件套都在:1
from PIL import Image, ImageDraw, ImageFont
-
字体是这段代码里最容易翻车的地方。实测:
1
2
3
4
5
6
7truetype 签名 (font, size=10, index=0, encoding='', layout_engine=None) -> FreeTypeFont
存在 True C:\Windows\Fonts\Arial.ttf
存在 True C:\Windows\Fonts\consola.ttf
存在 False /usr/share/fonts/truetype/dejavu/DejaVuSans.ttf
Linux 路径报错: OSError cannot open resource
缺字体报错: OSError cannot open resource
load_default -> FreeTypeFont- 也就是说老笔记里写死的
r'C:\Windows\Fonts\Arial.ttf'只在 Windows 上成立,代码一上 Linux 服务器就是OSError: cannot open resource(连不上任何友好提示)。 - 正确做法是「候选列表 + 回退到
load_default()」,别写死一个路径。
- 也就是说老笔记里写死的
-
Image.new/ImageDraw.Draw/draw.point/draw.text/im.save(buf, 'png')都照旧可用,实测能出图:1
2老笔记视图: 200 image/png 2425 字节 PNG头 True
修正版: 200 image/png 2144 字节 字体 Arial.ttf Cache-Control: no-store, max-age=0
老笔记这段的三个真 bug
-
1)session 里没有验证码时直接
.upper()会炸老笔记的登录视图:
1
if verifycode.upper() == request.session.get("verifycode").upper():
实测(新 session 直接提交):
1
无 session 时老写法: 500 AttributeError: 'NoneType' object has no attribute 'upper'
- 用户先打开登录页、但验证码图没加载出来(或被广告拦截器挡了)就会撞上;正确写法是先取出来判
None。
- 用户先打开登录页、但验证码图没加载出来(或被广告拦截器挡了)就会撞上;正确写法是先取出来判
-
2)验证码不是一次性的
-
老笔记只在生成时覆盖
request.session["verifycode"],验证通过后不删除。实测连续取两张图:1
连续取两张图后的答案: hm2f -> Fdtt 长度 4
-
只有最后一次有效,但验证成功后它仍留在 session 里,同一个码可以反复用来试账号密码。修正版在比对后
pop掉,实测:1
2第一次提交正确码: 302 / session 剩余: None
同一个码再用: 400(session 里已经没有可比对的值)
-
-
-
3)用
str当变量名1
2str = '1234567890QWERTY...'
rand_str += str[random.randrange(0, len(str))]- 这把内置的
str类型遮蔽掉了,函数内后面任何str(x)都会TypeError: 'str' object is not callable。改名成CHARS就好(PEP8 也要求模块级常量全大写)。
- 这把内置的
-
另外两处不算 bug 但值得改:
del draw(Pillow 对象自动回收,不需要手动 del)、img src="http://127.0.0.1:8000/verifycode/"(写死主机,换域名就失效,改成{% url %})。
修正版:视图
1 | import io |
-
实测这几条路径(
django.test.Client,会自动带 Cookie):1
2
3错码: 302 /login/?why=captcha
用小写提交正确答案: 302 / uid in session: True
凭证错: 302 /login/?why=credentials- 大小写不敏感是靠两边都
.upper()实现的,老笔记这点没错。
- 大小写不敏感是靠两边都
-
Cache-Control: no-store为什么重要:验证码是<img>,浏览器会按 URL 缓存它。不加这个头时,用户点「刷新页面」拿到的还是同一张图,但 session 里的答案已经换新,于是怎么输都错。前端再配一个时间戳参数强制刷新:1
2<img src="{% url 'myapp:verifycode' %}" alt="验证码"
onclick="this.src='{% url 'myapp:verifycode' %}?t='+Date.now()">实测登录页渲染出的
img就是这个形状,src走{% url %}而不是写死http://127.0.0.1:8000/...。
登录页模板
1 |
|
- 实测
GET /login/→200,页面里含csrfmiddlewaretoken隐藏域。 - 老笔记的表单
action="/login/"、method="POST"都没问题,只是少了「刷新验证码」的交互(点击<img>换图)。
用现成的库:django-simple-captcha
-
本机装了
django-simple-captcha 0.7.0。它把答案存在数据库表里(CaptchaStore模型),比塞 session 更适合多进程部署。 -
但必须先把
'captcha'加进INSTALLED_APPS再导入,否则实测直接报错:1
2RuntimeError: Model class captcha.models.CaptchaStore doesn't declare an explicit
app_label and isn't in an application in INSTALLED_APPS. -
最小接入(四步):
settings.py 1
2
3
4
5
6
7
8
9
10
11
12INSTALLED_APPS = [..., "captcha"]
# urls.py
path("captcha/", include("captcha.urls")),
# forms.py
from captcha.fields import CaptchaField
class LoginForm(forms.Form):
verify = CaptchaField()
# 视图里正常 form.is_valid() 即可,答案校验由字段自己做 -
想要更省事就用它,别自己画图:字体、干扰线、过期清理(
captcha.management.commands.cleancaptcha)都替你处理好了。
新手卡点清单
-
都是实测过的:
卡点 症状 正确做法 字体路径写死 Windows 上 Linux 就 OSError: cannot open resource候选列表 + load_default()兜底request.session.get("verifycode").upper()AttributeError: 'NoneType' object has no attribute 'upper'(500)先判 None验证通过不删 session 里的码 同一个码可反复试密码 比对后 pop掉,一次性验证码响应没禁缓存 刷新后图不变、怎么输都错 Cache-Control: no-store+?t=时间戳用 str当变量名后续 str(...)变TypeError改名 CHARSimg src写死127.0.0.1:8000换域名/端口图就挂 用 {% url %}未装 sessions应用request.session不存在/不落库确认 django.contrib.sessions在INSTALLED_APPS且跑过migrate直接 from captcha.fields import ...RuntimeError ... isn't in an application in INSTALLED_APPS先 'captcha'进INSTALLED_APPS
参考
- Pillow
ImageFont文档:truetype/load_default/textbbox。 - Django sessions 框架:
request.session的存取与一次性令牌写法。 - Django caching 里的
Cache-Control:为什么动态图片要no-store。