923 字

5 分钟

日志技术

2026-05-22

编程学习

Java

Logback

Slf4j

日志框架

SpringBoot

浏览量加载中...

AI 摘要

日志技术#

定义#

日志用于记录应用程序的运行信息、状态信息和错误信息。专业的日志框架（如 Logback）替代 System.out.println，提供灵活的日志级别控制、多种输出目标（控制台/文件）和格式化能力。

为什么需要日志框架#

使用 System.out.println(...) 记录日志的缺陷：

硬编码：无法灵活控制输出与否，只能删除代码
输出受限：只能输出到控制台
不便于扩展维护：无法按级别过滤、按格式输出

日志框架对比#

框架	特点
JUL	JavaSE 官方日志框架，配置简单但不够灵活，性能较差
Log4j	流行的日志框架，灵活的配置选项，支持多种输出目标
Logback	基于 Log4j 升级，更多功能和配置选项，性能优于 Log4j
Slf4j	简单日志门面，提供标准接口，允许切换底层日志框架

Logback 入门#

依赖引入#

SpringBoot 已内置传递 Logback 依赖，无需额外引入。若单独使用：

1
<dependency>
2
    <groupId>ch.qos.logback</groupId>
3
    <artifactId>logback-classic</artifactId>
4
    <version>1.4.11</version>
5
</dependency>

配置文件 logback.xml#

放置在 src/main/resources 目录下：

1
<?xml version="1.0" encoding="UTF-8"?>
2
<configuration>
3
    <!-- 控制台输出 -->
4
    <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
5
        <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
6
            <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{50}-%msg%n</pattern>
7
        </encoder>
8
    </appender>
9

10
    <!-- 日志输出级别 -->
11
    <root level="ALL">
12
        <appender-ref ref="STDOUT" />
13
    </root>
14
</configuration>

基本使用#

1
public class LogTest {
2
    private static final Logger log = LoggerFactory.getLogger(LogTest.class);
3

4
    @Test
5
    public void testLog() {
6
        log.debug("开始计算...");
7
        int sum = 0;
8
        int[] nums = {1, 5, 3, 2, 1, 4, 5, 4, 6, 7, 4, 34, 2, 23};
9
        for (int i = 0; i < nums.length; i++) {
10
            sum += nums[i];
11
        }
12
        log.info("计算结果为: " + sum);
13
        log.debug("结束计算...");
14
    }
15
}

Pattern 格式化占位符说明：

占位符	含义
`%d`	日期
`%thread`	线程名
`%-5level`	日志级别，左对齐 5 字符宽度
`%logger{50}`	Logger 名称，最长 50 字符
`%msg`	日志消息
`%n`	换行符

输出到文件#

1
<appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
2
    <rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
3
        <FileNamePattern>D:/tlias-%d{yyyy-MM-dd}-%i.log</FileNamePattern>
4
        <MaxHistory>30</MaxHistory>
5
        <maxFileSize>10MB</maxFileSize>
6
    </rollingPolicy>
7
    <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
8
        <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{50}-%msg%n</pattern>
9
    </encoder>
10
</appender>

关键配置项：

配置项	说明
`FileNamePattern`	日志文件名模式，`%i` 表示序号
`MaxHistory`	最多保留的历史日志文件数量
`maxFileSize`	单个文件最大大小，超出触发滚动

日志级别#

级别由低到高：TRACE → DEBUG → INFO → WARN → ERROR

<root level="info"> 表示仅输出大于等于 INFO 级别的日志（INFO / WARN / ERROR），DEBUG 和 TRACE 不会输出。

常用配置：

1
<root level="info">
2
    <appender-ref ref="STDOUT" />
3
    <appender-ref ref="FILE" />
4
</root>

配置值	效果
ALL	输出所有级别日志
OFF	关闭所有日志
INFO	仅输出 INFO、WARN、ERROR（生产环境推荐）
DEBUG	输出 DEBUG 及以上（开发调试推荐）

案例实战：@Slf4j 注解#

Lombok 提供的 @Slf4j 注解可简化日志记录器定义，等价于：

1
private static Logger log = LoggerFactory.getLogger(Xxx.class);

在 DeptController 中应用：

