Spring Boot日志与调试：让你的应用更透明、更高效!

🏆本文收录于「滚雪球学SpringBoot」专栏，手把手带你零基础入门Spring Boot，从入门到就业，助你早日登顶实现财富自由🚀；同时，欢迎大家关注&&收藏&&订阅！持续更新中，up！up！up！！

@TOC

环境说明：Windows 10 + IntelliJ IDEA 2021.3.2 + Jdk 1.8

🚀 前言

亲爱的开发者们，是否曾经在开发应用的过程中遇到过这样的问题：应用突然出现了奇怪的错误，或者某个功能无法正常工作，而你却没有任何线索来找到根本原因？这种情况是不是让你感到无从下手、焦头烂额？如果是这样，那么你就需要借助日志和调试的力量了！✨

在日常开发中，日志无疑是我们最强的“探照灯”，它可以帮助我们清晰地了解应用运行的状态、排查问题，甚至监控生产环境中的应用表现。而Spring Boot作为一个高度优化和配置的框架，它提供了非常强大的日志功能，让你能够更高效地调试和维护你的应用。

今天，就让我们来深入了解Spring Boot的日志系统，从默认配置到日志级别的调整，再到使用Logback和Log4j2这些日志框架，我们将逐一展示如何在Spring Boot中让日志助你一臂之力！💪

🧐 前言：日志与调试的必要性

想象一下，没有日志的开发世界就像是盲人驾驶。日志就像是应用的“眼睛”，它能够帮助你及时发现问题并采取措施。无论是在开发阶段、测试阶段，还是生产环境中，日志都扮演着至关重要的角色。日志是你了解应用运行情况的直接途径，没有日志，调试和排错就会变得非常困难。

但是，很多开发者常常会忽略日志的配置，直到某一天应用出现了问题，才发现没有日志记录下来关键的信息。而Spring Boot在这方面已经为我们准备好了很多便利的工具，能够帮助我们轻松配置、调整和优化日志输出，让我们在面对错误时能迅速做出反应。

🔧 Spring Boot 默认日志配置

首先，让我们从Spring Boot的默认日志配置谈起。Spring Boot默认使用的是Logback作为日志框架，它自动为我们配置好了基本的日志设置，无需我们手动进行配置，简单易用！

Logback - 默认的日志框架

Spring Boot的默认日志框架是Logback，它提供了强大的功能，可以支持控制台输出、文件输出、日志级别控制、日志轮转等功能。Logback的好处之一就是它能够通过自动化配置，使得开发者无需再为日志配置折腾太多时间。

默认日志输出：

• 日志级别：默认情况下，日志级别是 INFO，这意味着只有INFO级别以上的日志会被输出到控制台（INFO、WARN、ERROR等），DEBUG和TRACE级别的日志默认不会显示。
• 日志输出位置：默认情况下，日志信息会输出到控制台。如果你需要保存到文件中，可以通过自定义配置来调整。
• 日志格式：默认的日志格式会包括时间戳、日志级别、日志内容等信息，非常适合开发过程中快速定位问题。

1. 如何修改日志级别

在Spring Boot中，调整日志级别非常简单，你可以在 application.properties 或者 application.yml 文件中设置不同的日志级别。这种方式不仅让你可以控制不同模块的日志输出级别，还能根据环境变化进行灵活配置。

1.1 在application.properties中配置日志级别

# 设置默认的日志级别
logging.level.root=INFO

# 针对Spring框架的日志级别
logging.level.org.springframework.web=DEBUG
logging.level.org.hibernate=ERROR

# 针对自定义包或类的日志级别
logging.level.com.myapp.controller=DEBUG  # 控制器日志

通过上述配置，你可以很方便地控制不同模块或包的日志输出。例如，我们将org.springframework.web的日志级别设置为DEBUG，这意味着所有Spring Web相关的请求和响应的细节都会被输出到日志中。

1.2 在application.yml中配置日志级别

logging:
  level:
    root: INFO
    org.springframework.web: DEBUG
    com.myapp.controller: DEBUG

这种配置方式与application.properties类似，只是采用了YAML格式，更符合一些开发者的习惯。

日志级别概述

日志级别控制了不同类型的日志输出，下面是常见的日志级别以及它们的作用：

• TRACE：用于最详细的日志记录，通常用于调试非常细节的代码行为。适用于开发调试阶段。
• DEBUG：调试日志，用于记录程序运行中的详细调试信息，帮助开发者了解程序的内部工作状态。
• INFO：信息日志，通常用于记录正常的程序运行信息，表示系统在正常工作。
• WARN：警告日志，表示出现了潜在的问题或不正常的行为，但系统依然能够正常运行。
• ERROR：错误日志，表示程序出现了异常或错误，可能导致某些功能无法正常运行。
• OFF：关闭日志记录。

2. 使用Logback和Log4j2

使用Logback

