【Java后端】Spring Boot 实现请求设备来源统计与UA解析全攻略

操作系统：iOS 16.0设备类型浏览器：Safari⚠️注意事项部分新版本浏览器已逐步弃用 UA，转向；UA 可伪造，统计结果仅供参考。@Component@Override= null) {// 操作系统// 设备// 浏览器log.info("设备来源统计: OS={}, Device={}, Browser={}", os, device, browser);// TODO: 写入 Red

柯南二号

663人浏览 · 2025-08-21 23:03:17

柯南二号 · 2025-08-21 23:03:17 发布

Spring Boot 实现请求设备来源统计与UA解析全攻略

在 Web 应用的实际场景中，我们经常需要知道 请求来自哪里 —— 是 Android 手机？还是 iOS？或者是 PC 浏览器？
这类信息往往可以通过 User-Agent (UA) 来统计，进而帮助我们分析用户画像、设备分布、埋点监控，甚至用于灰度发布。

本文将介绍如何在 Spring Boot 项目中，基于 UA 实现设备来源统计，并给出完整的代码与实践方案。

1. 背景与目标

需求背景
在业务中，我们想要统计：
- 多少用户来自 Android / iOS；
- 哪些浏览器访问最多（Chrome、Safari、Edge…）；
- 用户操作系统分布（Windows、Mac、Linux…）。
挑战
直接读取 UA 字符串可行，但 UA 本身复杂、可变且容易被伪造，不同厂商 UA 格式差异巨大。
因此，我们需要借助 UA 解析库 来进行标准化处理。

2. UA 与设备来源简介

UA 示例：

Mozilla/5.0 (iPhone; CPU iPhone OS 16_0 like Mac OS X) 
AppleWebKit/605.1.15 (KHTML, like Gecko) 
Version/16.0 Mobile/15E148 Safari/604.1

解析后可得：

操作系统：iOS 16.0
设备类型：Mobile（iPhone）
浏览器：Safari

⚠️ 注意事项：

部分新版本浏览器已逐步弃用 UA，转向 User-Agent Client Hints (UA-CH)；
UA 可伪造，统计结果仅供参考。

3. 技术方案设计

我们可以通过以下三步实现：

拦截请求
使用 HandlerInterceptor 或 Filter 统一拦截请求，提取 User-Agent 头。
解析 UA
借助开源库，如：
- ua-parser/uap-java
- YAUAA (Yet Another UserAgent Analyzer)
存储与统计
- 实时统计：放入 Redis 计数；
- 长期统计：写入 MySQL/ES，便于做 BI 报表。

流程图如下：

4. Spring Boot 实现步骤

4.1 引入依赖

以 ua-parser 为例：

<dependency>
    <groupId>ua_parser</groupId>
    <artifactId>ua-parser</artifactId>
    <version>1.4.3</version>
</dependency>

4.2 定义拦截器

@Component
public class UaInterceptor implements HandlerInterceptor {

    private final UserAgentParser parser = new UserAgentParser();

    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) {
        String uaString = request.getHeader("User-Agent");
        if (uaString != null) {
            Client client = parser.parse(uaString);

            String os = client.os.family;       // 操作系统
            String device = client.device.family; // 设备
            String browser = client.userAgent.family; // 浏览器

            log.info("设备来源统计: OS={}, Device={}, Browser={}", os, device, browser);

            // TODO: 写入 Redis / DB 做统计
        }
        return true;
    }
}

4.3 注册拦截器

@Configuration
public class WebConfig implements WebMvcConfigurer {
    @Autowired
    private UaInterceptor uaInterceptor;

    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        registry.addInterceptor(uaInterceptor).addPathPatterns("/**");
    }
}

5. 扩展优化

持久化统计
- 将统计结果写入 MySQL，做长期数据报表；
- 或接入 ELK/ClickHouse，做实时大屏展示。

Redis 实时计数

redisTemplate.opsForHash().increment("ua:os", os, 1);
redisTemplate.opsForHash().increment("ua:browser", browser, 1);
redisTemplate.opsForHash().increment("ua:device", device, 1);