为何Java Matcher.group(String)在旧Android版本抛出UnsupportedOperationException？

核心原因 #

Android 7.0（API 24）及之前的ART虚拟机，虽然支持正则表达式的命名分组语法，但并未实现Matcher#group(String)方法，调用该方法会直接抛出UnsupportedOperationException。这是Android平台特有的行为，Oracle官方Java文档不会覆盖Android的私有实现差异，所以你看不到相关异常说明。

解决方案 #

1. 版本判断+索引分组兼容

直接根据Android API等级做分支处理，低版本系统改用索引调用group(int)：

Pattern pattern = Pattern.compile("(?<username>\\w+)@(?<domain>\\w+\\.com)");
Matcher matcher = pattern.matcher("test@example.com");
if (matcher.find()) {
    String username, domain;
    if (android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.N) {
        username = matcher.group("username");
        domain = matcher.group("domain");
    } else {
        // 命名分组对应的索引按定义顺序排列，第一个命名分组索引为1，第二个为2
        username = matcher.group(1);
        domain = matcher.group(2);
    }
}

2. 封装工具类实现跨版本命名分组支持

如果要保留命名分组的可读性，可以封装一个工具类，自动映射分组名称与索引：

public class NamedMatcher {
    private final Matcher matcher;
    private final Map<String, Integer> nameToIndexMap;

    public NamedMatcher(Pattern pattern, CharSequence input) {
        this.matcher = pattern.matcher(input);
        this.nameToIndexMap = new HashMap<>();
        
        // 解析正则中的命名分组，建立名称与索引的映射
        Matcher nameMatcher = Pattern.compile("\\(\\?<([a-zA-Z0-9_]+)>").matcher(pattern.pattern());
        int currentIndex = 1;
        while (nameMatcher.find()) {
            nameToIndexMap.put(nameMatcher.group(1), currentIndex++);
        }
    }

    public boolean find() {
        return matcher.find();
    }

    public String group(String name) {
        if (android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.N) {
            return matcher.group(name);
        }
        
        Integer index = nameToIndexMap.get(name);
        if (index == null) {
            throw new IllegalArgumentException("No group named '" + name + "'");
        }
        return matcher.group(index);
    }
}

使用方式：

Pattern pattern = Pattern.compile("(?<username>\\w+)@(?<domain>\\w+\\.com)");
NamedMatcher namedMatcher = new NamedMatcher(pattern, "test@example.com");
if (namedMatcher.find()) {
    String username = namedMatcher.group("username");
    String domain = namedMatcher.group("domain");
}

关键注意点

• 不要以Java版本等效性判断Android特性支持：Android 7的API虽然标称等效Java 7，但ART虚拟机对Java正则的命名分组API实现滞后，直到API 24才补全。
• 低版本系统中，Pattern编译命名分组语法不会报错，但Matcher#group(String)会直接抛异常，这点需要特别注意。

内容的提问来源于stack exchange，提问作者user149408