NServiceBus 8.x使用SQSTransport自定义主题命名问题排查

重复主题生成的原因与修复 #

你调用的MapEvent("myCustomTopicName")是无类型重载，它的作用是设置所有未显式映射事件的默认主题名模板，但NServiceBus仍会为端点发布的事件生成带端点前缀的默认主题，加上这个默认模板创建的无前缀主题，就导致了重复创建。

要正确控制特定事件的主题名，需使用泛型重载指定对应事件类型：

// 替换MyEvent为你实际要映射的事件类型
sqsTransport.MapEvent<MyEvent>("myCustomTopicName");

如果需要全局统一所有事件的主题命名规则（而非单个事件），推荐使用TopicNameGenerator替代MapEvent，从根源避免重复：

sqsTransport.TopicNameGenerator = (eventType, subscriberEndpointName) =>
{
    // 按内部规范编写自定义命名逻辑，示例：
    return $"internal-events-{eventType.Name}";
};

TopicNameGenerator参数说明 #

TopicNameGenerator是Func<Type, string, string>类型，两个参数的含义：

• Type eventType：当前需要生成主题的事件的CLR类型。
• string subscriberEndpointName：仅在端点作为订阅者生成订阅相关主题时传入有效值；当端点作为发布者生成事件主题时，该参数为null——这就是你调试时看到第二个参数为null的原因。

注意：若同时使用MapEvent显式映射和TopicNameGenerator，显式映射的优先级更高，对应事件不会触发生成器逻辑。

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