SpringBoot3中使用mzt-biz-log实现高效操作日志记录

1. 项目背景与核心价值

在业务系统开发中，操作日志记录是个看似简单却暗藏玄机的需求。传统做法往往需要在每个业务方法里手动插入日志代码，不仅重复劳动严重，还容易破坏代码整洁性。更头疼的是，当需要修改日志格式或增加字段时，得逐个方法调整，维护成本极高。

mzt-biz-log这个轻量级组件正是为解决这些痛点而生。它基于注解和AOP实现，通过@BizLog一个注解就能自动记录方法入参、返回值、操作人等信息。我在最近一个SpringBoot3项目中集成该组件后，日志相关代码量减少了70%，而且再也不用担心漏记关键操作日志。

2. 环境准备与基础集成

2.1 依赖配置

首先在pom.xml中添加最新依赖（以2023年10月版本为例）：

xml复制<dependency>
    <groupId>com.mzt</groupId>
    <artifactId>mzt-biz-log-spring-boot-starter</artifactId>
    <version>3.1.0</version>
</dependency>

注意：SpringBoot3需要配合3.x以上版本，2.x版本会存在兼容性问题。我曾在降级测试时发现Jackson序列化异常，这是SpringBoot3对JDK17新特性的支持导致的。

2.2 基础配置

在application.yml中添加最小配置：

yaml复制mzt:
  biz-log:
    app-name: order-service  # 应用标识
    db-store: true           # 是否存储数据库
    kafka-store: false       # 按需开启Kafka推送

3. 核心功能实战解析

3.1 基础日志记录

在Controller或Service方法上添加@BizLog注解：

java复制@BizLog(title = "订单创建", bizType = "order:create")
@PostMapping("/orders")
public OrderDTO createOrder(@RequestBody OrderCreateVO vo) {
    // 业务逻辑