当前位置:

首页 > 编程开发 > c#如何使用Log4Net_c#Log4Net完整教程与代码实例

c#如何使用Log4Net_c#Log4Net完整教程与代码实例

Log4Net已于2023年进入维护模式,不再支持.NET6及以上的原生日志抽象,新项目建议改用Microsoft.Extensions.Logging。若需对接遗留系统,必须掌握正确初始化、Logger命名规则、FileAppender权限配置及ASP.NETCore桥接的局限性等,避免生产环境日志静默。

本文目录

    Log4Net 在 .NET Framework 项目中依然常见,但一个关键信息需要明确:它已于 2023 年正式进入维护模式,不再开发新功能,并且不支持 .NET 6+ 的原生 Microsoft.Extensions.Logging 抽象。如果你正在启动新项目,直接使用 Microsoft.Extensions.Logging 搭配 Console 或 File 提供程序,是更稳妥也更现代的选择。不过,如果你必须对接遗留系统,或者手头已有成熟的 Log4Net 配置,那么掌握它的正确用法就至关重要了——尤其是那些容易踩坑的细节。

    如何正确初始化 Log4Net(避免“Logger is null”)

    Log4Net 不会自动扫描配置文件,你必须显式调用初始化方法,而且这一步只能执行一次。多次调用虽然不会报错,但会导致配置丢失或行为异常,得不偿失。

    • XmlConfigurator.Configure() 只加载 App.config 或 Web.config 中的 节点,前提是配置节已在 configSections 中注册。
    • 更推荐的做法是使用 XmlConfigurator.Configure(Assembly.GetCallingAssembly(), new FileInfo("log4net.config")) 加载外部 XML 文件,这样配置更独立,也更容易维护和替换。
    • 务必在调用 LogManager.GetLogger() 之前完成初始化。典型的位置是 Program.cs(.NET Framework)或 Global.asax Application_Start。
    • 在 ASP.NET Core 中无法直接使用这种方式,因为 LogManager 依赖 AppDomain,而 Core 采用的是 HostBuilder 模型。

    为什么 GetLogger(typeof(T)) 和 GetLogger("name") 行为不同

    Log4Net 的 Logger 实例本质上是按名称查找的。GetLogger(typeof(T)) 等价于 GetLogger(typeof(T).FullName),而 GetLogger("MyApp.Service") 则创建了一个独立命名空间下的 Logger。两者在日志级别和 Appender 绑定上是完全独立的——即使你在配置中写了 ,也不会匹配 typeof(MyApp.Service.UserService) 生成的 Logger 名称。

    层级匹配依赖于点号(.)分隔。例如,MyApp.Service 是 MyApp 的子 Logger,可以继承父级的 Level 和 Appender,但需要通过 additivity="false" 来控制是否叠加。调试时,可以使用 LogManager.GetCurrentLoggers() 来查看当前所有已创建的 Logger 名称,避免拼写错误或层级误解。

    FileAppender 写入失败的常见原因

    日志文件打不开、没内容、权限报错——这些问题 90% 都出在 FileAppender 的配置环节上。

    • File 路径如果写的是相对路径(比如 "logs/app.log"),实际路径会基于 AppDomain.CurrentDomain.BaseDirectory,而不是 exe 所在目录。尤其是在 IIS 部署时,BaseDirectory 是 w3wp.exe 的路径,很容易搞错。
    • 如果没有设置 AppendToFile="true",每次启动都会覆盖日志。另外,若未设置 LockingModel type="log4net.Appender.FileAppender+MinimalLock",多进程或多 AppDomain 下写入会直接抛出 IOException。
    • 在 Windows 环境下,如果路径包含中文或空格,记得用双引号包裹 XML 中的路径,同时确保应用有对应目录的写入权限(IIS 应用池标识用户需要授权)。
    • 建议改用 RollingFileAppender,配合 MaximumFileSize 和 MaxSizeRollBackups,避免单个文件过大或磁盘被占满。

    与 ASP.NET Core 共存的现实路径

    不能直接把 Log4Net 当作 .NET Core 的日志提供程序注入,但可以通过桥接方式保留旧的日志逻辑。

    • 使用 Microsoft.Extensions.Logging.Log4NetProvider NuGet 包(非官方,比如 Microsoft.Extensions.Logging.Log4Net.AspNetCore),它会把 ILogger 的调用转译为 Log4Net 的 ILog 调用。
    • 这个 Provider 只负责转发日志事件,并不接管配置——你仍然需要手动调用 XmlConfigurator.Configure() 来初始化 Log4Net。
    • 注意:Log4Net 的 PatternLayout 格式符(如 %date %level %logger - %message)不会自动解析 Microsoft.Extensions.Logging 的结构化日志参数。比如 logger.LogInformation("User {Id} logged in", userId) 中的 {Id} 会被原样输出为字符串,而不是被替换为实际值。
    • 如果你需要结构化日志,建议放弃 Log4Net,改用 Serilog 或 NLog,它们原生支持 Microsoft.Extensions.Logging 的 message template 解析。

    Log4Net 的核心陷阱不在语法,而在于生命周期管理——初始化遗漏、多线程争抢配置、路径权限误判,以及对 .NET Core 运行模型的误用。一旦在生产环境出现日志静默,优先检查 LogManager.GetCurrentLoggers() 返回是否为空,再确认 XmlConfigurator 是否真的被执行过,而不是翻来覆去地排查配置文件格式。

    本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系bd@zhengruan.com
    作者最新文章
    编程开发 C#
    相关文章 更多
    winforms教程自学入门与基础开发步骤详解
    winforms教程自学入门与基础开发步骤详解

    本教程详细讲解如何使用Visual Studio创建WinForms项目,通过添加按钮和标签控件并编写点击事件代码,实现一个基础的计数器功能,适合C#初学者快速上手Windows窗体应用开发。

    谈编程与编程语言
    谈编程与编程语言

    编程的本质是创造性的严谨翻译,通过for、if和函数调用实现重复计算任务。语言发展让集成度提高,门槛降低但竞争加剧。程序员需培养整体架构能力,抓住思想精髓而非追逐新技术,方能长远发展。

    什么是面向接口编程、面向过程编程、面向对象编程?
    什么是面向接口编程、面向过程编程、面向对象编程?

    面向接口编程通过接口解耦,降低耦合度并提升可扩展性和维护性,是面向对象思想的精髓。面向过程编程将问题拆解为步骤,用函数依次执行。面向对象编程将事物抽象为对象,封装属性和方法,通过对象协作解决问题。

    我对编程的一些感悟
    我对编程的一些感悟

    编程这件事,说到底是门手艺活,但又不全是手艺。把代码写出来容易,把代码写好、写出境界,那就得看功夫了。今天聊几个核心判断,算是多年敲键盘的一点沉淀。 一、语言是功夫,思路是内功 编程语言五花八门,就像武林高手会的功夫一样,但想成为顶尖高手,内功必须深厚。内功到了,学新功夫就是分分钟的事。看过《倚天屠

    c#如何使用abstract类_c#abstract类看这一篇就够了_保姆级教程
    c#如何使用abstract类_c#abstract类看这一篇就够了_保姆级教程

    abstract类不能被直接实例化,子类必须用override实现其所有抽象方法。抽象类可实现接口,并以抽象方法转发接口成员。抽象类不能与sealed共用,其抽象方法默认隐式virtual且无方法体。可包含字段、属性等非抽象成员。

    c#如何删除文件_c#删除文件的正确用法与注意事项
    c#如何删除文件_c#删除文件的正确用法与注意事项

    C#删除文件前应先判断存在性以防异常,注意权限不足和文件被占用。File.Delete与FileInfo.Delete功能相同,后者适合多次操作。无异步删除方法,推荐后台执行或限流以避免阻塞。

    c#如何使用EmguCV_c#EmguCV的最佳实践与常见坑点
    c#如何使用EmguCV_c#EmguCV的最佳实践与常见坑点

    在EmguCV中,进行Bitmap转Image时,需先转为24位无Alpha格式,以避免颜色错乱问题;Image转Bitmap时,建议使用Mat或ImageBox控件,以有效减少内存拷贝;跨线程处理时,应使用Mat.Clone()进行深拷贝,以确保数据安全;DLL加载失败时,需设置x64平台目标,并确保native库在输出目录中。

    C#怎么实现图表生成 C#如何用LiveCharts和OxyPlot绘制柱状图折线图饼图【图表】
    C#怎么实现图表生成 C#如何用LiveCharts和OxyPlot绘制柱状图折线图饼图【图表】

    C#图表生成中,LiveCharts需用ChartValues数据集合,并在更新后触发重绘;OxyPlot饼图需启用交互与标签;包引用务必注意版本适配;导出图片需在布局完成后操作,并校正DPI缩放以确保清晰度。

    C#怎么实现过滤器Filter_C# ASP.NET Core过滤器详解教程【进阶】
    C#怎么实现过滤器Filter_C# ASP.NET Core过滤器详解教程【进阶】

    ASP.NETCore过滤器需关注执行顺序、作用域与DI生命周期。接口实现需手动注册,特性继承更常用但需满足构造函数要求。全局注册时注意scoped服务注入问题,Order值须显式设置以控制同类型过滤器执行顺序。异常过滤器仅捕获操作方法内异常,模型绑定与授权失败须分别处理。

    c#如何实现鼠标钩子_c#鼠标钩子完整教程与实战案例
    c#如何实现鼠标钩子_c#鼠标钩子完整教程与实战案例

    实现全局鼠标钩子需使用SetWindowsHookEx配合WH_MOUSE_LL,窗体级事件仅捕获本进程消息。回调函数必须为静态且标记特定签名,禁止阻塞操作。通过Marshal.PtrToStructure解析lParam获取坐标与按键状态。钩子生命周期绑定线程,需注意注册线程持续运行并双重卸载,避免句柄泄漏。

    查看更多
    精品专题 更多
    装机必备
    装机必备

    正软商城装机必备专区,精选办公、浏览器、安全防护、影音播放、压缩解压、设计创作和系统工具等电脑常用正版软件,帮助用户快速完成新电脑软件配置。

    Windows
    Windows

    正软商城Windows软件专区,汇集适用于Windows电脑的办公、设计、安全防护、影音播放、开发工具和系统优化软件,提供软件介绍、系统要求、正版授权及购买下载服务。

    PDF教程
    PDF教程

    正软商城PDF教程频道提供PDF编辑、转换、合并、拆分、压缩及格式处理方法,同时介绍常用PDF软件和工具的使用技巧。

    Mac软件 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    Aperty macOS版
    Aperty macOS版
    macOS

    Aperty 是 Skylum 推出的 AI 人像修图软件,支持自然肤质修饰、瑕疵处理、面部与身体调整、预设及批量同步。

    WINDOWS 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    PixTV 网页版
    PixTV 网页版
    Windows

    PixTV 是一款在浏览器中使用的 AI 视觉内容创作平台,提供图片、视频、音频、文字生成、AI 分镜、局部重绘、提示词反推和无限画布等工具,适合短剧、漫剧、广告及社交媒体内容制作。