logback日志控制服务器日志输出过程

故人难在

logback-spring.xml文件

一、确认依赖（Spring Boot 默认集成 Logback）

Spring Boot 默认使用 Logback 作为日志框架，无需额外添加依赖。

若需自定义配置，可直接编写配置文件。

二 配置 Logback（两种方式）

通过 application.yml/properties 配置（简洁版）

1. logging:
2. level:
3. root: INFO # 全局日志级别
4. com.example: DEBUG # 自定义包日志级别
5. file:
6. path: /var/log/app/ # Linux日志存储路径（需提前创建目录）
7. pattern:
8. file: "%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{50} - %msg%n" # 日志格式
9. # 滚动策略（按时间分割）
10. logback:
11. rollingpolicy:
12. file-name-pattern: /var/log/app/app-%d{yyyy-MM}.log.gz
13. max-history: 30 # 保留30天日志

复制代码

方式二：自定义 Logback XML 配置文件（灵活版）

1. <?xml version="1.0" encoding="UTF-8"?>
2. <configuration scan="true" scanPeriod="60 seconds">
4. <!-- 日志格式 -->
5. <property name="LOG_PATH" value="/var/log/app/"/>
6. <property name="LOG_NAME" value="app"/>
8. <!-- 控制台输出 -->
9. <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
10. <encoder>
11. <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{50} - %msg%n</pattern>
12. </encoder>
13. </appender>
15. <!-- 滚动文件输出（按时间分割） -->
16. <appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
17. <file>${LOG_PATH}${LOG_NAME}.log</file>
18. <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
19. <fileNamePattern>${LOG_PATH}${LOG_NAME}-%d{yyyy-MM-dd}.log.gz</fileNamePattern>
20. <maxHistory>30</maxHistory>
21. <totalSizeCap>1GB</totalSizeCap> <!-- 总占用空间 -->
22. </rollingPolicy>
23. <encoder>
24. <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{50} - %msg%n</pattern>
25. </encoder>
26. </appender>
28. <!-- 错误日志单独输出 -->
29. <appender name="ERROR_FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
30. <filter class="ch.qos.logback.classic.filter.LevelFilter">
31. <level>ERROR</level>
32. <onMatch>ACCEPT</onMatch>
33. <onMismatch>DENY</onMismatch>
34. </filter>
35. <file>${LOG_PATH}${LOG_NAME}-error.log</file>
36. <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
37. <fileNamePattern>${LOG_PATH}${LOG_NAME}-error-%d{yyyy-MM-dd}.log.gz</fileNamePattern>
38. <maxHistory>30</maxHistory>
39. </rollingPolicy>
40. <encoder>
41. <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{50} - %msg%n</pattern>
42. </encoder>
43. </appender>
45. <!-- 日志级别配置 -->
46. <root level="INFO">
47. <appender-ref ref="STDOUT"/>
48. <appender-ref ref="FILE"/>
49. <appender-ref ref="ERROR_FILE"/>
50. </root>
52. <!-- 自定义包日志级别（如调试指定模块） -->
53. <logger name="com.example" level="DEBUG" additivity="false">
54. <appender-ref ref="STDOUT"/>
55. <appender-ref ref="FILE"/>
56. </logger>
58. </configuration>

复制代码

在application.yml中指定配置文件（可选，若文件名是logback-spring.xml则无需配置）

项目指定输出日志格式 MDC使用

1 想要输出指定日志格式：

