news 2026/6/10 15:19:10

【Spring】实现验证码功能

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
【Spring】实现验证码功能

验证码功能

引入第三方Hutool工具包

Hutool工具是一个开源的Java工具依赖库,封装了许多功能,访问https://hutool.cn,按图中引入依赖即可使用,具体功能可查看官方文档~

<dependency><groupId>cn.hutool</groupId><artifactId>hutool-all</artifactId><version>5.8.42</version></dependency>

实现功能

以下是参考文档代码,以写出到浏览器(Servlet输出)为栗子

ICaptchacaptcha=...;captcha.write(response.getOutputStream());//Servlet的OutputStream记得自行关闭哦!

执行流程

验证码的服务主要由后端实现,前端只负责发起请求,且验证码的答案一般存于内存/Redis中,这里以Hutool工具实现

  1. 前端发起GET请求
  2. 后端:
  • 利用Hutool工具生成一张图片验证码
  • 将验证码密码放入Session / Redis 中,这里放入Session举栗子
  • 加入验证条件:有效时间
  1. 前端拿到图片,将用户输入一起POST到后端
  2. 后端校验,返回对应的值

细节问题

线程安全

http是无状态的,后端接口之间/captcha/getCaptcha​与/captcha/check是独立的,内容无法共享数据,那需要校验的时候如何拿到验证码呢?

/getCaptcha​接口的成员变量与/check是不共享的,以线程安全角度来说,以下两个方法都是不可取的

  1. 直接声明一个成员变量

在类里声明成员变量,如果多次请求/getCaptcha接口,用户1生成了验证码1,用户2生成了验证码2,成员变量验证码1变化为验证码2,如果这时候用户1拿着正确的验证码1进行校验,肯定是失败的

  1. 交给Spring管理

Spring管理的是Bean成员对象,且这个对象是单例的,所以也有线程安全问题

  • 解决方法

我们可以使用Session存储,Session保证了对话安全,每个用户都有单独的会话id,把验证码存储到Session中,生成与校验都能通过Session操作存入/拿出

考虑线程安全问题的场景

  1. 对象有没有数据共享
  2. 主动创建线程(池)的时候

时间戳

项目开发中,时间的处理和表示通常使用时间戳,能解决跨时区的问题,实现了前后端 UI 解耦,计算也更加便捷

参数配置

学到Spring就要充分用到管理对象的功能,但是有些时候参数的注入过于繁琐,如需要构造一个图片类型的验证码,需要传入width​、height、验证码长度、干扰因子等等,这些固定参数通常需要放到配置文件中管理,起到解耦作用

那注入这么多参数,代码非常不美观,故又想到将配置参数转换为一个对象,从对象中去取,就更加优雅了~

举个栗子,这是构造图片验证码的代码

参数放在application.yaml文件中

由于注入的时候要一个一个取,非常麻烦,类似于:

@Value("${captcha.width}")privateStringwidth;@Value("${captcha.height}")privateStringheight;@Value("${captcha.codeCount}")privateStringcodeCount;@Value("${captcha.lineCount}")privateStringlineCount;

创建CaptchaProperties类来对配置对象进行管理

@Component@Data@ConfigurationProperties(prefix="captcha")publicclassCaptchaProperties{privateIntegerwidth;privateIntegerheight;privateIntegercodeCount;privateIntegerlineCount;}

CaptchaController​层面中,构造对象的时候只需注入CaptchaProperties对象,通过取对象中的成员得到值

@AutowiredprivateCaptchaPropertiesproperties;// 定义图形验证码的长和宽LineCaptchacaptcha=CaptchaUtil.createLineCaptcha(properties.getWidth(),properties.getHeight(),properties.getCodeCount(),properties.getLineCount());

常量处理

开发中,管理常量的成员一般存入constant​包中,交给Constant类管理

实现代码

控制层

