SpringBoot 公共字段自动填充的6种神技，开发效率飙升！

最新推荐文章于 2025-05-30 21:48:49 发布

犬小哈

最新推荐文章于 2025-05-30 21:48:49 发布

阅读量26

点赞数

原文链接：https://mp.weixin.qq.com/s?__biz=MzU4MDUyMDQyNQ==&mid=2247560336&idx=2&sn=40255658eca70715268662bc0674467f&chksm=fcd2b386064ffdb33c37090e77827423ed7e653566d7b95568538e935d6b1bd1b316214c6cbd&scene=126&sessionid=0

版权

来源：juejin.cn/post/7494549596258189362

👉 欢迎加入小哈的星球，你将获得: 专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

新项目:《从零手撸：仿小红书（微服务架构）》 已完结，基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17..., 点击查看项目介绍；演示地址：http://116.62.199.48:7070/
《从零手撸：前后端分离博客项目（全栈开发）》 2期已完结,演示链接：http://116.62.199.48/;
专栏阅读地址：https://www.quanxiaoha.com/column

截止目前，累计输出 90w+ 字，讲解图 3713+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，Spring Cloud Alibaba 等等，戳我加入学习，解锁全部项目，已有3300+小伙伴加入

在开发外卖系统订单模块时，我发现每个实体类都包含create_time、update_by等重复字段。手动维护这些字段不仅效率低下，还容易出错。

本文将分享一套经过生产验证的自动化方案，涵盖MyBatis-Plus、AOP、JWT等六种核心策略，助你彻底摆脱公共字段维护的烦恼。

一、痛点分析：公共字段维护的三大困境

1.1 典型问题场景

// 订单创建逻辑
public void createOrder(OrderDTO dto) {
    Order order = convertToEntity(dto);
    
    // 手动设置公共字段
    order.setCreateTime(LocalDateTime.now());
    order.setUpdateTime(LocalDateTime.now());
    order.setCreateUser(getCurrentUser());
    order.setUpdateUser(getCurrentUser());
    
    orderMapper.insert(order);
}

// 订单更新逻辑 
public void updateOrder(OrderDTO dto) {
    Order order = convertToEntity(dto);
    
    // 重复设置逻辑
    order.setUpdateTime(LocalDateTime.now());
    order.setUpdateUser(getCurrentUser());
    
    orderMapper.updateById(order);
}

痛点总结：

代码重复率高（每个Service方法都要设置）
维护成本高（字段变更需修改多处）
容易遗漏（特别是更新操作）

二、基础方案：MyBatis-Plus自动填充

2.1 配置元对象处理器

@Slf4j
@Component
publicclass AutoFillHandler implements MetaObjectHandler {
    
    // 插入时自动填充
    @Override
    public void insertFill(MetaObject metaObject) {
        this.strictInsertFill(metaObject, "createTime", LocalDateTime.class, LocalDateTime.now());
        this.strictInsertFill(metaObject, "createUser", String.class, getCurrentUser());
        this.strictUpdateFill(metaObject, "updateTime", LocalDateTime.class, LocalDateTime.now());
        this.strictUpdateFill(metaObject, "updateUser", String.class, getCurrentUser());
    }

    // 更新时自动填充
    @Override
    public void updateFill(MetaObject metaObject) {
        this.strictUpdateFill(metaObject, "updateTime", LocalDateTime.class, LocalDateTime.now());
        this.strictUpdateFill(metaObject, "updateUser", String.class, getCurrentUser());
    }
    
    // 获取当前用户（从安全上下文）
    private String getCurrentUser() {
        return Optional.ofNullable(SecurityContextHolder.getContext())
                      .map(SecurityContext::getAuthentication)
                      .map(Authentication::getName)
                      .orElse("system");
    }
}

2.2 实体类注解配置

@Data
publicclass BaseEntity {
    @TableField(fill = FieldFill.INSERT)
    private LocalDateTime createTime;
    
    @TableField(fill = FieldFill.INSERT_UPDATE)
    private LocalDateTime updateTime;
    
    @TableField(fill = FieldFill.INSERT)
    private String createUser;
    
    @TableField(fill = FieldFill.INSERT_UPDATE)
    private String updateUser;
}

// 订单实体继承基类
publicclass Order extends BaseEntity {
    // 业务字段...
}

三、进阶方案：AOP统一处理

3.1 自定义注解

@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD)
public @interface AutoFill {
    OperationType value();
}

public enum OperationType {
    INSERT,
    UPDATE
}

3.2 切面实现

@Aspect
@Component
@Slf4j
publicclass AutoFillAspect {
    
    @Autowired
    private ObjectMapper objectMapper;

    @Around("@annotation(autoFill)")
    public Object around(ProceedingJoinPoint pjp, AutoFill autoFill) throws Throwable {
        Object[] args = pjp.getArgs();
        for (Object arg : args) {
            if (arg instanceof BaseEntity) {
                fillFields((BaseEntity) arg, autoFill.value());
            }
        }
        return pjp.proceed(args);
    }

    private void fillFields(BaseEntity entity, OperationType type) {
        String currentUser = getCurrentUser();
        LocalDateTime now = LocalDateTime.now();
        
        if (type == OperationType.INSERT) {
            entity.setCreateTime(now);
            entity.setCreateUser(currentUser);
        }
        entity.setUpdateTime(now);
        entity.setUpdateUser(currentUser);
    }
    
    // 获取当前用户（支持多线程环境）
    private String getCurrentUser() {
        return Optional.ofNullable(RequestContextHolder.getRequestAttributes())
                      .map(attrs -> (ServletRequestAttributes) attrs)
                      .map(ServletRequestAttributes::getRequest)
                      .map(req -> req.getHeader("X-User-Id"))
                      .orElse("system");
    }
}

