怎么用原生JavaScript和Canvas绘制图形验证码
本文详细介绍如何使用原生JavaScript与HTML5 Canvas绘制安全、美观的图形验证码。涵盖字符集过滤、随机坐标与角度变换、干扰线与噪点绘制、高清屏适配及交互校验完整代码。
<canvas> 画布,利用 2D 绘图上下文(CanvasRenderingContext2D)按顺序执行四步操作:填充随机淡色背景、随机选取去除了易混淆字符的文本序列、逐个对字符进行旋转倾斜并绘制、叠加随机干扰线与噪点圆斑。本文提供一套无需外部依赖的原生实现方案,配合坐标变换原理与完整代码,帮助读者快速落地图形验证码。
一、准备画布与整体生成流程
使用 Canvas 绘制验证码时,必须区分“画布固有像素尺寸”与“CSS 呈现尺寸”。如果在 CSS 中直接设置宽和高,Canvas 会默认以 300×150 像素按比例拉伸,导致绘制出来的字符和线条出现模糊失真。因此,应在 <canvas> 标签或 JavaScript 中显式指定 width 和 height 属性。
图形验证码的生成过程遵循清晰的图层叠加顺序。先绘制底层的背景色块,接着在中间层绘制带有随机倾斜角度的字符,最后在顶层覆盖随机分布的线条和斑点,从而形成不易被简单脚本直接识别的视觉干扰。
二、构建字符池与随机数工具函数
验证码字符集的设计需要兼顾辨识度与随机性。许多读者在使用验证码时经常遇到将数字 0 与字母 O、数字 1 与小写字母 l 或大写字母 I 混淆的情况。在实际开发中,应主动剔除这些形态极度相近的字符。
为了完成后续的随机倾斜、随机颜色生成以及坐标摆放,我们需要两个基础函数:一个用于生成指定范围内的随机整数,另一个用于生成具有对比度的随机 RGB 颜色。
// 过滤容易混淆的字符:0, O, o, 1, I, l
const CHAR_POOL = '23456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnpqrstuvwxyz';
/**
* 产生指定区间 [min, max] 的随机整数
*/
function getRandomInt(min, max) {
return Math.floor(Math.random() * (max - min + 1)) + min;
}
/**
* 产生指定亮度范围的随机 RGB 颜色
* @param {number} min 最小亮度值 (0-255)
* @param {number} max 最大亮度值 (0-255)
*/
function getRandomColor(min, max) {
const r = getRandomInt(min, max);
const g = getRandomInt(min, max);
const b = getRandomInt(min, max);
return `rgb(${r}, ${g}, ${b})`;
}
getRandomColor(180, 240)),而绘制文本时则使用深色系(例如 getRandomColor(20, 120)),这样能保证无论生成什么颜色,字符与背景之间都具备足够的明度反差。
三、字符渲染与几何变换(平移与旋转)
若只是规整地把字符排列在画布上,很容易被基础的字符切分算法识别。为了增加防识别强度,需要让每个字符产生随机的角度旋转和上下微移。在 Canvas 2D 中,旋转操作默认是围绕当前坐标系的原点 (0, 0) 进行的。如果直接调用 ctx.rotate(),字符会绕着画布左上角转动,直接飞出画布可视范围。
正确的旋转解法分为四步:
- 调用
ctx.save()保存当前的绘图环境状态。 - 调用
ctx.translate(x, y)将坐标系原点移至当前字符的中心位置。 - 调用
ctx.rotate(angle)围绕新的中心点旋转指定弧度。 - 调用
ctx.fillText(char, 0, 0)并在绘制完成后调用ctx.restore()恢复原始坐标系统。
四、绘制防识别干扰线与随机噪点
如果验证码画面中只有清晰的字符,普通的边缘检测或轮廓分割即可将字符分离。加入干扰线和噪点的目的,在于打断连续的单色边缘,增加机器自动化分割与二值化的复杂度。
- 随机干扰线:在画布边界范围内生成若干条起点和终点随机的线段,调用
beginPath()、moveTo()、lineTo()与stroke()完成绘制。线段颜色应采用半透明或中等对比度,线宽保持在 1 到 1.5 像素,避免把文字完全遮挡导致读者无法辨认。 - 随机噪点圆斑:在整个画布上随机布设数十个小圆点,使用
arc(x, y, radius, 0, 2 * Math.PI)并填充半透明颜色。散落的点状噪点可有效干扰基于像素连通域的字符分离算法。
五、完整代码实现与组件封装
为了便于在页面或表单中直接调用,我们将验证码生成逻辑封装为一个独立的 CaptchaCanvas 类。该类负责维护当前的画布尺寸、字符数量、内部验证码文本,并暴露出获取校验状态及刷新重绘的方法。
class CaptchaCanvas {
/**
* @param {HTMLCanvasElement} canvas
* @param {Object} options 配置项
*/
constructor(canvas, options = {}) {
this.canvas = canvas;
this.ctx = canvas.getContext('2d');
// 基础配置
this.width = options.width || 120;
this.height = options.height || 40;
this.length = options.length || 4; // 验证码字符个数
this.lineCount = options.lineCount || 4; // 干扰线数量
this.dotCount = options.dotCount || 40; // 噪点数量
// 字符源(排除容易混淆的 0, O, 1, I, l 等)
this.charPool = '23456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnpqrstuvwxyz';
this.currentCode = '';
// 初始化画布固定像素尺寸
this.canvas.width = this.width;
this.canvas.height = this.height;
// 绘制并生成
this.draw();
}
// 生成 [min, max] 随机整数
_rand(min, max) {
return Math.floor(Math.random() * (max - min + 1)) + min;
}
// 生成特定亮度区间的颜色
_randColor(min, max) {
return `rgb(${this._rand(min, max)}, ${this._rand(min, max)}, ${this._rand(min, max)})`;
}
// 绘制整幅验证码
draw() {
const { ctx, width, height } = this;
this.currentCode = '';
// 1. 填充浅色背景
ctx.fillStyle = this._randColor(220, 250);
ctx.fillRect(0, 0, width, height);
// 2. 逐字绘制并进行空间几何变换
const charWidth = width / (this.length + 1);
ctx.textBaseline = 'middle';
for (let i = 0; i < this.length; i++) {
const char = this.charPool[this._rand(0, this.charPool.length - 1)];
this.currentCode += char;
// 字符基础坐标
const x = charWidth * (i + 1);
const y = height / 2 + this._rand(-4, 4);
// 旋转角度 (-30度 到 +30度 转换为弧度)
const deg = (this._rand(-30, 30) * Math.PI) / 180;
// 随机字号
const fontSize = this._rand(height * 0.55, height * 0.75);
ctx.save();
ctx.translate(x, y);
ctx.rotate(deg);
ctx.font = `bold ${fontSize}px sans-serif`;
ctx.fillStyle = this._randColor(20, 110); // 深色字符
ctx.fillText(char, 0, 0);
ctx.restore();
}
// 3. 绘制干扰线条
for (let i = 0; i < this.lineCount; i++) {
ctx.beginPath();
ctx.moveTo(this._rand(0, width), this._rand(0, height));
ctx.lineTo(this._rand(0, width), this._rand(0, height));
ctx.strokeStyle = this._randColor(120, 200);
ctx.lineWidth = 1.2;
ctx.stroke();
}
// 4. 绘制干扰噪点
for (let i = 0; i < this.dotCount; i++) {
ctx.beginPath();
ctx.arc(this._rand(0, width), this._rand(0, height), 1, 0, 2 * Math.PI);
ctx.fillStyle = this._randColor(100, 180);
ctx.fill();
}
}
// 获取当前生成的完整验证码
getCode() {
return this.currentCode;
}
// 校验用户输入(默认不区分大小写)
validate(inputCode, caseSensitive = false) {
if (!inputCode) return false;
if (caseSensitive) {
return inputCode === this.currentCode;
}
return inputCode.toLowerCase() === this.currentCode.toLowerCase();
}
}
将上述类应用到 HTML 页面中的典型交互方式如下:
<!-- HTML 模板片段 -->
<div class="captcha-group">
<input type="text" id="captchaInput" placeholder="请输入验证码" maxlength="4" />
<canvas id="captchaCanvas" style="cursor: pointer;" title="看不清?点击刷新"></canvas>
<button type="button" id="submitBtn">验证</button>
</div>
<script>
const canvasEl = document.getElementById('captchaCanvas');
const inputEl = document.getElementById('captchaInput');
const btnEl = document.getElementById('submitBtn');
// 初始化验证码实例
const captcha = new CaptchaCanvas(canvasEl, { width: 120, height: 40 });
// 点击画布直接触发重绘更新
canvasEl.addEventListener('click', () => {
captcha.draw();
});
// 比对验证
btnEl.addEventListener('click', () => {
const userVal = inputEl.value.trim();
if (captcha.validate(userVal)) {
alert('验证通过!');
} else {
alert('验证码输入有误,请重试');
captcha.draw(); // 验证失败后立即刷新
inputEl.value = '';
}
});
</script>
六、交互校验生命周期与状态流转
在实际页面中,验证码的生命周期不仅包含首次绘制,还与用户的点击刷新、表单提交重试以及重置流程紧密关联。以下图示梳理了前端验证码完整的状态变化图:
七、常见问题排查与关键注意事项
1. Retina 高清屏(DPI)模糊问题
在部分手机屏幕或高清显示器(如 MacBook Retina 屏)上,普通尺寸的 Canvas 会因为像素密度不匹配而显得发虚。排查该问题的关键在于读取系统的 window.devicePixelRatio(设备像素比,通常为 2 或 3)。
优化方案是将 Canvas 的物理像素尺寸放大为 width * dpr 与 height * dpr,同时利用 CSS 将样式尺寸锁定为原本的 width 和 height,并在开始绘图前调用 ctx.scale(dpr, dpr)。这样无需修改后续任何绘图坐标,就能在高清屏幕上获得极度清晰的渲染效果。
2. 字体未加载导致的字形位移
如果使用特定网络字体绘制验证码,在字体文件未完成下载时直接调用 fillText,浏览器会先使用回退系统字体绘制,从而出现字号忽大忽小或字符超出画布的情况。推荐直接使用通用的系统安全字体(如 sans-serif、Arial 或 Helvetica),确保字体随时处于立即可用状态。
3. 前端验证码的安全边界认知
需要明确的是,由于本方案的字符生成、比对和校验均运行在前端浏览器中,任何能够查看页面源代码或操作控制台的用户都能直接读取到变量 captcha.currentCode 的纯文本值。
因此,纯前端 Canvas 验证码主要适用于防止低频连击、过滤初级无头脚本或阻挡误触等轻量交互场景。若项目涉及账号密码登录、短信验证码发送、资产支付等核心安全流程,必须由后端服务生成图片并利用 Session 或加密 Token 进行服务端校验。
JS怎么实现元素全屏显示:requestFullscreen基础用法
2026-11-16 13:42:29
JS中this指向丢失导致无法获取当前元素的解决方法
2026-11-16 13:42:21
JS批量设置多个div的不同背景颜色
2026-11-16 13:42:21
为什么在Dreamweaver设计视图看不到JavaScript弹窗效果
2026-11-14 15:36:52
React事件为什么要驼峰命名?写onclick为什么无效?
2026-11-12 14:52:20








