当前位置： 首页 > news >正文

【后端】.NET Core API框架搭建（9） --配置使用Log4Net日志

news 2025/7/18 5:35:57

       

目录

1.添加包

2.新建公用类

3.新建配置

4.注册

        4.1.类库项目设置

5.使用

         在 .NET Core 项目中使用 Log4Net 做日志记录，具有很多优势。尽管 .NET Core 自带了 ILogger 接口（如使用内置的 ConsoleLogger、DebugLogger 等），但 Log4Net 提供了更强大、灵活和可配置的日志功能，尤其适合企业级应用或需要精细控制日志输出的场景。

1.添加包

        添加 log4net 和 Microsoft.Extensions.Logging.Log4Net.AspNetCore 包。

2.新建公用类

        创建 LogHelper 公共静态类。

using log4net;
using System.Collections.Concurrent;
using System.Runtime.CompilerServices;namespace Frame5_LibraryLogger.LogHelper
{/// <summary>/// 日志类-记录调用名称/// </summary>public static class LogHelper{// 缓存 ILog 对象（线程安全）private static readonly ConcurrentDictionary<string, ILog> _loggerCache = new ConcurrentDictionary<string, ILog>();// 获取 ILog 实例（确保只初始化一次）private static ILog GetLogger([CallerMemberName] string caller = ""){return _loggerCache.GetOrAdd(caller, LogManager.GetLogger);}/// <summary>/// 记录 DEBUG 级别日志/// </summary>public static void Debug(string message, [CallerMemberName] string caller = ""){var logger = GetLogger(caller);if (logger.IsDebugEnabled)logger.Debug(message);}/// <summary>/// 记录 INFO 级别日志/// </summary>public static void Info(string message, [CallerMemberName] string caller = ""){var logger = GetLogger(caller);if (logger.IsInfoEnabled)logger.Info(message);}/// <summary>/// 记录 WARN 级别日志/// </summary>public static void Warn(string message, [CallerMemberName] string caller = ""){GetLogger(caller).Warn(message);}/// <summary>/// 记录 ERROR 级别日志/// </summary>public static void Error(string message, Exception ex = null, [CallerMemberName] string caller = ""){var logger = GetLogger(caller);if (ex != null)logger.Error(message, ex);elselogger.Error(message);}/// <summary>/// 记录 FATAL 级别日志/// </summary>public static void Fatal(string message, Exception ex = null, [CallerMemberName] string caller = ""){var logger = GetLogger(caller);if (ex != null)logger.Fatal(message, ex);elselogger.Fatal(message);}}
}

        案例如下

3.新建配置

        新建 log4net.config 应用程序配置文件

        点击所需项目 → 添加 → 新建项目 → 右上角搜索 应用程序配置文件

