不使用Spring-Mobile如何正确检测请求来源设备类型

所有检测逻辑全返回false，90%以上的根因是你根本没从请求里拿到正确的User-Agent值，先别急着换检测库，按下面步骤一步步查：

第一步：先确认拿到的UA真实值 #

别上来就做匹配判断，先把拿到的UA完整打日志：

String userAgent = request.getHeader("User-Agent");
System.out.println("完整User-Agent值：" + userAgent);

• 如果打印结果是null、空串，或者是Nginx、CDN、WAF这类网关的标识，说明UA在请求传输链路里被覆盖/删掉了，和检测代码没关系：
  • 查服务前置的网关、反向代理配置，看有没有头重写规则把User-Agent删了或者改了
  • 有代理配置的话，把User-Agent加到透传请求头白名单里
  • 本地用接口测试工具调试的话，记得手动加User-Agent头，这类工具默认不会带浏览器UA
• 如果打印出来的UA确实是正常的浏览器/移动端标识（比如模拟移动端时会带Mobile Safari字段，安卓真机UA会带Linux; Android、Mobi字段），再往下排查。

第二步：修正简易判断逻辑 #

你之前写的contains("Mobi")逻辑本身是对的，但有两个小问题：

• 硬编码单字段匹配漏判率极高，现在新出的设备、第三方浏览器UA变种很多，自己写规则很难覆盖全
• 极端场景下可能出现大小写不一致，判断时可以先统一转小写：userAgent.toLowerCase().contains("mobi")

第三步：换用维护中的成熟检测库，别手动拷源码 #

你之前直接拷mobileesp源码的方式很容易出问题：类依赖缺漏、常量初始化失败、规则版本过旧都会导致检测全错，而且这个项目已经很久没更新了，不建议继续用。
直接换社区持续维护的UA解析库就行，是替代停更的Spring-Mobile的最优方案：
如果是Maven项目，先在pom.xml引入依赖：

<dependency>
    <groupId>com.github.ua-parser</groupId>
    <artifactId>uap-java</artifactId>
    <version>1.5.4</version>
</dependency>

检测代码参考如下，注意Parser要做成全局单例，不要每次请求都新建：

import ua_parser.Parser;
import ua_parser.Client;
import javax.servlet.http.HttpServletRequest;

public class DeviceDetectUtil {
    // 全局初始化一次即可
    private static final Parser UA_PARSER = new Parser();

    public static boolean isMobile(HttpServletRequest request) {
        String userAgent = request.getHeader("User-Agent");
        Client client = UA_PARSER.parse(userAgent);
        String deviceType = client.device.family;
        // 非桌面、非其他未知设备，判定为移动设备（含手机、平板）
        return !"Desktop".equals(deviceType) && !"Other".equals(deviceType);
    }
}

这个库的设备识别规则是社区持续更新的，覆盖新发布的机型和浏览器版本，稳定性比停更的老组件高很多。

额外排查点 #

如果确认UA值正常，用上面的库还是检测不对，查这几个点：

• 浏览器模拟移动端时，打开网络面板看实际发出的请求头，确认UA真的切换成移动端标识了，很多人点了设备模拟但没刷新页面，实际发请求还是用的桌面端UA
• 真机测试时如果开了抓包工具、VPN，先关掉再测，这类工具很可能篡改请求头覆盖UA
• Spring Boot项目检查有没有自定义过滤器、拦截器包装了HttpServletRequest，改坏了getHeader方法的逻辑

内容的提问来源于stack exchange，提问作者Eatsam ul haq