匿名用户 Fingerprint 使用指南
本文档说明如何在应用中使用fingerprint功能来管理匿名用户。
功能概述
- 自动fingerprint生成：为每个访问者生成唯一的浏览器指纹ID
- 匿名用户管理：自动创建匿名用户记录并分配50免费积分
- 数据持久化：fingerprint存储在localStorage和cookie中
- 中间件集成：自动在请求中识别和传递fingerprint ID
- Clerk集成: 提供适配组件完成Clerk用户数据传递
核心组件
API端点
初始化匿名用户
获取匿名用户信息
中间件集成
中间件自动处理fingerprint ID的提取和验证：
使用场景
GGSmida
数据流程详解
FingerprintID生成和降级策略详解
客户端指纹生成流程
降级策略触发条件
服务端提取和验证逻辑
ID格式验证规则
关键执行时序说明
匿名用户重复初始化问题排查记录
问题现象
业务边界
根因分析
为什么 React Context 没有阻止这个问题
改造方案
本次采用“前端减重复 + 后端强幂等”的双保险方案。