在 Java 项目中使用 Redis 统计网站的 UV（独立访客数），我们可以利用 Redis 提供的 HyperLogLog 数据结构。HyperLogLog 适合用来做基数统计，它在空间复杂度上非常高效，可以在存储大量数据的情况下，提供非常接近真实的结果。
下面是如何在 Java 项目中使用 Redis 来统计网站的 UV 的详细步骤和代码示例：
1. 添加 Redis 依赖
首先，确保你的项目中引入了 Redis 相关的依赖。如果是 Spring Boot 项目，直接在 pom.xml 中添加如下依赖：
<dependencies><!-- Spring Boot Redis Starter --><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-data-redis</artifactId></dependency>
</dependencies>
2. 配置 Redis 连接
在 application.properties 或 application.yml 文件中配置 Redis 的连接信息：
application.properties 示例：
spring.redis.host=localhost
spring.redis.port=6379
spring.redis.password=pwd (如果有密码)
spring.redis.database=0
3. 创建 Redis 配置类（可选）
如果需要自定义 Redis 连接池或其他配置，可以创建一个配置类：
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.data.redis.connection.RedisConnectionFactory;
import org.springframework.data.redis.core.RedisTemplate;
import org.springframework.data.redis.serializer.StringRedisSerializer;@Configuration
public class RedisConfig {@Beanpublic RedisTemplate<String, String> redisTemplate(RedisConnectionFactory redisConnectionFactory) {RedisTemplate<String, String> template = new RedisTemplate<>();template.setConnectionFactory(redisConnectionFactory);template.setKeySerializer(new StringRedisSerializer());template.setValueSerializer(new StringRedisSerializer());return template;}
}
4. 创建 Redis 服务类
接下来，我们需要创建一个服务类，用来封装 Redis 操作，特别是 HyperLogLog 的操作：
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.data.redis.core.RedisTemplate;
import org.springframework.stereotype.Service;@Service
public class RedisUvService {@Autowiredprivate RedisTemplate<String, String> redisTemplate;// Redis 中保存 UV 数据的 keyprivate static final String UV_KEY = "uv_count";/*** 记录用户的访问（每次用户访问时调用此方法）* @param userId 用户唯一标识（例如用户ID、IP、浏览器指纹等）*/public void recordUv(String userId) {redisTemplate.opsForHyperLogLog().add(UV_KEY, userId);}/*** 获取当前的独立访客数（UV）* @return 返回当前的独立访客数*/public Long getUvCount() {return redisTemplate.opsForHyperLogLog().size(UV_KEY);}
}
5. 创建 Controller
接着，可以创建一个简单的 Controller，用于暴露 HTTP 接口，前端可以通过这些接口记录访问和获取 UV 统计结果：
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;@RestController
@RequestMapping("/uv")
public class UvController {@Autowiredprivate RedisUvService redisUvService;/*** 记录用户访问* @param userId 用户的唯一标识* @return 操作结果*/@GetMapping("/record")public String recordUv(String userId) {redisUvService.recordUv(userId);return "User " + userId + " recorded.";}/*** 获取当前的独立访客数（UV）* @return 当前的 UV 数量*/@GetMapping("/count")public Long getUvCount() {return redisUvService.getUvCount();}
}
6. 如何工作
- 记录用户访问：当一个用户访问网站时，前端或后端可以通过
recordUv(userId)方法，将用户的唯一标识（例如userId）传入 Redis 进行记录。这里的userId可以是任意唯一标识，比如用户ID、IP 地址、设备指纹等。 - 获取 UV 统计结果：通过访问
getUvCount()方法，可以获取当前的独立访客数（UV）。
7. 测试流程
- 启动 Spring Boot 项目。
- 使用 Postman 或浏览器访问
http://localhost:8080/uv/record?userId=user1来记录一个用户访问。 - 使用
http://localhost:8080/uv/count查看当前的独立访客数（UV）。
8. HyperLogLog 优势
- 空间效率：HyperLogLog 只需要固定的内存空间来统计非常大的基数，适合用来做大规模数据统计，如 UV 统计。
- 估算误差：虽然 HyperLogLog 是近似算法，但它的误差通常在 1% 以内，非常适合用于统计 UV 这样的任务。
- 高效：即使是亿级网站的数据，HyperLogLog 也能够以常量空间和高效的速度进行估算。
9. 总结
使用 Redis 的 HyperLogLog 数据结构统计网站的 UV 是一种非常高效且节省内存的方式。通过上面的代码示例，你可以轻松地在 Spring Boot 项目中实现这一功能。每次用户访问时，只需将其唯一标识存入 Redis，最终通过 HyperLogLog 统计获得独立访客数（UV），可以在亿级用户量下保持高效和准确。