Logback是Spring Boot的默认日志框架，它支持日志输出到控制台、文件，并且支持灵活的日志格式化和日志文件轮转。如果你想自定义日志配置，可以创建logback-spring.xml文件，并根据需要进行调整。

Logback配置示例：

<configuration>

  <!-- 设置日志级别 -->
  <logger name="org.springframework.web" level="DEBUG"/>
  
  <!-- 设置日志输出到控制台 -->
  <appender name="ConsoleAppender" class="ch.qos.logback.core.ConsoleAppender">
    <encoder>
      <pattern>%d{yyyy-MM-dd HH:mm:ss} - %msg%n</pattern>
    </encoder>
  </appender>

  <root level="INFO">
    <appender-ref ref="ConsoleAppender"/>
  </root>

</configuration>

通过配置文件，你可以控制日志的输出格式、日志级别、输出目的地等。在开发过程中，通常会输出到控制台，而在生产环境中，更多时候是将日志保存到文件中，便于长期监控。

使用Log4j2

如果你更喜欢使用Log4j2作为日志框架，Spring Boot也非常支持。你只需要将logback依赖替换为log4j2依赖即可。

Log4j2配置示例：

<?xml version="1.0" encoding="UTF-8"?>
<Configuration status="WARN">
    <Appenders>
        <Console name="Console" target="SYSTEM_OUT">
            <PatternLayout>
                <pattern>%d{yyyy-MM-dd HH:mm:ss} [%t] %-5level %logger{36} - %msg%n</pattern>
            </PatternLayout>
        </Console>
        
        <RollingFile name="File" fileName="logs/app.log" filePattern="logs/app-%d{yyyy-MM-dd}.log">
            <PatternLayout>
                <pattern>%d{yyyy-MM-dd HH:mm:ss} [%t] %-5level %logger{36} - %msg%n</pattern>
            </PatternLayout>
            <Policies>
                <TimeBasedTriggeringPolicy interval="1" modulate="true"/>
            </Policies>
        </RollingFile>
    </Appenders>

    <Loggers>
        <Root level="info">
            <AppenderRef ref="Console"/>
            <AppenderRef ref="File"/>
        </Root>

        <Logger name="org.springframework" level="warn"/>
        <Logger name="com.myapp" level="debug"/>
    </Loggers>
</Configuration>

通过log4j2-spring.xml配置文件，你可以更灵活地控制日志输出，不仅可以控制日志的格式、级别，还能设置日志的滚动策略，保证日志文件不会无限增大，达到日志管理的目的。

🏁 总结：日志是你调试的“眼睛”，调试是你开发的“武器”！

日志系统在Spring Boot中扮演了至关重要的角色，它让你能快速定位问题，监控应用状态，保证系统的稳定运行。无论是开发调试，还是生产环境中日志的管理，Spring Boot都提供了强大的支持。你可以通过调整日志级别，选择不同的日志框架（Logback、Log4j2等），以及灵活配置日志输出格式和目的地，最大程度地提升开发效率和系统可维护性。

希望通过今天的讲解，你能够更好地利用Spring Boot的日志系统，在调试过程中得心应手，随时发现潜在问题。日志不仅仅是一个技术细节，它是你了解应用运行状态、确保代码质量和解决问题的关键工具！

动手试试Spring Boot的日志配置，感受它带给你调试开发的便利！🌟

🧧福利赠与你🧧

  无论你是计算机专业的学生，还是对编程有兴趣的小伙伴，都建议直接毫无顾忌的学习此专栏「滚雪球学SpringBoot」，bug菌郑重承诺，凡是学习此专栏的同学，均能获取到所需的知识和技能，全网最快速入门SpringBoot，就像滚雪球一样，越滚越大， 无边无际，指数级提升。

最后，如果这篇文章对你有所帮助，帮忙给作者来个一键三连，关注、点赞、收藏，您的支持就是我坚持写作最大的动力。

同时欢迎大家关注公众号:「猿圈奇妙屋」 ，以便学习更多同类型的技术文章，免费白嫖最新BAT互联网公司面试题、4000G pdf电子书籍、简历模板、技术文章Markdown文档等海量资料。

✨️ Who am I?

我是bug菌，CSDN | 掘金 | InfoQ | 51CTO | 华为云 | 阿里云 | 腾讯云 等社区博客专家，C站博客之星Top30，华为云多年度十佳博主/价值贡献奖，掘金多年度人气作者Top40，掘金等各大社区平台签约作者，51CTO年度博主Top12，掘金/InfoQ/51CTO等社区优质创作者；全网粉丝合计 30w+；更多精彩福利点击这里；硬核微信公众号「猿圈奇妙屋」，欢迎你的加入！免费白嫖最新BAT互联网公司面试真题、4000G PDF电子书籍、简历模板等海量资料，你想要的我都有，关键是你不来拿。

-End-