如何在.config文件中配置NServiceBus？是否有自动化配置方式？

嘿，我来帮你梳理下NServiceBus在.config文件里的配置方法，还有那些能帮你少写手动代码的自动化选项～

一、如何在.config文件中配置NServiceBus #

要在.config里配置NServiceBus，核心是先注册它的配置节，再添加具体的配置节点，步骤如下：

1. 先注册配置节 #

在你的App.config或Web.config的<configuration>根节点下，首先要添加<configSections>，把NServiceBus相关的配置节注册进去——不然系统没法识别这些自定义的配置节点：

<configuration>
  <configSections>
    <section name="NServiceBus" type="NServiceBus.Config.NServiceBusConfiguration, NServiceBus.Core" />
    <!-- 按需注册其他子节，比如传输、持久化、总线配置 -->
    <section name="TransportConfig" type="NServiceBus.Config.TransportConfig, NServiceBus.Core" />
    <section name="UnicastBusConfig" type="NServiceBus.Config.UnicastBusConfig, NServiceBus.Core" />
    <section name="PersistenceConfig" type="NServiceBus.Config.PersistenceConfig, NServiceBus.Core" />
  </configSections>

2. 添加具体配置节点 #

注册完节之后，就可以在<configuration>里添加核心配置和功能节点了，这里给个基础示例：

<!-- 核心NServiceBus配置 -->
  <NServiceBus>
    <EndpointConfig EndpointName="Your.Endpoint.Name" /> <!-- 你的端点名称 -->
    <Transport ConfiguredEndpoint="Your.Endpoint.Name" /> <!-- 传输层关联的端点 -->
    <Persistence Mode="InMemory" /> <!-- 持久化模式，也可以用SqlServer、RavenDB等 -->
    <Logging Level="Info" /> <!-- 日志级别 -->
  </NServiceBus>

  <!-- 传输层配置：指定并发数、错误队列 -->
  <TransportConfig MaximumConcurrencyLevel="5" ErrorQueue="error" />

  <!-- 单播总线配置：映射消息到目标端点 -->
  <UnicastBusConfig>
    <MessageEndpointMappings>
      <add Messages="Your.Message.Assembly" Endpoint="Target.Endpoint.Name" />
    </MessageEndpointMappings>
  </UnicastBusConfig>
</configuration>

注意：不同版本的NServiceBus配置节的结构可能略有差异，记得对应你使用的版本调整细节。

二、自动化配置选项：不用手动写全部内容 #

完全没必要手动敲完所有配置，这几种自动化方式能帮你省不少事：

1. NuGet安装自动生成基础配置 #

当你通过NuGet安装NServiceBus.Core或者对应的传输/持久化包（比如NServiceBus.SqlServer）时，安装程序会自动往你的App.config/Web.config里添加必要的配置节和基础模板。比如装SQL Server持久化包后，会自动注册PersistenceConfig节并填上默认的SQL Server配置片段。

2. 用配置API生成.config文件 #

如果你喜欢用代码优先的方式配置NServiceBus，可以先在代码里把所有配置调好，然后序列化到.config文件里。示例代码：

var config = new BusConfiguration();
config.EndpointName("Your.Endpoint.Name");
config.UseTransport<MsmqTransport>(); // 指定MSMQ传输
config.UsePersistence<InMemoryPersistence>(); // 内存持久化

// 把配置序列化到指定的.config文件
var serializer = new ConfigSerializer();
serializer.SerializeToFile(config, @"C:\your-project-path\App.config");

这样生成的.config文件会包含你在代码里配置的所有内容，不用手动写XML。

3. 配置变换：多环境自动适配 #

针对开发、测试、生产不同环境，你可以用Visual Studio的配置变换功能——只维护一份基础配置，然后给每个环境写差异部分就行。比如App.Release.config可以覆盖生产环境的持久化连接字符串：

<?xml version="1.0" encoding="utf-8"?>
<configuration xmlns:xdt="http://schemas.microsoft.com/XML-Document-Transform">
  <PersistenceConfig xdt:Transform="Replace">
    <SqlServer ConnectionString="Server=prod-db;Database=nsb-prod;Integrated Security=True;" />
  </PersistenceConfig>
</configuration>

发布项目时，Visual Studio会自动把基础配置和变换文件合并，生成对应环境的最终.config文件。

4. NServiceBus Profiles：预定义配置模板 #

NServiceBus提供了预定义的配置Profiles，比如AsA_Server、AsA_Client、Lite这些，它们会自动应用一组最佳实践的配置。你只需要在.config里指定要用的Profile，然后覆盖需要自定义的部分就行：

<NServiceBus>
  <Profile Name="AsA_Server" /> <!-- 应用Server端的预定义配置 -->
  <!-- 只需要写你要自定义的内容，比如端点名称 -->
  <EndpointConfig EndpointName="Production.Server.Endpoint" />
</NServiceBus>

这样大部分基础配置都会由Profile自动处理，你不用手动写每个细节。

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