如何通过mzt-biz-log框架优雅解决SpringBoot操作日志记录难题【免费下载链接】mzt-biz-log支持Springboot基于注解的可使用变量、可以自定义函数的通用操作日志组件项目地址: https://gitcode.com/gh_mirrors/mz/mzt-biz-log在当今的企业级应用开发中操作日志框架的记录与管理往往是开发中最容易被忽视却又至关重要的环节。你是否也曾为以下问题而烦恼业务代码中充斥着大量日志记录代码导致业务逻辑与日志逻辑高度耦合不同开发人员记录的日志格式千差万别给后续的审计和排查带来巨大困难或者需要手动对比对象差异编写繁琐的变更描述mzt-biz-log正是为解决这些痛点而生的SpringBoot操作日志组件。它通过注解驱动的方式将日志记录逻辑从业务代码中彻底解耦提供了一套完整、灵活、可扩展的操作日志解决方案。 痛点分析传统操作日志记录的三大难题1. 代码侵入性过强传统的日志记录方式往往需要在业务方法中直接编写日志代码这不仅破坏了代码的整洁性还使得业务逻辑与日志逻辑紧密耦合。当需要修改日志格式或增加新的日志字段时往往需要修改大量业务代码。2. 日志格式不统一不同的开发人员、不同的业务模块可能会采用不同的日志记录方式导致系统内的日志格式千差万别给后续的日志分析、审计和问题排查带来极大困难。3. 对象变更对比繁琐在记录对象更新操作时需要手动对比新旧对象的差异并生成可读的变更描述。这个过程不仅繁琐而且容易出错特别是当对象结构复杂或字段较多时。️ 解决方案mzt-biz-log的核心设计哲学mzt-biz-log采用声明式编程的思想通过注解的方式定义操作日志让开发者能够专注于业务逻辑的实现而将日志记录的工作交给框架自动完成。核心特性概览注解驱动通过LogRecord注解即可完成日志记录配置智能变量解析支持Spring EL表达式获取方法参数和返回值自定义函数扩展提供灵活的扩展机制支持自定义解析函数对象差异对比自动对比对象变化生成清晰的变更描述事务一致性支持日志记录与业务操作在同一事务中 快速上手5分钟集成操作日志框架环境准备与依赖引入首先将mzt-biz-log添加到你的项目中dependency groupIdio.github.mouzt/groupId artifactIdbizlog-sdk/artifactId version3.0.7-SNAPSHOT/version /dependency启用日志记录功能在SpringBoot启动类上添加EnableLogRecord注解SpringBootApplication EnableLogRecord(tenant your-tenant-id) public class Application { public static void main(String[] args) { SpringApplication.run(Application.class, args); } }小贴士tenant参数用于区分不同业务或服务通常一个服务或一个业务下的多个服务使用同一个tenant即可。基本使用示例让我们从一个简单的订单创建场景开始Service public class OrderService { LogRecord( success {{#order.purchaseName}}创建了订单订单号{{#order.orderNo}}, type ORDER, bizNo {{#order.orderNo}} ) public boolean createOrder(Order order) { // 业务逻辑实现 return orderRepository.save(order); } }在这个例子中当createOrder方法成功执行后框架会自动记录一条操作日志内容为张三创建了订单订单号ORD20230719001。 核心功能深度解析1. 灵活的变量表达式系统mzt-biz-log支持完整的Spring EL表达式可以轻松访问方法参数、返回值甚至静态方法LogRecord( success {{#user.name}}更新了用户信息用户ID{{#user.id}}操作结果{{#_ret}}, fail {{#user.name}}更新用户信息失败原因{{#_errorMsg}}, type USER, bizNo {{#user.id}} ) public boolean updateUser(User user) { // 业务逻辑 return userRepository.update(user); }可用变量说明#user.name访问方法参数#_ret访问方法返回值#_errorMsg访问异常信息T(java.util.UUID).randomUUID()调用静态方法2. 上下文变量管理在某些复杂场景下我们可能需要在方法内部设置额外的变量供日志模板使用LogRecord( success {{#operator}}修改了订单状态从{{#oldStatus}}到{{#newStatus}}, type ORDER, bizNo {{#orderId}} ) public boolean updateOrderStatus(Long orderId, String newStatus) { // 查询旧状态 String oldStatus orderRepository.getStatus(orderId); // 将变量放入上下文 LogRecordContext.putVariable(oldStatus, oldStatus); LogRecordContext.putVariable(newStatus, newStatus); // 执行状态更新 return orderRepository.updateStatus(orderId, newStatus); }3. 智能对象差异对比这是mzt-biz-log最强大的功能之一。通过_DIFF函数可以自动对比对象变化Data DiffLogAllFields public class User { DiffLogField(name 用户ID) private Long id; DiffLogField(name 用户名) private String username; DiffLogField(name 邮箱) private String email; DIffLogIgnore private String password; // 敏感字段不记录差异 } Service public class UserService { LogRecord( success 更新了用户信息{_DIFF{#oldUser, #newUser}}, type USER, bizNo {{#newUser.id}} ) public boolean updateUser(User oldUser, User newUser) { // 更新用户信息 return userRepository.update(newUser); } }当用户信息发生变化时框架会自动生成类似这样的日志更新了用户信息【用户名】从【张三】修改为【李四】【邮箱】从【zhangsanexample.com】修改为【lisiexample.com】4. 自定义函数扩展对于需要特殊处理的字段可以通过自定义函数进行扩展Component public class UserParseFunction implements IParseFunction { Autowired private UserRepository userRepository; Override public String functionName() { return USER; } Override public String apply(Object value) { if (value null) return ; Long userId Long.parseLong(value.toString()); User user userRepository.findById(userId); return user ! null ? user.getName() ( userId ) : String.valueOf(userId); } }使用自定义函数LogRecord( success {{#operator}}将订单负责人从{USER{#oldOwnerId}}变更为{USER{#newOwnerId}}, type ORDER, bizNo {{#orderId}} ) public boolean changeOrderOwner(Long orderId, Long oldOwnerId, Long newOwnerId) { // 业务逻辑 return orderRepository.updateOwner(orderId, newOwnerId); }️ 项目架构与核心组件核心模块结构mzt-biz-log采用清晰的分层架构设计bizlog-sdk/ ├── src/main/java/com/mzt/logapi/ │ ├── starter/annotation/ # 核心注解定义 │ │ ├── LogRecord.java # 主注解 │ │ ├── DiffLogField.java # 差异日志字段注解 │ │ └── EnableLogRecord.java # 启用注解 │ ├── service/ # 服务接口 │ │ ├── ILogRecordService.java # 日志记录服务 │ │ ├── IParseFunction.java # 解析函数接口 │ │ └── IOperatorGetService.java # 操作人获取服务 │ └── support/ # 支持类 │ ├── aop/ # AOP切面 │ └── parse/ # 表达式解析核心注解详解LogRecord注解是框架的核心它包含了所有日志记录所需的配置Target({ElementType.METHOD, ElementType.TYPE}) Retention(RetentionPolicy.RUNTIME) public interface LogRecord { String success(); // 成功日志模板 String fail() default ; // 失败日志模板 String operator() default ; // 操作人 String type(); // 日志类型 String subType() default ; // 子类型 String bizNo(); // 业务标识 String extra() default ; // 额外信息 String condition() default ; // 记录条件 String successCondition() default ; // 成功条件 } 高级配置与最佳实践1. 操作人自动获取为了避免在每个注解中手动指定操作人可以实现IOperatorGetService接口Service public class CurrentUserOperatorService implements IOperatorGetService { Override public Operator getUser() { // 从安全上下文获取当前用户 Authentication authentication SecurityContextHolder.getContext() .getAuthentication(); if (authentication ! null authentication.isAuthenticated()) { UserDetails userDetails (UserDetails) authentication.getPrincipal(); return new Operator(userDetails.getUsername()); } return new Operator(SYSTEM); } }2. 日志存储策略框架提供了灵活的存储扩展点可以根据业务需求选择不同的存储方式Service public class CustomLogRecordService implements ILogRecordService { Autowired private LogRecordMapper logRecordMapper; Override Transactional(propagation Propagation.REQUIRES_NEW) public void record(LogRecord logRecord) { // 转换为持久化对象 LogRecordPO po convertToPO(logRecord); // 保存到数据库 logRecordMapper.insert(po); // 可选发送到消息队列 kafkaTemplate.send(operation-log, po); } Override public ListLogRecord queryLog(String bizNo, CollectionString types) { // 查询实现 return logRecordMapper.selectByBizNoAndTypes(bizNo, types); } }3. 事务一致性配置在某些需要强一致性的场景下可以配置日志记录与业务操作在同一个事务中SpringBootApplication EnableLogRecord(tenant order-service, joinTransaction true) EnableTransactionManagement(order 0) public class OrderApplication { public static void main(String[] args) { SpringApplication.run(OrderApplication.class, args); } } 实际应用场景示例电商订单系统Service public class OrderServiceImpl implements OrderService { LogRecord( success {{#operator}}创建了订单订单号{{#order.orderNo}}金额¥{{#order.amount}}, fail {{#operator}}创建订单失败原因{{#_errorMsg}}, type ORDER_CREATE, bizNo {{#order.orderNo}} ) public Order createOrder(OrderCreateRequest request) { // 订单创建逻辑 Order order orderMapper.create(request); // 记录额外上下文 LogRecordContext.putVariable(operator, getCurrentUser()); return order; } LogRecord( success {{#operator}}修改了订单状态{_DIFF{#oldOrder, #newOrder}}, type ORDER_UPDATE, bizNo {{#newOrder.orderNo}} ) public boolean updateOrder(Order oldOrder, Order newOrder) { // 订单更新逻辑 return orderMapper.update(newOrder); } }用户管理系统Service public class UserServiceImpl implements UserService { LogRecord( success {{#operator}}创建了用户{{#user.username}}{{#user.email}}, type USER_CREATE, bizNo {{#user.id}} ) public User createUser(User user) { // 用户创建逻辑 User created userRepository.save(user); // 记录操作人 LogRecordContext.putVariable(operator, SecurityUtils.getCurrentUsername()); return created; } LogRecord( success {{#operator}}更新了用户权限{_DIFF{#oldUser.roles, #newUser.roles}}, type USER_PERMISSION, bizNo {{#newUser.id}}, condition {{#oldUser.roles ! #newUser.roles}} ) public boolean updateUserRoles(User oldUser, User newUser) { // 仅当角色发生变化时才记录日志 return userRepository.updateRoles(newUser); } }⚡ 性能优化建议1. 合理使用条件记录对于频繁调用的方法可以使用condition属性避免不必要的日志记录LogRecord( success 更新了配置项{{#config.key}}, type CONFIG_UPDATE, bizNo {{#config.key}}, condition {{#oldConfig.value ! #newConfig.value}} ) public boolean updateConfig(Config oldConfig, Config newConfig) { // 仅当值发生变化时才记录日志 return configRepository.update(newConfig); }2. 批量操作优化对于批量操作可以考虑在业务层面进行聚合记录而不是为每个操作单独记录LogRecord( success 批量更新了{{#userIds.size()}}个用户的状态为{{#newStatus}}, type USER_BATCH_UPDATE, bizNo BATCH_{{T(java.util.UUID).randomUUID()}} ) public boolean batchUpdateUserStatus(ListLong userIds, String newStatus) { // 批量更新逻辑 return userRepository.batchUpdateStatus(userIds, newStatus); }3. 异步日志记录对于性能要求较高的场景可以实现异步日志记录Service public class AsyncLogRecordService implements ILogRecordService { Autowired private ThreadPoolTaskExecutor logExecutor; Override public void record(LogRecord logRecord) { logExecutor.execute(() - { // 异步保存日志 logRecordMapper.insert(convertToPO(logRecord)); }); } } 常见问题与解决方案Q1为什么在某些类上注解不生效A这可能与Bean的生命周期有关。确保被注解的类在BeanFactoryLogRecordAdvisor初始化之后才被加载。可以通过调整Bean的加载顺序或使用DependsOn注解来解决。Q2如何控制日志记录的粒度A可以通过以下方式控制日志记录粒度使用condition属性控制是否记录日志使用successCondition属性控制成功/失败日志的记录在配置文件中设置mzt.log.record.diffLog来控制差异日志的记录行为Q3如何处理敏感字段A使用DIffLogIgnore注解标记敏感字段public class User { private Long id; private String username; DIffLogIgnore private String password; // 敏感字段不参与差异对比 DIffLogIgnore private String phone; // 敏感字段不参与差异对比 }Q4如何自定义日志模板A可以通过配置文件自定义差异日志的模板格式mzt: log: record: updateTemplate: 字段【__fieldName】从【__sourceValue】修改为【__targetValue】 addTemplate: 新增了字段【__fieldName】【__targetValue】 deleteTemplate: 删除了字段【__fieldName】【__sourceValue】 总结与展望mzt-biz-log作为一款专业的SpringBoot操作日志框架通过其注解驱动的设计理念和高度可扩展的架构成功解决了传统操作日志记录中的诸多痛点。无论是简单的日志记录需求还是复杂的对象差异对比场景它都能提供优雅的解决方案。核心优势总结零侵入性通过注解实现完全解耦业务逻辑与日志逻辑高度灵活支持Spring EL表达式、自定义函数、条件记录等多种特性强大扩展提供完整的扩展接口支持自定义存储、操作人获取等智能对比内置对象差异对比功能自动生成清晰的变更描述生产就绪支持事务一致性、性能监控等企业级特性下一步行动建议克隆项目到本地进行体验git clone https://gitcode.com/gh_mirrors/mz/mzt-biz-log查看示例项目bizlog-server中的完整使用案例根据业务需求实现自定义的IParseFunction和ILogRecordService在生产环境中逐步替换现有的日志记录代码通过采用mzt-biz-log您不仅可以大幅提升开发效率还能确保系统操作日志的一致性和可维护性为后续的审计、监控和问题排查打下坚实基础。【免费下载链接】mzt-biz-log支持Springboot基于注解的可使用变量、可以自定义函数的通用操作日志组件项目地址: https://gitcode.com/gh_mirrors/mz/mzt-biz-log创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
如何通过mzt-biz-log框架优雅解决SpringBoot操作日志记录难题
发布时间：2026/7/19 14:37:18
如何通过mzt-biz-log框架优雅解决SpringBoot操作日志记录难题【免费下载链接】mzt-biz-log支持Springboot基于注解的可使用变量、可以自定义函数的通用操作日志组件项目地址: https://gitcode.com/gh_mirrors/mz/mzt-biz-log在当今的企业级应用开发中操作日志框架的记录与管理往往是开发中最容易被忽视却又至关重要的环节。你是否也曾为以下问题而烦恼业务代码中充斥着大量日志记录代码导致业务逻辑与日志逻辑高度耦合不同开发人员记录的日志格式千差万别给后续的审计和排查带来巨大困难或者需要手动对比对象差异编写繁琐的变更描述mzt-biz-log正是为解决这些痛点而生的SpringBoot操作日志组件。它通过注解驱动的方式将日志记录逻辑从业务代码中彻底解耦提供了一套完整、灵活、可扩展的操作日志解决方案。 痛点分析传统操作日志记录的三大难题1. 代码侵入性过强传统的日志记录方式往往需要在业务方法中直接编写日志代码这不仅破坏了代码的整洁性还使得业务逻辑与日志逻辑紧密耦合。当需要修改日志格式或增加新的日志字段时往往需要修改大量业务代码。2. 日志格式不统一不同的开发人员、不同的业务模块可能会采用不同的日志记录方式导致系统内的日志格式千差万别给后续的日志分析、审计和问题排查带来极大困难。3. 对象变更对比繁琐在记录对象更新操作时需要手动对比新旧对象的差异并生成可读的变更描述。这个过程不仅繁琐而且容易出错特别是当对象结构复杂或字段较多时。️ 解决方案mzt-biz-log的核心设计哲学mzt-biz-log采用声明式编程的思想通过注解的方式定义操作日志让开发者能够专注于业务逻辑的实现而将日志记录的工作交给框架自动完成。核心特性概览注解驱动通过LogRecord注解即可完成日志记录配置智能变量解析支持Spring EL表达式获取方法参数和返回值自定义函数扩展提供灵活的扩展机制支持自定义解析函数对象差异对比自动对比对象变化生成清晰的变更描述事务一致性支持日志记录与业务操作在同一事务中 快速上手5分钟集成操作日志框架环境准备与依赖引入首先将mzt-biz-log添加到你的项目中dependency groupIdio.github.mouzt/groupId artifactIdbizlog-sdk/artifactId version3.0.7-SNAPSHOT/version /dependency启用日志记录功能在SpringBoot启动类上添加EnableLogRecord注解SpringBootApplication EnableLogRecord(tenant your-tenant-id) public class Application { public static void main(String[] args) { SpringApplication.run(Application.class, args); } }小贴士tenant参数用于区分不同业务或服务通常一个服务或一个业务下的多个服务使用同一个tenant即可。基本使用示例让我们从一个简单的订单创建场景开始Service public class OrderService { LogRecord( success {{#order.purchaseName}}创建了订单订单号{{#order.orderNo}}, type ORDER, bizNo {{#order.orderNo}} ) public boolean createOrder(Order order) { // 业务逻辑实现 return orderRepository.save(order); } }在这个例子中当createOrder方法成功执行后框架会自动记录一条操作日志内容为张三创建了订单订单号ORD20230719001。 核心功能深度解析1. 灵活的变量表达式系统mzt-biz-log支持完整的Spring EL表达式可以轻松访问方法参数、返回值甚至静态方法LogRecord( success {{#user.name}}更新了用户信息用户ID{{#user.id}}操作结果{{#_ret}}, fail {{#user.name}}更新用户信息失败原因{{#_errorMsg}}, type USER, bizNo {{#user.id}} ) public boolean updateUser(User user) { // 业务逻辑 return userRepository.update(user); }可用变量说明#user.name访问方法参数#_ret访问方法返回值#_errorMsg访问异常信息T(java.util.UUID).randomUUID()调用静态方法2. 上下文变量管理在某些复杂场景下我们可能需要在方法内部设置额外的变量供日志模板使用LogRecord( success {{#operator}}修改了订单状态从{{#oldStatus}}到{{#newStatus}}, type ORDER, bizNo {{#orderId}} ) public boolean updateOrderStatus(Long orderId, String newStatus) { // 查询旧状态 String oldStatus orderRepository.getStatus(orderId); // 将变量放入上下文 LogRecordContext.putVariable(oldStatus, oldStatus); LogRecordContext.putVariable(newStatus, newStatus); // 执行状态更新 return orderRepository.updateStatus(orderId, newStatus); }3. 智能对象差异对比这是mzt-biz-log最强大的功能之一。通过_DIFF函数可以自动对比对象变化Data DiffLogAllFields public class User { DiffLogField(name 用户ID) private Long id; DiffLogField(name 用户名) private String username; DiffLogField(name 邮箱) private String email; DIffLogIgnore private String password; // 敏感字段不记录差异 } Service public class UserService { LogRecord( success 更新了用户信息{_DIFF{#oldUser, #newUser}}, type USER, bizNo {{#newUser.id}} ) public boolean updateUser(User oldUser, User newUser) { // 更新用户信息 return userRepository.update(newUser); } }当用户信息发生变化时框架会自动生成类似这样的日志更新了用户信息【用户名】从【张三】修改为【李四】【邮箱】从【zhangsanexample.com】修改为【lisiexample.com】4. 自定义函数扩展对于需要特殊处理的字段可以通过自定义函数进行扩展Component public class UserParseFunction implements IParseFunction { Autowired private UserRepository userRepository; Override public String functionName() { return USER; } Override public String apply(Object value) { if (value null) return ; Long userId Long.parseLong(value.toString()); User user userRepository.findById(userId); return user ! null ? user.getName() ( userId ) : String.valueOf(userId); } }使用自定义函数LogRecord( success {{#operator}}将订单负责人从{USER{#oldOwnerId}}变更为{USER{#newOwnerId}}, type ORDER, bizNo {{#orderId}} ) public boolean changeOrderOwner(Long orderId, Long oldOwnerId, Long newOwnerId) { // 业务逻辑 return orderRepository.updateOwner(orderId, newOwnerId); }️ 项目架构与核心组件核心模块结构mzt-biz-log采用清晰的分层架构设计bizlog-sdk/ ├── src/main/java/com/mzt/logapi/ │ ├── starter/annotation/ # 核心注解定义 │ │ ├── LogRecord.java # 主注解 │ │ ├── DiffLogField.java # 差异日志字段注解 │ │ └── EnableLogRecord.java # 启用注解 │ ├── service/ # 服务接口 │ │ ├── ILogRecordService.java # 日志记录服务 │ │ ├── IParseFunction.java # 解析函数接口 │ │ └── IOperatorGetService.java # 操作人获取服务 │ └── support/ # 支持类 │ ├── aop/ # AOP切面 │ └── parse/ # 表达式解析核心注解详解LogRecord注解是框架的核心它包含了所有日志记录所需的配置Target({ElementType.METHOD, ElementType.TYPE}) Retention(RetentionPolicy.RUNTIME) public interface LogRecord { String success(); // 成功日志模板 String fail() default ; // 失败日志模板 String operator() default ; // 操作人 String type(); // 日志类型 String subType() default ; // 子类型 String bizNo(); // 业务标识 String extra() default ; // 额外信息 String condition() default ; // 记录条件 String successCondition() default ; // 成功条件 } 高级配置与最佳实践1. 操作人自动获取为了避免在每个注解中手动指定操作人可以实现IOperatorGetService接口Service public class CurrentUserOperatorService implements IOperatorGetService { Override public Operator getUser() { // 从安全上下文获取当前用户 Authentication authentication SecurityContextHolder.getContext() .getAuthentication(); if (authentication ! null authentication.isAuthenticated()) { UserDetails userDetails (UserDetails) authentication.getPrincipal(); return new Operator(userDetails.getUsername()); } return new Operator(SYSTEM); } }2. 日志存储策略框架提供了灵活的存储扩展点可以根据业务需求选择不同的存储方式Service public class CustomLogRecordService implements ILogRecordService { Autowired private LogRecordMapper logRecordMapper; Override Transactional(propagation Propagation.REQUIRES_NEW) public void record(LogRecord logRecord) { // 转换为持久化对象 LogRecordPO po convertToPO(logRecord); // 保存到数据库 logRecordMapper.insert(po); // 可选发送到消息队列 kafkaTemplate.send(operation-log, po); } Override public ListLogRecord queryLog(String bizNo, CollectionString types) { // 查询实现 return logRecordMapper.selectByBizNoAndTypes(bizNo, types); } }3. 事务一致性配置在某些需要强一致性的场景下可以配置日志记录与业务操作在同一个事务中SpringBootApplication EnableLogRecord(tenant order-service, joinTransaction true) EnableTransactionManagement(order 0) public class OrderApplication { public static void main(String[] args) { SpringApplication.run(OrderApplication.class, args); } } 实际应用场景示例电商订单系统Service public class OrderServiceImpl implements OrderService { LogRecord( success {{#operator}}创建了订单订单号{{#order.orderNo}}金额¥{{#order.amount}}, fail {{#operator}}创建订单失败原因{{#_errorMsg}}, type ORDER_CREATE, bizNo {{#order.orderNo}} ) public Order createOrder(OrderCreateRequest request) { // 订单创建逻辑 Order order orderMapper.create(request); // 记录额外上下文 LogRecordContext.putVariable(operator, getCurrentUser()); return order; } LogRecord( success {{#operator}}修改了订单状态{_DIFF{#oldOrder, #newOrder}}, type ORDER_UPDATE, bizNo {{#newOrder.orderNo}} ) public boolean updateOrder(Order oldOrder, Order newOrder) { // 订单更新逻辑 return orderMapper.update(newOrder); } }用户管理系统Service public class UserServiceImpl implements UserService { LogRecord( success {{#operator}}创建了用户{{#user.username}}{{#user.email}}, type USER_CREATE, bizNo {{#user.id}} ) public User createUser(User user) { // 用户创建逻辑 User created userRepository.save(user); // 记录操作人 LogRecordContext.putVariable(operator, SecurityUtils.getCurrentUsername()); return created; } LogRecord( success {{#operator}}更新了用户权限{_DIFF{#oldUser.roles, #newUser.roles}}, type USER_PERMISSION, bizNo {{#newUser.id}}, condition {{#oldUser.roles ! #newUser.roles}} ) public boolean updateUserRoles(User oldUser, User newUser) { // 仅当角色发生变化时才记录日志 return userRepository.updateRoles(newUser); } }⚡ 性能优化建议1. 合理使用条件记录对于频繁调用的方法可以使用condition属性避免不必要的日志记录LogRecord( success 更新了配置项{{#config.key}}, type CONFIG_UPDATE, bizNo {{#config.key}}, condition {{#oldConfig.value ! #newConfig.value}} ) public boolean updateConfig(Config oldConfig, Config newConfig) { // 仅当值发生变化时才记录日志 return configRepository.update(newConfig); }2. 批量操作优化对于批量操作可以考虑在业务层面进行聚合记录而不是为每个操作单独记录LogRecord( success 批量更新了{{#userIds.size()}}个用户的状态为{{#newStatus}}, type USER_BATCH_UPDATE, bizNo BATCH_{{T(java.util.UUID).randomUUID()}} ) public boolean batchUpdateUserStatus(ListLong userIds, String newStatus) { // 批量更新逻辑 return userRepository.batchUpdateStatus(userIds, newStatus); }3. 异步日志记录对于性能要求较高的场景可以实现异步日志记录Service public class AsyncLogRecordService implements ILogRecordService { Autowired private ThreadPoolTaskExecutor logExecutor; Override public void record(LogRecord logRecord) { logExecutor.execute(() - { // 异步保存日志 logRecordMapper.insert(convertToPO(logRecord)); }); } } 常见问题与解决方案Q1为什么在某些类上注解不生效A这可能与Bean的生命周期有关。确保被注解的类在BeanFactoryLogRecordAdvisor初始化之后才被加载。可以通过调整Bean的加载顺序或使用DependsOn注解来解决。Q2如何控制日志记录的粒度A可以通过以下方式控制日志记录粒度使用condition属性控制是否记录日志使用successCondition属性控制成功/失败日志的记录在配置文件中设置mzt.log.record.diffLog来控制差异日志的记录行为Q3如何处理敏感字段A使用DIffLogIgnore注解标记敏感字段public class User { private Long id; private String username; DIffLogIgnore private String password; // 敏感字段不参与差异对比 DIffLogIgnore private String phone; // 敏感字段不参与差异对比 }Q4如何自定义日志模板A可以通过配置文件自定义差异日志的模板格式mzt: log: record: updateTemplate: 字段【__fieldName】从【__sourceValue】修改为【__targetValue】 addTemplate: 新增了字段【__fieldName】【__targetValue】 deleteTemplate: 删除了字段【__fieldName】【__sourceValue】 总结与展望mzt-biz-log作为一款专业的SpringBoot操作日志框架通过其注解驱动的设计理念和高度可扩展的架构成功解决了传统操作日志记录中的诸多痛点。无论是简单的日志记录需求还是复杂的对象差异对比场景它都能提供优雅的解决方案。核心优势总结零侵入性通过注解实现完全解耦业务逻辑与日志逻辑高度灵活支持Spring EL表达式、自定义函数、条件记录等多种特性强大扩展提供完整的扩展接口支持自定义存储、操作人获取等智能对比内置对象差异对比功能自动生成清晰的变更描述生产就绪支持事务一致性、性能监控等企业级特性下一步行动建议克隆项目到本地进行体验git clone https://gitcode.com/gh_mirrors/mz/mzt-biz-log查看示例项目bizlog-server中的完整使用案例根据业务需求实现自定义的IParseFunction和ILogRecordService在生产环境中逐步替换现有的日志记录代码通过采用mzt-biz-log您不仅可以大幅提升开发效率还能确保系统操作日志的一致性和可维护性为后续的审计、监控和问题排查打下坚实基础。【免费下载链接】mzt-biz-log支持Springboot基于注解的可使用变量、可以自定义函数的通用操作日志组件项目地址: https://gitcode.com/gh_mirrors/mz/mzt-biz-log创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
