ASP.NET Core微服务架构下共享库的log4net配置咨询

针对你在微服务架构中集中管理log4net配置的需求，结合实际项目经验给出以下解决方案：

1. 程序集特性的添加要求 #

必须在每个微服务项目中单独添加[assembly: log4net.Config.XmlConfigurator(Watch =true)]，不能仅在共享库中添加。原因是log4net的程序集级特性作用范围仅限当前程序集，共享库的特性不会自动传递到引用它的微服务项目中。

添加位置建议放在微服务项目的Program.cs最顶部（命名空间声明之外），示例：

[assembly: log4net.Config.XmlConfigurator(Watch = true)]

namespace YourMicroserviceNamespace;

public class Program
{
    // ... 微服务启动逻辑
}

2. SharedLogger类优化实现 #

原实现存在日志来源不明确、配置逻辑冗余的问题，以下是优化后的版本：

using log4net;
using log4net.Config;
using System.IO;
using System.Reflection;
using System.Xml;
using Microsoft.Extensions.Configuration;
using System.Text;

// 泛型Logger，自动关联调用类的类型，便于定位日志来源
public class SharedLogger<T>
{
    private static readonly ILog _logger = LogManager.GetLogger(typeof(T));

    // 静态构造函数自动完成log4net初始化，无需手动调用Configure
    static SharedLogger()
    {
        // 1. 读取微服务的环境配置（获取数据库连接字符串）
        var config = new ConfigurationBuilder()
            .SetBasePath(Directory.GetCurrentDirectory())
            .AddJsonFile("appsettings.json", optional: false, reloadOnChange: true)
            .Build();
        var logDbConnStr = config.GetConnectionString("LogDatabase");

        // 2. 从共享库嵌入资源加载统一配置文件
        var assembly = Assembly.GetExecutingAssembly();
        using var configStream = assembly.GetManifestResourceStream("YourSharedLibraryName.log4net.config");
        var configDoc = new XmlDocument();
        configDoc.Load(configStream);

        // 3. 替换配置中的数据库连接字符串（适配不同环境）
        var connStrNode = configDoc.SelectSingleNode("//appender[@name='AdoNetAppender']/connectionString");
        if (connStrNode != null)
        {
            connStrNode.InnerText = logDbConnStr;
        }

        // 4. 应用配置
        using var memoryStream = new MemoryStream(Encoding.UTF8.GetBytes(configDoc.OuterXml));
        XmlConfigurator.Configure(memoryStream);
    }

    // 封装各日志级别方法，包含异常重载
    public void Info(string message) => _logger.Info(message);
    public void InfoFormat(string format, params object[] args) => _logger.InfoFormat(format, args);
    public void Debug(string message) => _logger.Debug(message);
    public void Warn(string message) => _logger.Warn(message);
    public void Error(string message) => _logger.Error(message);
    public void Error(Exception ex, string message) => _logger.Error(message, ex);
    public void Fatal(string message) => _logger.Fatal(message);
    public void Fatal(Exception ex, string message) => _logger.Fatal(message, ex);
}

优化点说明 #

• 采用泛型SharedLogger<T>：日志中会自动记录调用类的完整类型名，方便快速定位日志来源
• 静态构造函数自动初始化：无需微服务手动调用配置方法，减少冗余代码
• 嵌入配置文件：将log4net.config设置为共享库的嵌入资源（右键文件→属性→生成操作→嵌入的资源），实现配置完全集中管理
• 动态替换连接字符串：从微服务的appsettings.json读取数据库连接，兼顾配置统一与环境适配

3. 与微服务的集成步骤 #

1. 引用共享库：每个微服务项目添加对共享类库的引用
2. 添加程序集特性：如问题1所述，在每个微服务的Program.cs顶部添加[assembly: log4net.Config.XmlConfigurator(Watch = true)]
3. 配置数据库连接：在微服务的appsettings.json中添加日志数据库的连接字符串：

   "ConnectionStrings": {
     "LogDatabase": "Server=your-db-server;Database=your-log-db;User Id=xxx;Password=xxx;"
   }
   

4. 在业务类中使用Logger：

   public class OrderController : ControllerBase
   {
       private readonly SharedLogger<OrderController> _logger;
   
       public OrderController()
       {
           _logger = new SharedLogger<OrderController>();
       }
   
       [HttpPost]
       public IActionResult CreateOrder(OrderDto dto)
       {
           try
           {
               _logger.InfoFormat("开始创建订单，订单编号：{0}", dto.OrderNo);
               // 业务逻辑...
               return Ok();
           }
           catch (Exception ex)
           {
               _logger.Error(ex, $"创建订单失败，订单编号：{dto.OrderNo}");
               return StatusCode(500, "创建订单失败");
           }
       }
   }
   

附：共享库中log4net.config核心配置（写入logger表） #

<log4net>
  <appender name="AdoNetAppender" type="log4net.Appender.AdoNetAppender">
    <connectionType value="System.Data.SqlClient.SqlConnection, System.Data.SqlClient" />
    <connectionString value="占位符，将由代码替换" />
    <commandText value="INSERT INTO logger ([Date],[Thread],[Level],[Logger],[Message],[Exception]) VALUES (@log_date, @thread, @log_level, @logger, @message, @exception)" />
    <parameter>
      <parameterName value="@log_date" />
      <dbType value="DateTime" />
      <layout type="log4net.Layout.RawTimeStampLayout" />
    </parameter>
    <parameter>
      <parameterName value="@thread" />
      <dbType value="String" />
      <size value="255" />
      <layout type="log4net.Layout.PatternLayout">
        <conversionPattern value="%thread" />
      </layout>
    </parameter>
    <parameter>
      <parameterName value="@log_level" />
      <dbType value="String" />
      <size value="50" />
      <layout type="log4net.Layout.PatternLayout">
        <conversionPattern value="%level" />
      </layout>
    </parameter>
    <parameter>
      <parameterName value="@logger" />
      <dbType value="String" />
      <size value="255" />
      <layout type="log4net.Layout.PatternLayout">
        <conversionPattern value="%logger" />
      </layout>
    </parameter>
    <parameter>
      <parameterName value="@message" />
      <dbType value="String" />
      <size value="4000" />
      <layout type="log4net.Layout.PatternLayout">
        <conversionPattern value="%message" />
      </layout>
    </parameter>
    <parameter>
      <parameterName value="@exception" />
      <dbType value="String" />
      <size value="2000" />
      <layout type="log4net.Layout.ExceptionLayout" />
    </parameter>
  </appender>

  <root>
    <level value="INFO" />
    <appender-ref ref="AdoNetAppender" />
  </root>
</log4net>

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