如何去除log4net打印堆栈跟踪中的全限定类名？

这个问题我之前帮不少开发者解决过——log4net默认的堆栈跟踪输出确实太啰嗦了，全限定类名和带System前缀的参数名会让日志变得难以阅读。下面给你两种可行的方案，都是我实际项目里验证过的：

方案1：自定义堆栈跟踪转换器（推荐） #

最灵活的方式是写一个自定义的log4net Pattern转换器，自己控制堆栈信息的输出格式。这样你可以完全按照需求简化类名、参数类型等内容。

步骤1：实现自定义转换器 #

创建一个继承自PatternConverter的类，重写Convert方法来处理堆栈帧：

using log4net.Core;
using log4net.Layout.Pattern;
using System;
using System.Diagnostics;
using System.Reflection;
using System.Text;

namespace YourProjectNamespace // 替换成你的项目命名空间
{
    public class SimplifiedStackTraceConverter : PatternConverter
    {
        protected override void Convert(System.IO.TextWriter writer, object state)
        {
            var loggingEvent = state as LoggingEvent;
            if (loggingEvent?.ExceptionObject == null)
                return;

            var stackTrace = new StackTrace(loggingEvent.ExceptionObject, true);
            var frames = stackTrace.GetFrames();
            if (frames == null)
                return;

            var sb = new StringBuilder();
            foreach (var frame in frames)
            {
                var method = frame.GetMethod();
                if (method == null)
                    continue;

                // 提取简化类名：只取类名部分，去掉全限定命名空间
                var className = method.DeclaringType?.Name ?? "UnknownClass";
                // 处理泛型类名（比如List`1 → List）
                if (className.Contains("`"))
                    className = className.Substring(0, className.IndexOf('`'));

                // 简化参数类型和名称
                var methodName = method.Name;
                var parameters = method.GetParameters();
                var paramBuilder = new StringBuilder();
                foreach (var param in parameters)
                {
                    var paramType = param.ParameterType.Name;
                    // 去掉System前缀的参数类型，同时处理泛型
                    if (paramType.Contains("`"))
                        paramType = paramType.Substring(0, paramType.IndexOf('`'));
                    // 如果是System命名空间下的类型，直接用短名称
                    if (param.ParameterType.Namespace?.StartsWith("System.") == true)
                        paramType = param.ParameterType.Name;

                    if (paramBuilder.Length > 0)
                        paramBuilder.Append(", ");
                    paramBuilder.Append($"{paramType} {param.Name}");
                }

                // 拼接当前堆栈行，包含行号
                sb.AppendLine($"{className}.{methodName}({paramBuilder}) at line {frame.GetFileLineNumber()}");
            }

            writer.Write(sb.ToString());
        }
    }
}

步骤2：在log4net配置中注册并使用转换器 #

修改你的log4net配置文件，注册自定义转换器，并在布局中使用它代替默认的%exception或%stacktrace：

<log4net>
  <appender name="YourAppender" type="log4net.Appender.RollingFileAppender"> <!-- 替换成你的实际Appender类型 -->
    <file value="logs/your-app.log" />
    <appendToFile value="true" />
    <rollingStyle value="Size" />
    <maxSizeRollBackups value="5" />
    <maximumFileSize value="10MB" />
    <staticLogFileName value="true" />
    
    <layout type="log4net.Layout.PatternLayout">
      <!-- 注册自定义转换器 -->
      <converter>
        <name value="simplifiedStack" />
        <!-- 注意：这里的类型要写全限定名 + 程序集名称 -->
        <type value="YourProjectNamespace.SimplifiedStackTraceConverter, YourProjectAssembly" />
      </converter>
      
      <!-- 自定义日志格式，使用%simplifiedStack代替默认的异常输出 -->
      <conversionPattern value="%date [%thread] %-5level %logger - %message%newline%newline%simplifiedStack%newline" />
    </layout>
  </appender>
  
  <root>
    <level value="INFO" />
    <appender-ref ref="YourAppender" />
  </root>
</log4net>

方案2：简化默认异常输出（快速版） #

如果你不想写自定义代码，也可以通过log4net的%exception{format}参数来控制输出，但这个方法的灵活性有限，只能去掉部分冗余信息，无法完全去除全限定类名：

<!-- 在布局中使用%exception{ShortType}来简化异常类型名 -->
<conversionPattern value="%date [%thread] %-5level %logger - %message%newline%exception{ShortType,Message,StackTrace}%newline" />

不过这种方式只能简化异常类型的名称，堆栈跟踪里的方法依然会显示全限定类名，所以更推荐方案1。

注意事项 #

• 确保自定义转换器的命名空间和程序集名称在配置里填写正确，否则log4net无法加载该类型
• 如果需要保留自己项目的命名空间（只去掉System等系统命名空间），可以修改代码中className的处理逻辑，比如判断命名空间是否为System开头再做简化
• 代码中已经处理了基础的泛型类型，如果有嵌套泛型（比如Dictionary<string, List<int>>），可以进一步优化参数类型的解析逻辑

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