ASP.NET Core使用SkiaSharp实现验证码：详细技术指南

目录#

引言
为什么选择SkiaSharp？
环境准备
核心实现步骤
集成到ASP.NET Core
- 5.1 创建验证码端点
- 5.2 验证码存储与验证
最佳实践与安全性
完整示例代码
结论
参考资源

为什么选择SkiaSharp？#

跨平台支持：基于Google的Skia引擎，支持Windows/Linux/macOS
高性能渲染：原生GPU加速的矢量图形绘制
轻量级：相比System.Drawing，不依赖GDI+，更适合容器化部署
开源免费：MIT许可证，可商用

环境准备#

创建ASP.NET Core项目：
```
dotnet new webapi -n CaptchaDemo
```

安装NuGet包：

dotnet add package SkiaSharp
dotnet add package SkiaSharp.NativeAssets.Linux  # Linux部署必备

验证环境：

var skiaVersion = SKVersionInfo.NativeVersion; // 输出SkiaSharp版本

核心实现步骤#

4.1 生成随机验证码文本#

public static string GenerateRandomText(int length = 6)
{
    const string validChars = "ABCDEFGHJKLMNPQRSTUVWXYZ23456789"; // 排除易混淆字符
    var random = new Random();
    return new string(Enumerable.Repeat(validChars, length)
        .Select(s => s[random.Next(s.Length)]).ToArray());
}

4.2 使用SkiaSharp绘制验证码#

public byte[] GenerateCaptchaImage(string captchaText, int width = 200, int height = 80)
{
    using var surface = SKSurface.Create(new SKImageInfo(width, height));
    var canvas = surface.Canvas;
    canvas.Clear(SKColors.White); // 设置白色背景
 
    // 绘制验证码文本（随机颜色和旋转）
    using var paint = new SKPaint { TextSize = 36, IsAntialias = true };
    var random = new Random();
    float x = 20;
 
    foreach (char c in captchaText)
    {
        paint.Color = new SKColor(
            (byte)random.Next(0, 128),
            (byte)random.Next(0, 128),
            (byte)random.Next(0, 128));
        
        canvas.Save();
        canvas.Translate(x, height / 2 + random.Next(-10, 10));
        canvas.RotateDegrees(random.Next(-25, 25));
        canvas.DrawText(c.ToString(), 0, 0, paint);
        canvas.Restore();
        
        x += paint.FontSpacing * 0.8f;
    }
 
    // 转换为PNG图片流
    using var image = surface.Snapshot();
    using var data = image.Encode(SKEncodedImageFormat.Png, 80);
    return data.ToArray();
}

4.3 添加干扰元素增强安全性#

// 添加噪点
for (int i = 0; i < 100; i++)
{
    paint.Color = new SKColor(200, 200, 200);
    canvas.DrawCircle(
        random.Next(width), 
        random.Next(height), 
        2, 
        paint);
}
 
// 添加干扰线
for (int i = 0; i < 5; i++)
{
    paint.Color = new SKColor(
        (byte)random.Next(150, 200),
        (byte)random.Next(150, 200),
        (byte)random.Next(150, 200));
    paint.StrokeWidth = 1;
    
    canvas.DrawLine(
        random.Next(width),
        random.Next(height),
        random.Next(width),
        random.Next(height),
        paint);
}

集成到ASP.NET Core#

5.1 创建验证码端点#

[HttpGet("captcha")]
public IActionResult GetCaptcha()
{
    // 生成验证码文本
    string captchaText = CaptchaGenerator.GenerateRandomText();
    
    // 将验证码存储在Session（或分布式缓存）
    HttpContext.Session.SetString("Captcha", captchaText);
    
    // 生成图片字节流
    byte[] imageBytes = _captchaGenerator.GenerateCaptchaImage(captchaText);
    
    return File(imageBytes, "image/png");
}

5.2 验证码存储与验证#

Session存储配置（Startup.cs）：

services.AddSession(options => {
    options.IdleTimeout = TimeSpan.FromMinutes(5);
    options.Cookie.HttpOnly = true;
});

验证用户输入：

[HttpPost("validate")]
public IActionResult ValidateCaptcha([FromForm] string userInput)
{
    var storedCaptcha = HttpContext.Session.GetString("Captcha");
    
    if (string.IsNullOrEmpty(storedCaptcha) || 
        !storedCaptcha.Equals(userInput, StringComparison.OrdinalIgnoreCase))
    {
        return BadRequest("验证码错误");
    }
    
    return Ok("验证成功");
}

最佳实践与安全性#

分布式环境存储
- 生产环境使用Redis代替Session：
```
services.AddStackExchangeRedisCache(options => {...});
```

验证码时效性

// 设置验证码5分钟过期
HttpContext.Session.SetString("Captcha", captchaText);
HttpContext.Session.SetInt32("CaptchaExpire", DateTimeOffset.Now.AddMinutes(5).ToUnixTimeSeconds());

安全增强措施
- 频率限制：防止暴力破解（使用AspNetCoreRateLimit包）
- 动态复杂度：根据风险评估调整字符长度
- 前端交互安全：禁止图片URL直接暴露验证码值
性能优化
- 图片缓存：对相同验证码文本复用图片（内存缓存）
- 资源复用：静态SKPaint对象（线程安全前提下）

完整示例代码#

查看GitHub仓库获取完整项目：
https://github.com/example/captcha-demo

结论#

使用SkiaSharp在ASP.NET Core中实现验证码兼具高性能和跨平台优势。关键点包括：

通过随机文本扭曲和干扰元素提升识别难度
结合分布式缓存保障验证码状态可靠性
采用速率限制等安全策略防御自动化攻击

目录#

为什么选择SkiaSharp？#

环境准备#

核心实现步骤#

4.1 生成随机验证码文本#

4.2 使用SkiaSharp绘制验证码#

4.3 添加干扰元素增强安全性#

集成到ASP.NET Core#

5.1 创建验证码端点#

5.2 验证码存储与验证#

最佳实践与安全性#

完整示例代码#

结论#

参考资源#