怎么用原生JavaScript和Canvas绘制图形验证码

作者:小圆点时间:2026-11-16 13:19:43浏览:540

本文详细介绍如何使用原生JavaScript与HTML5 Canvas绘制安全、美观的图形验证码。涵盖字符集过滤、随机坐标与角度变换、干扰线与噪点绘制、高清屏适配及交互校验完整代码。

怎么用原生JavaScript和Canvas绘制图形验证码
缩略图:原生 JavaScript & Canvas 图形验证码技术方案全景示意
在前端界面中实现图形验证码,核心做法是在 HTML 中创建 <canvas> 画布,利用 2D 绘图上下文(CanvasRenderingContext2D)按顺序执行四步操作:填充随机淡色背景、随机选取去除了易混淆字符的文本序列、逐个对字符进行旋转倾斜并绘制、叠加随机干扰线与噪点圆斑。本文提供一套无需外部依赖的原生实现方案,配合坐标变换原理与完整代码,帮助读者快速落地图形验证码。

一、准备画布与整体生成流程

使用 Canvas 绘制验证码时,必须区分“画布固有像素尺寸”与“CSS 呈现尺寸”。如果在 CSS 中直接设置宽和高,Canvas 会默认以 300×150 像素按比例拉伸,导致绘制出来的字符和线条出现模糊失真。因此,应在 <canvas> 标签或 JavaScript 中显式指定 width 和 height 属性。

图形验证码的生成过程遵循清晰的图层叠加顺序。先绘制底层的背景色块,接着在中间层绘制带有随机倾斜角度的字符,最后在顶层覆盖随机分布的线条和斑点,从而形成不易被简单脚本直接识别的视觉干扰。

怎么用原生JavaScript和Canvas绘制图形验证码
图1:Canvas 图形验证码五步绘制流水线与图层叠加架构

二、构建字符池与随机数工具函数

验证码字符集的设计需要兼顾辨识度与随机性。许多读者在使用验证码时经常遇到将数字 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(),字符会绕着画布左上角转动,直接飞出画布可视范围。

正确的旋转解法分为四步:

  1. 调用 ctx.save() 保存当前的绘图环境状态。
  2. 调用 ctx.translate(x, y) 将坐标系原点移至当前字符的中心位置。
  3. 调用 ctx.rotate(angle) 围绕新的中心点旋转指定弧度。
  4. 调用 ctx.fillText(char, 0, 0) 并在绘制完成后调用 ctx.restore() 恢复原始坐标系统。
怎么用原生JavaScript和Canvas绘制图形验证码
图2:通过 translate 平移与 rotate 局部旋转避免字符偏离可视画布

四、绘制防识别干扰线与随机噪点

如果验证码画面中只有清晰的字符,普通的边缘检测或轮廓分割即可将字符分离。加入干扰线和噪点的目的,在于打断连续的单色边缘,增加机器自动化分割与二值化的复杂度。

  • 随机干扰线:在画布边界范围内生成若干条起点和终点随机的线段,调用 beginPath()、moveTo()、lineTo() 与 stroke() 完成绘制。线段颜色应采用半透明或中等对比度,线宽保持在 1 到 1.5 像素,避免把文字完全遮挡导致读者无法辨认。
  • 随机噪点圆斑:在整个画布上随机布设数十个小圆点,使用 arc(x, y, radius, 0, 2 * Math.PI) 并填充半透明颜色。散落的点状噪点可有效干扰基于像素连通域的字符分离算法。
怎么用原生JavaScript和Canvas绘制图形验证码
图3:干扰线与噪点算法参数控制与视觉防机读机制

五、完整代码实现与组件封装

为了便于在页面或表单中直接调用,我们将验证码生成逻辑封装为一个独立的 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>

六、交互校验生命周期与状态流转

在实际页面中,验证码的生命周期不仅包含首次绘制,还与用户的点击刷新、表单提交重试以及重置流程紧密关联。以下图示梳理了前端验证码完整的状态变化图:

怎么用原生JavaScript和Canvas绘制图形验证码
图4:验证码生成、校验成功与失败重置的状态机流转

七、常见问题排查与关键注意事项

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 进行服务端校验。

作者最新文章
相关文章
更多