@RestController@RequestMapping("/captcha")publicclassCaptchaController{@AutowiredprivateCaptchaPropertiesproperties;// 生成验证码@RequestMapping("/getCaptcha")publicvoidgetCaptcha(HttpServletResponseresponse,HttpSessionsession)throwsIOException{// 定义图形验证码的长和宽LineCaptchacaptcha=CaptchaUtil.createLineCaptcha(properties.getWidth(),properties.getHeight(),properties.getCodeCount(),properties.getLineCount());//告知浏览器处理响应以作为图片显示response.setContentType("image/jpeg");// 设置session (验证码内容 + 有效时间)session.setAttribute(properties.getSession().getName(),captcha.getCode());// 保存验证码内容session.setAttribute(properties.getSession().getDate(),System.currentTimeMillis());// 使用时间戳try{// 验证码写出到浏览器captcha.write(response.getOutputStream());}catch(IOExceptione){thrownewRuntimeException(e);}finally{//Servlet的OutputStream记得自行关闭response.getOutputStream().close();}}/** * 如何存储验证码?局部变量nonono!多线程下会修改 * 变成对象交给Spring管理也不行,管理的Bean是单例的,多线程下也能修改 * 把验证码存到session当中,需要用就取出来即可 * @param captcha 用户输入的验证码 * @return 布尔值 */// 校验验证码@RequestMapping("/check")publicbooleancheck(HttpSessionsession,Stringcaptcha){if(!StringUtils.hasLength(captcha))returnfalse;// 获取session内的验证码Stringcode=(String)session.getAttribute(properties.getSession().getName());// 获取验证码生成时间LongcaptchaTime=(Long)session.getAttribute(properties.getSession().getDate());if(!StringUtils.hasLength(code)||captchaTime==null)returnfalse;// 校验验证码超时时间——5min 可以使用常量表示5*60*1000 常量类放到constant包中if(System.currentTimeMillis()-captchaTime>CAPTCHA_TIME_OUT)returnfalse;returncaptcha.equalsIgnoreCase(code);}}

实例层(ConfigurationProperties、Session)

@Component@Data@ConfigurationProperties(prefix="captcha")publicclassCaptchaProperties{privateSessionsession;privateIntegerwidth;privateIntegerheight;privateIntegercodeCount;privateIntegerlineCount;}@DatapublicclassSession{privateStringname;privateStringdate;}

常量层

publicclassConstant{publicstaticfinalintCAPTCHA_TIME_OUT=5*60*1000;}

‍希望对你有所帮助,让我们变得更强!

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/6/10 11:34:06

6、Linux 文件与目录操作及搜索压缩全攻略

Linux 文件与目录操作及搜索压缩全攻略 1. 文件与目录操作基础 在 Linux 系统中,对文件和目录的操作是日常使用的基础,包括创建、删除、移动和复制等操作。这些操作不仅可以通过图形界面完成,使用命令行操作也十分高效。 1.1 创建文件 使用 touch 命令 : touch 命令…

作者头像 李华
网站建设 2026/6/10 11:33:07

21、畅享Linux:音乐与游戏的休闲时光

畅享Linux:音乐与游戏的休闲时光 在紧张的学习或工作之余,放松身心、享受乐趣是必不可少的。而在Linux系统中,我们有多种方式来实现这一目标,比如播放音乐CD和畅玩各类游戏。接下来,就让我们一同探索Linux系统中的音乐播放与游戏世界。 音乐播放 在Linux系统中,有多个音…

作者头像 李华
网站建设 2026/6/10 11:34:13

15、数字取证中的存储介质成像技术详解

数字取证中的存储介质成像技术详解 一、可进行块或字符访问的其他设备 在 Linux 内核环境中,能够被识别为块设备的任何设备都可以进行成像操作。不同设备呈现为块设备的方式有所不同: 1. 即插即用型 :部分设备在连接到主机系统的瞬间就会以块设备的形式出现,像常见的 …

作者头像 李华
网站建设 2026/6/10 11:44:19

谷歌Gemma 3系列震撼发布:270M轻量模型引领多模态AI普及新纪元

在人工智能技术迅猛发展的今天&#xff0c;大型语言模型的参数规模似乎成了衡量性能的重要标准&#xff0c;动辄数十亿甚至千亿的参数让许多开发者和企业望而却步。然而&#xff0c;谷歌近日推出的Gemma 3系列模型却剑走偏锋&#xff0c;以轻量级开源多模态模型的定位&#xff…

作者头像 李华
网站建设 2026/6/9 17:17:17

多模态AI新突破:Lumina-DiMOO开源模型重构跨模态交互范式

多模态AI新突破&#xff1a;Lumina-DiMOO开源模型重构跨模态交互范式 【免费下载链接】Lumina-DiMOO 项目地址: https://ai.gitcode.com/hf_mirrors/Alpha-VLLM/Lumina-DiMOO 在人工智能多模态交互领域&#xff0c;一场静默的技术革命正在悄然发生。近日&#xff0c;由…

作者头像 李华