RocketMQ-Topic命名规则

最新推荐文章于 2025-08-20 16:51:17 发布

原创最新推荐文章于 2025-08-20 16:51:17 发布 · 6.7k 阅读

0 ·

CC 4.0 BY-SA版权

RocketMQ 专栏收录该内容

13 篇文章

订阅专栏

RocketMQ的Topic命名有特定规则，包括字符限制在127个，仅允许数字、字母、下划线和中划线，并且不能与默认的TBW102标识符重名，区分大小写。了解这些规则对于正确操作RocketMQ至关重要。

不能为空
只能包含%数字大小写字母及下划线和中划线
长度不能超过255个字符（在broker中限制却是127），以broker为主

在4.6.1版本中已经统一为127
不能与默认用于判断是否可自动创建topic(TBW102)重名

public class Validators {
	public static void checkTopic(String topic) throws MQClientException {
    if (UtilAll.isBlank(topic)) {
        throw new MQClientException("The specified topic is blank", null);
    }

    //public static final String VALID_PATTERN_STR = "^[%|a-zA-Z0-9_-]+$";
    if (!regularExpressionMatcher(topic, PATTERN)) {
        throw new MQClientException(String.format(
            "The specified topic[%s] contains illegal characters, allowing only %s", topic,
            VALID_PATTERN_STR), null);
    }

    //在4.6.1版本中已经统一为127
    if (topic.length() > CHARACTER_MAX_LENGTH) {
        throw new MQClientException("The specified topic is longer than topic max length 255.", null);
    }

    //whether the same with system reserved keyword
    //public static final String AUTO_CREATE_TOPIC_KEY_TOPIC = "TBW102";
    if (topic.equals(MixAll.AUTO_CREATE_TOPIC_KEY_TOPIC)) {
        throw new MQClientException(
            String.format("The topic[%s] is conflict with AUTO_CREATE_TOPIC_KEY_TOPIC.", topic), null);
    }
}
}

DefaultMessageStore 实际存储消息的时候还有检测，Byte.MAX_VALUE=127
if (msg.getTopic().length() > Byte.MAX_VALUE) {
    log.warn("putMessage message topic length too long " + msg.getTopic().length());
    return new PutMessageResult(PutMessageStatus.MESSAGE_ILLEGAL, null);
}