Python如何生成验证码_Pillow画图生成防机器人的图形验证码接口-Python教程-PHP中文网

根本原因是未指定字体路径，Pillow 默认找不到系统字体；应使用 importlib.resources 加载内置字体、动态计算文本尺寸、单字符绘制并加随机旋转、缓存字体对象、正确返回 PNG 字节流。

python如何生成验证码_pillow画图生成防机器人的图形验证码接口

根本原因是没指定字体路径，Pillow 默认找不到系统字体。Linux/macOS 通常压根没预装 arial.ttf 这类 Windows 常见字体，直接写死路径必挂。

用 ImageFont.truetype() 时，必须传一个真实存在的字体文件路径，不能只写字体名
推荐用 pkg_resources 或 importlib.resources（Python 3.9+）把字体文件打进包里，比如放 fonts/DejaVuSans.ttf，然后用 importlib.resources.files(__package__).joinpath("fonts/DejaVuSans.ttf") 拿路径
临时调试可用系统自带字体：macOS 是 /System/Library/Fonts/Helvetica.ttc，Ubuntu 是 /usr/share/fonts/truetype/dejavu/DejaVuSans.ttf，但别上线硬编码

默认字号太小、字符间距太近，人眼都难分清，更别说防 OCR；但字号太大又撑出画布，或笔画过粗导致粘连——这不是“越乱越好”，而是要平衡可读性与机器识别难度。

建议字号在 24–32 之间，用 font.getbbox(text)（Pillow 8.0+）或 font.getsize(text)（旧版）动态算宽高，别用固定偏移
每个字符单独 draw.text((x, y), char, fill=color, font=font)，x 坐标按字符宽度累加，留 6–10 像素间隔，避免挤在一起
加一点随机旋转（angle = random.randint(-15, 15)），再用 text_img = text_img.rotate(angle, expand=1) 后贴回，比整图扭曲更自然

Flask/FastAPI 返回的是字节流，不是文件路径；Content-Type 写成 text/plain 或漏设，浏览器就当文本渲染，显示一堆乱码。

Python 编程规范

Python 编程规范与最佳实践。强制 PEP 8 代码风格、语法校验、单元测试执行，适用于代码编写、审查和重构。触发词：Python、代码规范、py_compile、单元测试。

下载

用 BytesIO 接收 image.save(buf, format="PNG") 的输出，再用 buf.getvalue() 拿 bytes
响应头必须设 Content-Type: image/png（PNG）或 image/jpeg（JPEG），别依赖框架自动推断
FastAPI 用 Response(content=buf.getvalue(), media_type="image/png")；Flask 用 send_file(buf, mimetype="image/png", as_attachment=False)，注意 as_attachment=False 否则会下载

ImageFont.truetype() 是重操作，内部要解析字体文件、构建 glyph 缓存。每生成一个验证码都调一次，QPS 上不去，CPU 也虚高。

字体对象是线程安全的，全局缓存一份即可：FONT = ImageFont.truetype(font_path, size=28) 放模块顶层
如果支持多字号（比如干扰线用小号字），最多缓存 2–3 个常用尺寸，别按需 new
验证码图大小统一（如 (120, 40)），就提前建好 Image.new("RGB", (120, 40)) 模板复用，但注意别跨请求共享 Image 实例（有状态）

真正麻烦的是噪声与字体的博弈：加太多点线，人眼识别率掉得比机器还快；加太少，tesseract 一行命令就 OCR 出来。没有银弹，得拿真实用户反馈调参，而不是只看“看起来乱”。