1. Spring Security集成手机验证码登录的核心思路在传统Web应用中用户名密码认证是最常见的登录方式。但随着移动互联网的发展手机验证码登录因其便捷性和安全性逐渐成为主流方案。Spring Security作为Java生态中最成熟的安全框架其默认实现主要围绕表单登录和OAuth2展开。要实现手机验证码登录我们需要理解其核心认证流程认证流程差异表单登录用户提交用户名密码 → 服务端校验凭证 → 颁发会话验证码登录用户提交手机号 → 发送验证码 → 校验验证码 → 颁发会话架构扩展点AuthenticationFilter拦截登录请求AuthenticationToken封装认证凭证AuthenticationProvider执行认证逻辑UserDetailsService加载用户信息关键点Spring Security的插件化设计允许我们通过实现上述组件来扩展认证方式而无需修改框架核心代码。2. 完整实现步骤详解2.1 基础环境准备首先确保项目中已集成Spring Security基础依赖dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-security/artifactId /dependency2.2 验证码发送服务实现验证码服务需要包含以下核心功能public interface SmsCodeService { // 生成并发送验证码 String sendCode(String phone); // 验证码校验 boolean verifyCode(String phone, String code); }典型实现方案选择内存存储使用ConcurrentHashMap临时存储适合开发环境Redis存储生产环境推荐方案设置TTL自动过期第三方服务阿里云短信、腾讯云短信等商业服务实测建议验证码有效期建议设置为5分钟长度6位数字即可平衡安全性与用户体验。2.3 自定义认证组件开发2.3.1 认证令牌(SmsCodeAuthenticationToken)public class SmsCodeAuthenticationToken extends AbstractAuthenticationToken { private final Object principal; // 手机号 private String code; // 验证码 public SmsCodeAuthenticationToken(String phone, String code) { super(null); this.principal phone; this.code code; setAuthenticated(false); } // 实现父类抽象方法 Override public Object getCredentials() { return code; } Override public Object getPrincipal() { return principal; } }2.3.2 认证过滤器(SmsCodeAuthenticationFilter)public class SmsCodeAuthenticationFilter extends AbstractAuthenticationProcessingFilter { public SmsCodeAuthenticationFilter() { super(new AntPathRequestMatcher(/login/sms, POST)); } Override public Authentication attemptAuthentication( HttpServletRequest request, HttpServletResponse response ) throws AuthenticationException { String phone obtainPhone(request); String code obtainCode(request); SmsCodeAuthenticationToken authRequest new SmsCodeAuthenticationToken(phone, code); return this.getAuthenticationManager().authenticate(authRequest); } private String obtainPhone(HttpServletRequest request) { return request.getParameter(phone); } private String obtainCode(HttpServletRequest request) { return request.getParameter(code); } }2.3.3 认证处理器(SmsCodeAuthenticationProvider)public class SmsCodeAuthenticationProvider implements AuthenticationProvider { private final UserDetailsService userDetailsService; private final SmsCodeService smsCodeService; Override public Authentication authenticate(Authentication authentication) { String phone (String) authentication.getPrincipal(); String code (String) authentication.getCredentials(); // 验证码校验 if (!smsCodeService.verifyCode(phone, code)) { throw new BadCredentialsException(验证码错误或已过期); } // 加载用户信息 UserDetails user userDetailsService.loadUserByUsername(phone); if (user null) { throw new UsernameNotFoundException(手机号未注册); } // 返回认证成功的Token SmsCodeAuthenticationToken result new SmsCodeAuthenticationToken(user, null, user.getAuthorities()); result.setDetails(authentication.getDetails()); return result; } Override public boolean supports(Class? authentication) { return SmsCodeAuthenticationToken.class.isAssignableFrom(authentication); } }2.4 Spring Security配置整合Configuration EnableWebSecurity public class SecurityConfig extends WebSecurityConfigurerAdapter { Autowired private UserDetailsService userDetailsService; Autowired private SmsCodeService smsCodeService; Override protected void configure(HttpSecurity http) throws Exception { http .authorizeRequests() .antMatchers(/code/sms).permitAll() .anyRequest().authenticated() .and() .formLogin().disable() .addFilterAt( smsCodeAuthenticationFilter(), UsernamePasswordAuthenticationFilter.class ); } Bean public SmsCodeAuthenticationFilter smsCodeAuthenticationFilter() throws Exception { SmsCodeAuthenticationFilter filter new SmsCodeAuthenticationFilter(); filter.setAuthenticationManager(authenticationManagerBean()); filter.setAuthenticationSuccessHandler(new SimpleUrlAuthenticationSuccessHandler(/)); filter.setAuthenticationFailureHandler(new SimpleUrlAuthenticationFailureHandler(/login?error)); return filter; } Override protected void configure(AuthenticationManagerBuilder auth) { auth.authenticationProvider(smsCodeAuthenticationProvider()); } Bean public SmsCodeAuthenticationProvider smsCodeAuthenticationProvider() { return new SmsCodeAuthenticationProvider(userDetailsService, smsCodeService); } }3. 生产环境进阶优化3.1 安全防护措施防刷机制同一手机号发送间隔限制建议≥60秒每日发送次数限制建议≤10次IP频率限制如1分钟不超过30次请求// 示例使用Redis实现发送频率控制 public String sendCodeWithRateLimit(String phone) { String redisKey sms:limit: phone; Long count redisTemplate.opsForValue().increment(redisKey); if (count ! null count 1) { redisTemplate.expire(redisKey, 1, TimeUnit.MINUTES); } if (count 3) { throw new BusinessException(操作过于频繁请稍后再试); } return sendCode(phone); }验证码安全性禁止使用连续数字如123456避免使用生日等易猜测组合服务端校验后立即失效验证码3.2 用户体验优化前端集成方案!-- 示例带倒计时功能的发送按钮 -- button idsendBtn onclicksendCode()获取验证码/button script let countdown 60; function sendCode() { if (!validatePhone()) return; // 禁用按钮并开始倒计时 const btn document.getElementById(sendBtn); btn.disabled true; const timer setInterval(() { btn.textContent ${countdown}秒后重试; if (--countdown 0) { clearInterval(timer); btn.disabled false; btn.textContent 获取验证码; countdown 60; } }, 1000); // 调用后端API发送验证码 fetch(/code/sms?phone phone) .then(response response.json()) .then(data console.log(发送成功)); } /script错误处理建议区分验证码错误和验证码过期提示验证码输入错误超过3次强制刷新提供语音验证码备用方案4. 常见问题排查指南4.1 典型问题与解决方案问题现象可能原因解决方案认证过滤器未生效过滤器顺序配置错误确保addFilterAt替换了默认表单过滤器验证码校验总是失败Redis TTL设置过短检查Redis键过期时间是否≥验证码有效期获取用户信息报空指针手机号未注册实现UserDetailsService自动注册逻辑跨域问题安全配置冲突在HttpSecurity中配置.cors()4.2 调试技巧开启DEBUG日志logging.level.org.springframework.securityDEBUG认证流程跟踪在SmsCodeAuthenticationProvider中添加断点使用Postman模拟请求POST /login/sms?phone13800138000code123456组件检查清单过滤器是否注册到Spring Security链Provider是否实现了supports()方法Token是否正确实现了getCredentials()和getPrincipal()5. 架构演进方向对于需要支持多种登录方式的大型系统建议采用策略模式进行抽象public interface LoginStrategy { Authentication authenticate(LoginRequest request); } Service public class LoginStrategyFactory { private final MapLoginType, LoginStrategy strategies; public LoginStrategy getStrategy(LoginType type) { return strategies.get(type); } } // 使用示例 public AuthResult login(LoginRequest request) { LoginStrategy strategy factory.getStrategy(request.getType()); return strategy.authenticate(request); }这种架构可以轻松扩展微信登录、指纹登录等新型认证方式同时保持核心业务逻辑的稳定性。
企业数字化 ERP 产品动态
相关推荐
桌面文件误删怎么办?这6款恢复工具,简单操作高效找回 在数字时代,电脑桌面是我们最常存放文件的地方,却也成为误操作的高发区。一不小心,重要文档、珍贵照片就可能被删除。调查显示,超过60%的用户曾因误删、系统故障或病毒攻击丢失过桌面文件,不仅影响工作,更可… · 2026/7/27 3:35:46
MongoDB实战避坑指南:从环境搭建到查询优化的21个真实问题 1. 这不是又一篇“安装就完事”的MongoDB入门文——它是一份能让你在真实项目里少踩三天坑的实操手记MongoDB Tutorial:How to Set Up and Query MongoDB Databases——这个标题背后藏着太多被教程刻意忽略的现实断层。我带过六支后端团队,从电商秒杀系统… · 2026/9/21 4:51:03
2026 年版 AI 行业深度解析:普通人零基础也能入局大模型赛道 不少程序员、转行上班族刷资讯时,都会被日新月异的 AI 技术刷屏,随之滋生强烈的技能迭代焦虑。但 AI 工具本身不存在善恶之分,决定权始终握在使用者手中。眼下整个 AI 行业群雄逐鹿、赛道混战,看似乱象丛生,实则是普通… · 2026/7/28 1:45:41
南昌红谷滩电工证过期了不知道怎么复审延期?良心建议帮你搞懂全流程 南昌红谷滩电工证过期了不知道怎么复审延期?良心建议帮你搞懂全流程 证书过期了不知道怎么复审延期?你不是一个人。很多电工从业者因为忙于工作、对流程不熟悉,导致电工证过期后不知道如何处理,甚至错过了重新考证的黄金时间。今天就从【南昌红谷滩电工证… · 2026/11/20 8:28:56
电工作业证是什么样的 在哪考的证能全国通用吗 电工作业证是什么样的 在哪考的证能全国通用吗 之前考的证在外省能不能转过来?这个问题几乎每个打算报考电工作业证的人都问过。特别是像我们这种在濮阳从事水利工程的工人,经常需要跨省施工,手里那本电工作业证要是只能在本地用,那可就麻烦大了。今天咱… · 2026/11/20 8:28:56
西安电工证在哪里办理 2026河南最新政策下怎么搞 西安电工证在哪里办理 2026河南最新政策下怎么搞 急需特种作业证才能上岗找工作,这事儿别拖。2026年河南最新政策落地后,特种作业证的报考、复审、补办流程都出现了新变化,尤其是像西安这样的城市,电工证的办理流程和政策要求,直接影响你能不能… · 2026/11/20 8:28:55
贵州住建局电工证复审怎么操作?考前押题能帮你少走弯路 贵州住建局电工证复审怎么操作?考前押题能帮你少走弯路 你缺的是电工证,缺的是上岗资格,缺的是能让你顺利拿到工资的通行证。特别是那些刚出校门、正在找工作的你, 急需特种作业证才能上岗找工作 ,但又对流程、政策一知半解。别慌,今天就从… · 2026/11/20 8:27:55
长春初级电工证怎么考?通过率揭秘全在这里 长春初级电工证怎么考?通过率揭秘全在这里 之前考的证在外省能不能转过来?这几乎是每个想从事电工工作的人都会问的问题。特别是那些在外地打拼多年、手里握着一张“外地电工证”的人,到了长春想继续干这一行,第一反应就是“我的证能用吗?”。今天我们就… · 2026/11/19 16:06:02
国内电工证报考条件与考试时间 低压电工证怎么考?学历不高也能报名,官方报名入口全在这 你是不是经常听说“电工证是入行门槛”,但又担心自己学历不够、经验不足,根本报不了名?别急,今天就带你从零了解【国内电工证】的报考流程、考试内容,还有怎么在 官方报名入口… · 2026/11/19 17:40:37
电工作业时如何断电?电子证书到底能不能全国通用? 电工作业时如何断电?电子证书到底能不能全国通用? 实操考试心里没底怕挂科,特别是电工作业时如何断电这一操作,不仅关系到你能不能拿到证书,更关系到以后能不能顺利上岗。很多人觉得这不过就是“断个电”,但其实这里面的门道可不少,稍有不慎就可能出错… · 2026/11/19 17:50:07
建设厅特种工周三报名怎么弄?上岗必备别被中介坑 建设厅特种工周三报名怎么弄?上岗必备别被中介坑 不知道去哪报名怕被中介坑?作为商丘某高校工程类应届毕业生,小李最近就遇到了这样的困扰。他刚毕业,正在找实习岗位,发现很多工地都要求持有特种作业操作证,尤其是【建设厅特种工周三报名】这个时间点,… · 2026/11/20 0:00:54
中专考的中级电工证内部消息全攻略 中专考的中级电工证内部消息全攻略 你中专毕业,手头有中级电工证,但不知道从哪开始报名,怕被中介坑?别急,这篇文章就是为你量身定制的“内部消息”,帮你避开报名陷阱,稳稳拿到证书。… · 2026/11/20 0:00:54
外省电工证能转过来吗?电子证书怎么查电工作业教学效果评价 外省电工证能转过来吗?电子证书怎么查电工作业教学效果评价 之前考的证在外省能不能转过来?这几乎是所有在外地打拼的电工从业者最关心的问题。特别是像洛阳这样的工业城市,很多电工证是在外地考的,现在想在当地用,流程是不是很复杂?其实,只要搞清楚… · 2026/11/20 0:00:54
双极步进电机控制实战:DRV8818PWPR与PIC18F86K22驱动调试 /* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/19 6:33:25
STM32F207ZG + DRV8818PWPR 步进电机驱动实战解析 /* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/19 6:33:32
DRV8818PWPR+dsPIC30F4013工业级双极步进电机控制方案 /* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/19 0:22:38