【亲测免费】 天爱验证码项目常见问题解决方案

1. 项目基础介绍和主要的编程语言

天爱验证码（tianai-captcha） 是一个基于 Java 实现的开源行为验证码项目，旨在提供多种验证码类型，包括滑块验证码、点选验证码、行为验证码和旋转验证码等。该项目的目标是为 Java 开发者提供一个高效、易用的验证码解决方案，适用于各种需要验证码功能的应用场景。

主要的编程语言是 Java，项目依赖于 Maven 进行构建和管理。

2. 新手在使用这个项目时需要特别注意的3个问题及详细解决步骤

问题1：如何正确导入项目依赖？

解决步骤：

1. 确保你已经安装了 Maven，并且项目根目录下有 pom.xml 文件。
2. 在 pom.xml 文件中添加以下依赖：

   <dependency>
       <groupId>cloud.tianai.captcha</groupId>
       <artifactId>tianai-captcha</artifactId>
       <version>1.5.1</version>
   </dependency>
   

3. 在命令行中运行 mvn install 命令，确保依赖正确下载并安装到本地仓库。

问题2：如何生成和校验验证码？

解决步骤：

1. 创建一个 ImageCaptchaApplication 实例，用于生成和校验验证码。

   import cloud.tianai.captcha.validator.common.model.dto.MatchParam;
   import cloud.tianai.captcha.ImageCaptchaApplication;
   import cloud.tianai.captcha.TACBuilder;
   
   public class ApplicationTest {
       public static void main(String[] args) {
           ImageCaptchaApplication application = TACBuilder.builder()
               .addDefaultTemplate()
               .build();
   
           // 生成验证码
           CaptchaResponse<ImageCaptchaVO> res = application.generateCaptcha("SLIDER");
           System.out.println(res);
   
           // 校验验证码
           String id = res.getId();
           ImageCaptchaTrack imageCaptchaTrack = null; // 前端传来的轨迹数据
           ApiResponse<Void> valid = application.matching(id, new MatchParam(imageCaptchaTrack));
           System.out.println(valid.isSuccess());
       }
   }
   

2. 确保前端正确传递 ImageCaptchaTrack 数据，以便后端进行校验。

问题3：如何处理验证码的二次验证？

解决步骤：

1. 使用缓存工具（如 LocalCacheStore）来存储验证成功的 token。

   import cloud.tianai.captcha.cache.CacheStore;
   import cloud.tianai.captcha.cache.impl.LocalCacheStore;
   
   CacheStore cacheStore = new LocalCacheStore();
   if (valid.isSuccess()) {
       String token = UUID.randomUUID().toString();
       cacheStore.setCache(token, new AnyMap(), 5L, TimeUnit.MINUTES);
       // 将 token 返回给客户端
   }
   

2. 在客户端请求时，携带该 token 进行二次验证。
3. 后端根据 token 的有效性判断是否允许用户访问特定资源。

通过以上步骤，新手可以顺利解决在使用天爱验证码项目时遇到的常见问题。