<?xml version="1.0" encoding="utf-8"?>
<!-- XML文件声明，版本1.0，UTF-8编码 -->
<log4net><!-- 开始log4net配置 --><!-- 关闭所有Microsoft开头的命名空间日志 --><logger name="Microsoft"><level value="OFF" /></logger><!-- 关闭System开头的命名空间日志 --><logger name="System"><level value="OFF" /></logger><!-- INFO级别日志配置开始 --><appender name="InfoFileAppender" type="log4net.Appender.RollingFileAppender"><!-- 定义一个名为InfoFileAppender的appender，使用滚动文件类型 --><file type="log4net.Util.PatternString" value="logs/INFO/INFO_" /><!-- 日志文件路径模板，使用PatternString支持动态路径 --><datePattern value="yyyy-MM-dd'.txt'" /><!-- 日期模式，用于文件滚动命名，每天生成一个新文件 --><staticLogFileName value="false" /><!-- 不使用静态文件名，允许根据日期模式变化 --><appendToFile value="true" /><!-- 以追加模式写入文件，不清空原有内容 --><rollingStyle value="Date" /><!-- 滚动策略：按日期滚动 --><layout type="log4net.Layout.PatternLayout"><!-- 定义日志输出布局为模式布局 --><conversionPattern value="%date [%thread] %-5level %logger - %message%newline" /><!-- 日志格式：%date - 日期时间[%thread] - 线程ID%-5level - 日志级别（左对齐，5字符宽度）%logger - 记录器名称%message - 日志消息%newline - 换行符--></layout><filter type="log4net.Filter.LevelMatchFilter"><!-- 添加级别匹配过滤器 --><levelToMatch value="INFO" /><!-- 只匹配INFO级别日志 --></filter><filter type="log4net.Filter.DenyAllFilter" /><!-- 拒绝所有不匹配的日志 --></appender><!-- DEBUG级别日志配置开始 --><appender name="DebugFileAppender" type="log4net.Appender.RollingFileAppender"><!-- 定义DEBUG级别appender --><file type="log4net.Util.PatternString" value="logs/DEBUG/DEBUG_" /><!-- DEBUG日志文件路径 --><datePattern value="yyyy-MM-dd'.txt'" /><!-- 日期格式 --><staticLogFileName value="false" /><!-- 动态文件名 --><appendToFile value="true" /><!-- 追加模式 --><rollingStyle value="Date" /><!-- 按日期滚动 --><layout type="log4net.Layout.PatternLayout"><!-- 布局配置 --><conversionPattern value="%date [%thread] %-5level %logger - %message%newline" /><!-- 同INFO格式 --></layout><filter type="log4net.Filter.LevelMatchFilter"><!-- DEBUG级别过滤器 --><levelToMatch value="DEBUG" /></filter><filter type="log4net.Filter.DenyAllFilter" /><!-- 拒绝其他级别 --></appender><!-- WARN级别日志配置开始 --><appender name="WarnFileAppender" type="log4net.Appender.RollingFileAppender"><!-- WARN级别appender定义 --><file type="log4net.Util.PatternString" value="logs/WARN/WARN_" /><!-- WARN日志路径 --><datePattern value="yyyy-MM-dd'.txt'" /><!-- 日期格式 --><staticLogFileName value="false" /><!-- 动态文件名 --><appendToFile value="true" /><!-- 追加模式 --><rollingStyle value="Date" /><!-- 按日期滚动 --><layout type="log4net.Layout.PatternLayout"><!-- 布局配置 --><conversionPattern value="%date [%thread] %-5level %logger - %message%newline" /></layout><filter type="log4net.Filter.LevelMatchFilter"><!-- WARN级别过滤器 --><levelToMatch value="WARN" /></filter><filter type="log4net.Filter.DenyAllFilter" /><!-- 拒绝其他级别 --></appender><!-- ERROR级别日志配置开始 --><appender name="ErrorFileAppender" type="log4net.Appender.RollingFileAppender"><!-- ERROR级别appender --><file type="log4net.Util.PatternString" value="logs/ERROR/ERROR_" /><!-- ERROR日志路径 --><datePattern value="yyyy-MM-dd'.txt'" /><!-- 日期格式 --><staticLogFileName value="false" /><!-- 动态文件名 --><appendToFile value="true" /><!-- 追加模式 --><rollingStyle value="Date" /><!-- 按日期滚动 --><layout type="log4net.Layout.PatternLayout"><!-- 布局配置 --><conversionPattern value="%date [%thread] %-5level %logger - %message%newline" /></layout><filter type="log4net.Filter.LevelMatchFilter"><!-- ERROR级别过滤器 --><levelToMatch value="ERROR" /></filter><filter type="log4net.Filter.DenyAllFilter" /><!-- 拒绝其他级别 --></appender><!-- FATAL级别日志配置开始 --><appender name="FatalFileAppender" type="log4net.Appender.RollingFileAppender"><!-- FATAL级别appender --><file type="log4net.Util.PatternString" value="logs/FATAL/FATAL_" /><!-- FATAL日志路径 --><datePattern value="yyyy-MM-dd'.txt'" /><!-- 日期格式 --><staticLogFileName value="false" /><!-- 动态文件名 --><appendToFile value="true" /><!-- 追加模式 --><rollingStyle value="Date" /><!-- 按日期滚动 --><layout type="log4net.Layout.PatternLayout"><!-- 布局配置 --><conversionPattern value="%date [%thread] %-5level %logger - %message%newline" /></layout><filter type="log4net.Filter.LevelMatchFilter"><!-- FATAL级别过滤器 --><levelToMatch value="FATAL" /></filter><filter type="log4net.Filter.DenyAllFilter" /><!-- 拒绝其他级别 --></appender><!-- 根记录器配置开始 --><root><!-- 根日志记录器配置 --><level value="ALL" /><!-- 记录所有级别的日志 --><appender-ref ref="InfoFileAppender" /><!-- 引用INFO appender --><appender-ref ref="DebugFileAppender" /><!-- 引用DEBUG appender --><appender-ref ref="WarnFileAppender" /><!-- 引用WARN appender --><appender-ref ref="ErrorFileAppender" /><!-- 引用ERROR appender --><appender-ref ref="FatalFileAppender" /><!-- 引用FATAL appender --></root></log4net>
<!-- log4net配置结束 -->

        案例如下

