alibaba/nacos · error · NacosException

50310

50310

Error message

fuzzy watch pattern over limit

What it means

Error "fuzzy watch pattern over limit" thrown in alibaba/nacos.

Source

Thrown at config/src/main/java/com/alibaba/nacos/config/server/service/ConfigFuzzyWatchContextService.java:219

        Set<String> strings = matchedGroupKeysMap.get(groupKeyPattern);
        return strings != null && (reachToUpLimit(strings.size()));
    }
    
    /**
     * Matches the client effective group keys based on the specified group key pattern, client IP, and tag.
     *
     * @param groupKeyPattern The pattern to match group keys.
     */
    private void initMatchGroupKeys(String groupKeyPattern) throws NacosException {
        if (matchedGroupKeysMap.containsKey(groupKeyPattern)) {
            return;
        }
        
        if (matchedGroupKeysMap.size() >= ConfigCommonConfig.getInstance().getMaxPatternCount()) {
            LogUtil.DEFAULT_LOG.warn(
                "[fuzzy-watch] pattern count is over limit ,pattern {} init fail,current count is {}",
                groupKeyPattern, matchedGroupKeysMap.size());
            throw new NacosException(FUZZY_WATCH_PATTERN_OVER_LIMIT.getCode(),
                FUZZY_WATCH_PATTERN_OVER_LIMIT.getMsg());
        }
        
        matchedGroupKeysMap.computeIfAbsent(groupKeyPattern, k -> new HashSet<>());
        Set<String> matchedGroupKeys = this.matchedGroupKeysMap.get(groupKeyPattern);
        long matchBeginTime = System.currentTimeMillis();
        boolean overMatchCount = false;
        for (String groupKey : ConfigCacheService.CACHE.keySet()) {
            String[] groupKeyItems = GroupKey.parseKey(groupKey);
            if (FuzzyGroupKeyPattern.matchPattern(groupKeyPattern, groupKeyItems[0],
                groupKeyItems[1],
                groupKeyItems[2])) {
                
                if (reachToUpLimit(matchedGroupKeys.size())) {
                    LogUtil.DEFAULT_LOG.warn(
                        "[fuzzy-watch]   pattern matched service count is over limit , "
                            + "other services will stop notify for pattern {} ,current count is {}",
                        groupKeyPattern,

View on GitHub (pinned to 9b989acdf1)

Solutions

1. Reduce the size or count of the input so it stays within the configured limit.

When it happens

Trigger: Thrown at config/src/main/java/com/alibaba/nacos/config/server/service/ConfigFuzzyWatchContextService.java:219 when the library encounters an invalid state.

Common situations: Registering more fuzzy watch patterns than the server limit allows.

AI-assisted analysis of alibaba/nacos@9b989acdf1 (2026-08-14). Data as JSON: /api/errors/de952c82487354d5. Report an issue: GitHub.