1
@Slf4j
2
@RequestMapping("/depts")
3
@RestController
4
public class DeptController {
5

6
    @Autowired
7
    private DeptService deptService;
8

9
    @GetMapping
10
    public Result list() {
11
        log.info("查询部门列表");
12
        List<Dept> deptList = deptService.findAll();
13
        return Result.success(deptList);
14
    }
15

16
    @DeleteMapping
17
    public Result delete(Integer id) {
18
        log.info("根据id删除部门, id: {}", id);
19
        deptService.deleteById(id);
20
        return Result.success();
21
    }
22

23
    @PostMapping
24
    public Result save(@RequestBody Dept dept) {
25
        log.info("新增部门, dept: {}", dept);
26
        deptService.save(dept);
27
        return Result.success();
28
    }
29

30
    @GetMapping("/{id}")
31
    public Result getById(@PathVariable Integer id) {
32
        log.info("根据ID查询, id: {}", id);
33
        Dept dept = deptService.getById(id);
34
        return Result.success(dept);
35
    }
36

37
    @PutMapping
38
    public Result update(@RequestBody Dept dept) {
39
        log.info("修改部门, dept: {}", dept);
40
        deptService.update(dept);
41
        return Result.success();
42
    }
43
}

使用 log.info("xxx {}", var) 占位符风格替代字符串拼接，性能更优。

常见场景#

生产环境设为 INFO 级别记录关键业务操作
开发调试时设为 DEBUG 级别查看详细执行过程
将日志输出到文件并按日期/大小滚动，便于持久化追踪

注意事项#

SpringBoot 已内置 Logback，无需额外引入依赖
logback.xml 需放在 src/main/resources 下
使用 @Slf4j 注解可省略手动定义 Logger
日志消息推荐使用 {} 占位符而非字符串拼接
生产环境不建议使用 System.out.println，应统一使用日志框架

支持与分享

如果这篇文章对你有帮助，欢迎分享给更多人或赞助支持！

赞助

日志技术

https://blog.tsh520.cn/posts/javawebai/后端基础/日志技术/

作者

团子和蛋糕

发布于

2026-05-22

许可协议

CC BY-NC-SA 4.0

博客导航栏模块完整构建方案

开发规范与工程搭建

评论区

[ 标签 ]

# AI 1 # Ajax 2 # Apifox 1 # Astro 2 # claudecode 1 # CloudFlare 1 # CSS 6 # DELETE 1 # Gist 1 # GitHub 1 # HTML 6 # HTTP 2 # Java 23 # java 13 # JavaScript 5 # JDBC 3 # JSON 1 # JUnit 1 # Logback 1 # Maven 6 # Mybatis 1 # MyBatis 4 # MySQL 6 # MySql 1 # Obsidian 1 # ORM 1 # PathVariable 1 # PicGo 1 # RequestBody 1 # RequestMapping 1 # RESTful风格 1 # Slf4j 1 # SpringBoot 11 # SQL 2 # Svelte 1 # TailwindCSS 1 # Telegram 1 # Tlias 2 # Vue 7 # Web基础 6 # YAML 1 # 三层架构 1 # 使用文档 7 # 刷步数 1 # 前端 32 # 单词 1 # 博客 2 # 博客开发 1 # 参数接收 1 # 后端 1 # 图床 1 # 存储 1 # 学习方法 1 # 导航栏 1 # 工具 1 # 开发 1 # 开发规范 1 # 开心 1 # 影视 1 # 想法 3 # 感悟 4 # 数据库 10 # 日常 13 # 日志框架 1 # 生活迁移 1 # 电影 1 # 碎碎念 1 # 网络教室 1 # 蓝奏云 1 # 记录 1 # 词根 1 # 词缀 1 # 路径参数 1 # 运动 1 # 配置 1 # 音乐 1 # 音标 1 # 驼峰命名 1

[ 分类 ]

# 编程学习 63 # 博客指南 8 # 技术分享 6 # 英语笔记本 5 # AI使用 1 # 资源整理 1

[ 公告 ]

如果你喜欢，那么欢迎来到我的世界！

了解更多

[ 音乐 ]

找不到相关结果。

[ contents ]

[ 全部文章 ]

日志技术

日志技术#

定义#

为什么需要日志框架#

日志框架对比#

Logback 入门#

依赖引入#

配置文件 logback.xml#

基本使用#

输出到文件#

日志级别#

案例实战：@Slf4j 注解#

常见场景#

注意事项#

支持与分享

相关阅读

评论区

音乐