四、生产环境最佳实践

4.1 多数据源适配

@Configuration
publicclass DataSourceConfig {
    
    @Bean
    @ConfigurationProperties("spring.datasource.master")
    public DataSource masterDataSource() {
        return DataSourceBuilder.create().build();
    }
    
    @Bean
    public MetaObjectHandler metaObjectHandler() {
        returnnew MultiDataSourceAutoFillHandler();
    }
}

publicclass MultiDataSourceAutoFillHandler extends MetaObjectHandler {
    // 根据当前数据源动态处理
}

4.2 分布式ID生成

public class SnowflakeIdGenerator {
    // 实现分布式ID生成
}

// 在自动填充中集成
@Override
public void insertFill(MetaObject metaObject) {
    this.strictInsertFill(metaObject, "id", String.class, 
        idGenerator.nextId());
}

五、避坑指南：五大常见问题

5.1 空指针异常防护

// 使用Optional处理可能为空的情况
private String safeGetUser() {
    return Optional.ofNullable(SecurityContextHolder.getContext())
                 .map(SecurityContext::getAuthentication)
                 .map(Authentication::getPrincipal)
                 .map(principal -> {
                     if (principal instanceof UserDetails) {
                         return ((UserDetails) principal).getUsername();
                     }
                     return principal.toString();
                 })
                 .orElse("system");
}

5.2 字段覆盖问题

// 在实体类中使用@TableField策略
@TableField(fill = FieldFill.INSERT, updateStrategy = FieldStrategy.NEVER)
private String createUser;

六、性能优化方案

6.1 缓存当前用户信息

public class UserContextHolder {
    privatestaticfinal ThreadLocal<String> userHolder = new ThreadLocal<>();
    
    public static void setUser(String user) {
        userHolder.set(user);
    }
    
    public static String getUser() {
        return userHolder.get();
    }
    
    public static void clear() {
        userHolder.remove();
    }
}

// 在拦截器中设置
publicclass UserInterceptor implements HandlerInterceptor {
    @Override
    public boolean preHandle(HttpServletRequest request, 
                            HttpServletResponse response, 
                            Object handler) {
        UserContextHolder.setUser(request.getHeader("X-User-Id"));
        returntrue;
    }
}

6.2 批量操作优化

@Transactional
public void batchInsert(List<Order> orders) {
    // 提前获取公共字段值
    String user = getCurrentUser();
    LocalDateTime now = LocalDateTime.now();
    
    orders.forEach(order -> {
        order.setCreateTime(now);
        order.setCreateUser(user);
        order.setUpdateTime(now);
        order.setUpdateUser(user);
    });
    
    orderMapper.batchInsert(orders);
}

七、监控与审计

7.1 审计日志集成

@EntityListeners(AuditingEntityListener.class)
public class BaseEntity {
    @CreatedBy
    private String createUser;
    
    @LastModifiedBy
    private String updateUser;
    
    @CreatedDate
    private LocalDateTime createTime;
    
    @LastModifiedDate
    private LocalDateTime updateTime;
}

7.2 操作日志追踪

@Aspect
@Component
public class OperationLogAspect {
    
    @AfterReturning("@annotation(autoFill)")
    public void logOperation(AutoFill autoFill) {
        LogEntry log = new LogEntry();
        log.setOperator(getCurrentUser());
        log.setOperationType(autoFill.value().name());
        logService.save(log);
    }
}

结语： 通过本文的六种方案组合使用，我们在生产环境中实现了：

公共字段维护代码量减少90%
相关Bug率下降75%
新功能开发效率提升40%

最佳实践清单：

基础字段使用MyBatis-Plus自动填充
复杂场景结合AOP处理
分布式环境集成唯一ID生成
重要操作添加审计日志
定期检查字段填充策略

未来展望： 随着Spring Data JPA的演进，未来可以探索与Reactive编程的结合，实现全链路的非阻塞式自动填充。

👉 欢迎加入小哈的星球，你将获得: 专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

新项目:《从零手撸：仿小红书（微服务架构）》 已完结，基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17..., 点击查看项目介绍；演示地址：http://116.62.199.48:7070/
《从零手撸：前后端分离博客项目（全栈开发）》 2期已完结,演示链接：http://116.62.199.48/;
专栏阅读地址：https://www.quanxiaoha.com/column

1. 我的私密学习小圈子，从0到1手撸企业实战项目~
2. Java 21 新特性的实践，确实很丝滑！
3. Elasticsearch 集群如何进行读写限流？
4. 新来个技术总监：发现谁再用 delete 删数据直接开除！

最近面试BAT，整理一份面试资料《Java面试BATJ通关手册》，覆盖了Java核心技术、JVM、Java并发、SSM、微服务、数据库、数据结构等等。
获取方式：点“在看”，关注公众号并回复 Java 领取，更多内容陆续奉上。
PS：因公众号平台更改了推送规则，如果不想错过内容，记得读完点一下“在看”，加个“星标”，这样每次新文章推送才会第一时间出现在你的订阅列表里。
点“在看”支持小哈呀，谢谢啦