4.注册

        在 Program 或 Startup 中注册日志。

//构建 log4net 配置文件的完整路径
var configFilePath = Path.Combine(AppContext.BaseDirectory, "log4net.config");
//将 log4net 集成到 .NET Core 的统一日志系统中
builder.Logging.AddLog4Net(configFilePath);

        案例如下

 

        4.1.类库项目设置

        如果是类库项目，需设置 log4net.config 文件属性

        点击到文件 → 属性 → 设置

        复制到输出目录：始终赋值 / 如果较新则复制

        生成操作： 内容

5.使用

        在需要的地方可以随意使用。

using Frame4_LibraryCore.BaseConfig;
using Frame5_LibraryLogger.LogHelper;
using Microsoft.AspNetCore.Mvc;namespace DemoAPI.Controllers
{/// <summary>/// 日志测试控制器/// </summary>//[Authorize]// 保护整个控制器[Route("api/[controller]/[action]")]//标记路由地址规格[ApiController] // 标记该类为 API 控制器，启用一些默认的行为，如模型绑定、输入验证等[ApiExplorerSettings(GroupName = nameof(ApiVersionInfo.V1))]//设置控制器的API版本public class LoggerController : BaseController{/// <summary>/// 测试日志/// </summary>/// <returns></returns>[HttpGet]public bool InsertLogAsync(){//测试日志LogHelper.Info("Info");LogHelper.Error("Error");LogHelper.Debug("Debug");LogHelper.Fatal("Fatal");LogHelper.Warn("Warn");return true;}}
}

        案例如下

http://www.dtcms.com/a/283730.html

相关文章：

  • 结合自身，制定一套明确的 Web3 学习路线和技术栈建议
  • Elasticsearch MCP 服务器现已在 AWS Marketplace 上提供
  • 概念设计总监的“VR”雕刻术：用Substance 3D Modeler，实现直觉式3D建模
  • HOOPS SDK赋能PLM：打造全生命周期3D数据管理与协作能力
  • 一次多架构镜像构建实战：Docker Buildx + Harbor 踩坑记录
  • Curtain e-locker易锁防泄密:从源头把关“打印”安全
  • 电商行业如何做好网络安全工作？
  • 树莓派Qt 安装
  • 2. 框架对比类：《React 18 vs Vue3：状态管理方案深度对比》
  • React hooks——useMemo
  • 【Java开发日记】我们来说说 LockSupport 的 park 和 unpark
  • React hooks——useCallback
  • 深入理解React Hooks：从使用到原理
  • Planning Agent：基于大模型的动态规划与ReAct机制，实现复杂问题自适应执行求解
  • React 学习（4）
  • Android 实现：当后台数据限制开启时，仅限制互联网APN。
  • NLP-文本预处理
  • 使用docker安装、启动jenkins服务（mac系统）
  • 数据结构 栈(1)
  • vue-advance-concepts
  • 【Redis 】看门狗：分布式锁的自动续期
  • 部署-k8s和docker、jenkins的区别和联系
  • 静态住宅IP和节点有什么区别？哪种更适合你的需求？
  • 个人IP的塑造方向有哪些？
  • 河南萌新联赛2025第一场-河南工业大学
  • x3CTF-2025-web-复现
  • 自动化技术在造纸行业的应用：EtherCAT转PROFIBUS DP解决方案
  • 【后端】Linux系统发布.NetCore项目
  • 图片上传实现
  • web后端开发（javaweb第十天）