1.   [日志输出时间戳] [全局ID] [父ID] [本地ID] [线程名] [日志级别] [tid值] [微服务托管主机名/IP] msg在代码中定义的字段：[微服务IP及端口] [提供方微服务名称或编号] [方法URL] [客户端ip][行为场景] [操作主体] [操作类型] [操作对象] [处理结果] [region]
2. [2025-05-12 09:25:29.002] [VFeSsNbCSEefRlyvxSR5pg] [0] [VFeSsNbCSEefRlyvxSR5pg] [httpWorkerThread-8001-6] [INFO] [TID: N/A] [NZB23315479/11.204.8.24] [http://11.204.8.24:8001] [xx微服务/系统] [/log/sayHello] [11.204.8.24] [用户行为][gushukuan] [账号更新] [user1 name from张**to 李**;moible from 186****1234to 186****5431;idcard from 110***********3210 to 120***********7890] [成功] [0]

复制代码

2 核心结论

• 通用字段（如全局 ID、用户信息、客户端 IP 等）：建议通过拦截器（Interceptor）、过滤器（Filter）或 AOP 统一处理，避免在每个接口中重复赋值。
• 接口专属字段（如操作对象、行为场景等）：需要在具体接口中手动赋值（或通过业务逻辑层传递到 MDC）。

3 核心

• MDC 的核心作用是在同一线程的调用链中共享上下文信息（如日志字段），无需在方法参数中显式传递，最终通过日志框架输出到日志中

4 代码配置

• %X{MDC变量}

1. <configuration>
2. <!-- 控制台输出 -->
3. <appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
4. <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
5. <!-- 定义日志格式，严格按需求顺序排列字段 -->
6. <pattern>
7. [%d{yyyy-MM-dd HH:mm:ss.SSS}] [%X{globalId}] [%X{parentId}] [%X{localId}] [%thread] [%level] [%X{tid}] [%hostName/%X{serverIp}] [%X{serviceUrl}] [%X{serviceName}] [%X{methodUrl}] [%X{clientIp}] [%X{scene}] [%X{operator}] [%X{operation}] [%msg] [%X{result}] [%X{region}]%n
8. </pattern>
9. </encoder>
10. </appender>
12. <!-- 根日志级别 -->
13. <root level="INFO">
14. <appender-ref ref="CONSOLE" />
15. </root>
16. </configuration>

复制代码

5 映射区别

• %X{变量}：%X 用于访问 MDC（Mapped Diagnostic Context，映射诊断上下文）中存放的键值对。MDC 是一个线程安全的集合，允许应用程序在运行时将自定义的诊断信息与日志记录关联起来。通过 %X{变量名} 可以获取 MDC 中对应变量名的值 。比如，在代码中设置一些与请求相关的上下文信息（如请求 ID、用户 ID 等），方便在日志中追踪特定请求的处理情况。
• %hostName：%hostName 是 Logback 提供的一种内置的转换字，用于获取当前运行日志程序的主机名 。它是 Logback 根据运行环境直接获取的固定信息，不需要手动在代码中设置特定的上下文来赋值。

三、Linux 服务器部署注意事项

1. 创建日志目录并设置权限

• 在Linux服务器创建日志目录（需与配置中的路径一致）

1. mkdir -p /var/log/app

复制代码

• 赋予读写权限（假设应用以tomcat用户运行）

1. chown -R tomcat:tomcat /var/log/app
2. chmod -R 755 /var/log/app

复制代码

2. 打包与启动应用

• 打包Spring Boot应用

1. mvn clean package -DskipTests

复制代码

• 上传jar包到服务器并启动

1. nohup java -jar app.jar > /dev/null 2>&1 &

复制代码

• 查看日志

1. tail -f /var/log/app/app.log

复制代码

3. 日志滚动与管理

• 自动分割：Logback 会按配置定期生成新日志文件，并压缩旧文件（如app-2025-06-27.log.gz）。
• 手动清理：可添加定时任务（crontab）删除过期日志：

每天凌晨1点清理60天前的日志

1. 0 1 * * * find /var/log/app -name “*.log.gz” -mtime +60 -exec rm {} ;

复制代码

四、常见问题与解决方案

日志文件未生成

• 检查 Linux 路径是否存在，应用用户是否有写入权限（使用ls -la /var/log/app查看权限）。
• 确认配置文件中的路径是否与实际一致，可尝试使用绝对路径（如/home/app/logs/）。

日志级别未生效

• 检查配置文件中level是否正确，自定义包路径是否匹配（如com.example需与项目包名一致）。

中文日志乱码

在 Logback 配置中添加编码设置：

1. UTF-8…

复制代码

总结

以上为个人经验，希望能给大家一个参考，也希望大家多多支持晓枫资讯。

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！