LikeShop 多商户高级版操作审计日志:后台全行为追溯与查询系统二开方案

简介: LikeShop多商户高级版审计日志二开方案:基于注解+AOP实现租户隔离的全行为追溯。采集时强制注入`tenant_id`,异步落库并脱敏敏感参数;查询按平台/商户/子账号三级角色自动过滤,依托`(tenant_id, create_time)`联合索引保障性能;独立记录越权访问,筑牢多租户安全底线。

LikeShop 多商户高级版操作审计日志:后台全行为追溯与查询系统二开方案

一、多商户审计的核心不是“记日志”,而是“隔离地记、隔离地查”

在单商户系统中,操作审计日志就是一个“谁在什么时候做了什么”的流水表。但在LikeShop多商户高级版中,这个问题的复杂度完全变了。

多商户系统本质上是多租户系统,平台→商户→子账号三级权限模型下,同一个“修改商品”动作,平台运营执行和商户管理员执行,语义完全不同。更关键的是:商户A的审计日志,商户B绝对不能看到。如果审计日志的查询接口漏掉了tenant_id过滤,商户B就能通过翻查日志看到商户A每天在改什么价格、上下架什么商品——这是比业务数据泄露更隐蔽的安全事故,因为审计日志往往包含操作前后的完整上下文。

LikeShop多商户Java版使用Sa-Token作为权限框架,权限拦截统一在LikeAdminInterceptor中完成,多租户数据的隔离依赖框架层强制注入tenant_id,而不是靠开发者手动拼接。审计日志的二开必须遵循同样的原则:采集时强制携带租户上下文,查询时框架层强制隔离。任何“靠开发者记得加条件”的设计,在多商户场景下都是定时炸弹。

这篇文章的方案,核心是在原生权限拦截器之后、业务方法执行之前,插入一个注解驱动的审计切面:通过自定义@AuditLog注解标记需要审计的方法,AOP环绕通知采集操作人、租户、请求参数、执行结果,异步落库;查询端则根据当前登录角色的层级,自动决定tenant_id的过滤范围——平台看全量,商户看自己,子账号看授权范围内。

二、审计表设计:tenant_id是列,更是索引

2.1 表结构

新建ls_oper_audit_log,不修改任何官方表:

CREATE TABLE `ls_oper_audit_log` (
  `id` bigint UNSIGNED NOT NULL AUTO_INCREMENT,
  `tenant_id` bigint NOT NULL COMMENT '租户ID(商户ID),平台操作可为0',
  `operator_id` bigint NOT NULL COMMENT '操作人ID(ls_admin.id)',
  `operator_name` varchar(64) DEFAULT '' COMMENT '操作人名称(快照)',
  `operator_role` varchar(20) NOT NULL COMMENT '角色层级:platform/merchant/sub',
  `module` varchar(50) NOT NULL COMMENT '模块,如商品管理、订单管理',
  `action` varchar(30) NOT NULL COMMENT '动作:create/update/delete/export/audit',
  `target_type` varchar(50) DEFAULT '' COMMENT '操作对象类型,如goods/order',
  `target_id` varchar(64) DEFAULT '' COMMENT '操作对象ID',
  `request_method` varchar(10) DEFAULT '',
  `request_url` varchar(500) DEFAULT '',
  `request_params` text COMMENT '请求参数(脱敏后)',
  `result_status` tinyint NOT NULL DEFAULT '1' COMMENT '1-成功 0-失败',
  `error_msg` varchar(1000) DEFAULT '' COMMENT '失败时的异常摘要',
  `cost_ms` int DEFAULT '0' COMMENT '方法执行耗时(毫秒)',
  `client_ip` varchar(45) DEFAULT '',
  `user_agent` varchar(255) DEFAULT '',
  `create_time` datetime NOT NULL,
  PRIMARY KEY (`id`),
  KEY `idx_tenant_time` (`tenant_id`, `create_time`),
  KEY `idx_operator_time` (`operator_id`, `create_time`),
  KEY `idx_module_action` (`module`, `action`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='操作审计日志';

(tenant_id, create_time)联合索引是查询性能的生命线。审计日志查询的典型形态是“某个商户在某段时间内的所有操作”,tenant_id等值匹配 + create_time范围扫描,联合索引可以直接覆盖,避免回表。如果只建create_time单列索引,商户维度查询会退化为全表扫描。

2.2 为什么不复用ls_admin_log或ls_system_log

LikeShop原生有“系统日志”功能,用于记录后台管理操作。但原生日志的定位是“事故排查辅助”,字段有限,且不区分租户层级。审计日志的要求更高:需要区分平台/商户/子账号角色、需要记录操作对象和目标、需要支撑按租户隔离的合规查询。新建独立表反而更干净,不会与原生日志的升级产生冲突。

2.3 分区与保留策略

审计日志是只增不改的数据,长期运行后单表会迅速膨胀。建议按月分区(PARTITION BY RANGE (TO_DAYS(create_time))),并设置保留策略:例如保留最近12个月的分区,更早的分区通过定时任务归档到冷存储或直接DROP PARTITION。审计日志的合规保留期通常由法务确定,技术上只需要保证“过期分区可以快速清理而不影响在线查询”。

三、采集层:注解驱动 + AOP环绕 + 异步落库

3.1 自定义@AuditLog注解

不要在Controller的每个方法里手写auditService.save(...)——那样既侵入业务代码,又容易遗漏。参照成熟的多租户日志方案,采用注解驱动:

@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface AuditLog {
   
    String module();
    String action();
    String targetType() default "";
    boolean recordParams() default true;
    boolean recordResult() default false;
}

在需要审计的Controller或Service方法上标注:

@AuditLog(module = "商品管理", action = "update", targetType = "goods")
@PostMapping("/goods/update")
public Result updateGoods(@RequestBody GoodsDTO dto) {
    ... }

3.2 AOP切面

切面在@Around中完成三件事:采集上下文、执行目标方法、异步落库。

@Aspect
@Component
@RequiredArgsConstructor
public class AuditLogAspect {
   

    private final AuditLogPublisher publisher;

    @Around("@annotation(auditLog)")
    public Object around(ProceedingJoinPoint pjp, AuditLog auditLog) throws Throwable {
   
        OperAuditLog log = new OperAuditLog();
        log.setModule(auditLog.module());
        log.setAction(auditLog.action());
        log.setTargetType(auditLog.targetType());
        log.setCreateTime(new Date());

        // 从租户上下文和Sa-Token会话中获取隔离标识与操作人
        log.setTenantId(TenantContext.getTenantId());
        log.setOperatorId(StpUtil.getLoginIdAsLong());
        log.setOperatorRole(resolveRole());

        // 请求信息
        ServletRequestAttributes attrs =
            (ServletRequestAttributes) RequestContextHolder.getRequestAttributes();
        if (attrs != null) {
   
            HttpServletRequest request = attrs.getRequest();
            log.setRequestMethod(request.getMethod());
            log.setRequestUrl(request.getRequestURI());
            log.setClientIp(getClientIp(request));
            if (auditLog.recordParams()) {
   
                log.setRequestParams(desensitize(pjp.getArgs()));
            }
        }

        long start = System.currentTimeMillis();
        try {
   
            Object result = pjp.proceed();
            log.setResultStatus(1);
            return result;
        } catch (Throwable e) {
   
            log.setResultStatus(0);
            log.setErrorMsg(truncate(e.getMessage(), 1000));
            throw e;
        } finally {
   
            log.setCostMs((int) (System.currentTimeMillis() - start));
            publisher.publish(log);
        }
    }

    private String resolveRole() {
   
        // 平台管理员、商户管理员、子账号的区分逻辑
        // 依赖Sa-Token中存储的角色标识或ls_admin.sid是否为0
    }
}

TenantContext.getTenantId()是关键。LikeShop Java版的租户上下文由框架层在请求进入时注入,AOP切面直接读取,不依赖前端参数,也不依赖开发者手动传递。

3.3 异步落库与租户上下文的跨线程传递

审计日志的写入不能阻塞业务方法。使用独立的线程池 + 异步事件发布:

@Component
@RequiredArgsConstructor
public class AuditLogPublisher {
   

    private final AuditLogMapper mapper;
    private final ThreadPoolTaskExecutor auditExecutor;

    public void publish(OperAuditLog log) {
   
        Long tenantId = TenantContext.getTenantId(); // 主线程捕获
        auditExecutor.execute(() -> {
   
            try {
   
                // 显式传入tenantId,不依赖子线程的ThreadLocal
                mapper.insert(log);
            } catch (Exception e) {
   
                // 审计落库失败只记录错误日志,不抛出
                log.error("审计日志落库失败", e);
            }
        });
    }
}

这里有一个多租户场景下的隐蔽陷阱:如果使用@Async或线程池异步执行,TenantContext的ThreadLocal不会自动传递到子线程。InheritableThreadLocal对普通线程池(复用线程)无效,必须在提交任务前从主线程捕获tenantId并作为参数传入,或者使用TransmittableThreadLocal(TTL)配合线程池装饰。否则,异步落库的审计日志tenant_id可能为null或串到上一个任务的租户。

3.4 敏感参数脱敏

request_params不能原样记录。密码、token、身份证、银行卡号等字段必须在落库前脱敏:

private String desensitize(Object[] args) {
   
    // 对已知敏感DTO字段做掩码,或对JSON中的password/token键做替换
    // 建议维护一个敏感字段名集合,递归扫描
    return maskSensitive(JSON.toJSONString(args));
}

脱敏规则应该集中在一处维护,而不是散落在各个切面中。LikeShop的安全加固本身也强调敏感信息脱敏是必要环节,审计日志作为“事后追溯”的数据,如果本身包含明文密码,就变成了新的泄露源。

四、查询层:角色决定tenant_id的过滤范围

4.1 三级角色的查询边界

审计日志查询接口必须根据当前登录角色的层级自动限定范围,tenant_id不能从前端接收:

角色 tenant_id过滤 可查询范围
platform 不过滤(或传0查平台自身操作) 全平台所有商户的审计日志
merchant = 当前登录商户的tenant_id 仅本商户及其子账号的操作
sub = 当前登录商户的tenant_id 且 operator_id = 当前子账号 仅自己的操作
public PageResult<OperAuditLog> query(AuditQuery query) {
   
    Long currentTenant = TenantContext.getTenantId();
    String role = resolveRole();

    LambdaQueryWrapper<OperAuditLog> wrapper = new LambdaQueryWrapper<>();
    if ("merchant".equals(role)) {
   
        wrapper.eq(OperAuditLog::getTenantId, currentTenant);
    } else if ("sub".equals(role)) {
   
        wrapper.eq(OperAuditLog::getTenantId, currentTenant)
               .eq(OperAuditLog::getOperatorId, StpUtil.getLoginIdAsLong());
    }
    // platform 不加 tenant_id 条件(或按需过滤指定商户)

    wrapper.ge(query.getStartTime() != null, OperAuditLog::getCreateTime, query.getStartTime())
           .le(query.getEndTime() != null, OperAuditLog::getCreateTime, query.getEndTime())
           .eq(StringUtils.isNotBlank(query.getModule()), OperAuditLog::getModule, query.getModule())
           .eq(StringUtils.isNotBlank(query.getAction()), OperAuditLog::getAction, query.getAction())
           .orderByDesc(OperAuditLog::getCreateTime);

    return mapper.selectPage(query.toPage(), wrapper);
}

平台角色的查询是唯一的例外。平台运营需要跨商户查看审计日志来排查纠纷或合规审计,此时tenant_id过滤被显式绕过。但这个绕过必须基于服务端解析出的platform角色,而不是前端传入的role参数。

4.2 分页与查询性能

审计日志的分页建议使用键集分页(keyset pagination)而非OFFSET分页。OFFSET在深分页时会扫描并丢弃大量行,(tenant_id, create_time)联合索引配合游标(create_time < last_time)可以保持稳定的查询性能。

如果后台UI必须使用页码分页,至少在count查询上做缓存或近似估算,避免每次翻页都执行一次全量COUNT(*)。

五、越权访问审计:独立于常规操作日志的安全切面

LikeShop多商户版有一个常规操作审计覆盖不到的场景:越权访问尝试。商户A的管理员如果尝试通过篡改tenant_id或shop_id访问商户B的数据,权限拦截器会拒绝请求,但这次“尝试”本身是重要的安全信号。

建议在LikeAdminInterceptor的权限校验失败分支中,额外发布一条越权审计事件,记录:操作人ID、操作人所属tenant_id、目标tenant_id(从请求参数或URL中解析)、请求IP、请求URL。这类日志的module标记为SECURITY,action标记为ACCESS_DENIED,在查询界面中单独作为一个筛选维度。

越权审计与常规操作审计共享同一张表,但查询时可以按module = 'SECURITY'快速隔离。安全团队可以配置独立的告警规则:同一操作人在短时间内产生多条越权记录,触发实时告警。

六、二开避坑清单

坑一:查询接口的tenant_id从前端接收。 这是最致命的错误。商户可以通过篡改请求参数查看其他商户的审计日志。tenant_id必须从TenantContext或登录会话中获取,前端传来的值只能用于平台角色的“筛选指定商户”,且必须在服务端校验当前角色确实是platform。

坑二:异步落库时tenant_id丢失。 线程池复用线程,ThreadLocal不会自动传递。必须在提交异步任务前捕获tenantId并显式传入,或使用TTL装饰线程池。否则审计日志的tenant_id为null,查询时被所有商户的过滤条件排除,日志等于白记。

坑三:request_params记录了明文密码或token。 审计日志的存储安全性不高于业务数据库。如果日志中包含了明文凭据,一旦日志表被拖库,攻击者可以直接利用。脱敏必须在切面中完成,且规则要覆盖所有已知敏感字段。

坑四:审计落库失败导致业务回滚。 审计是旁路能力,不是业务成功的必要条件。异步落库的异常必须被捕获并记录,不能向上抛出。否则数据库短暂抖动时,正常业务操作会因为“日志写不进去”而失败,这是本末倒置。

坑五:(tenant_id, create_time)索引缺失。 商户维度的时间范围查询是审计日志最核心的访问模式。缺少联合索引时,查询会退化为全表扫描,几百万行日志就能让查询接口超时。

坑六:越权审计只记录“被拦截”,不记录“谁在尝试”。 如果越权访问日志缺少操作人ID和目标tenant_id,安全团队拿到日志也无法判断是“前端bug误传”还是“恶意探测”。这两个字段是越权审计的最低信息集。

七、总结

LikeShop多商户高级版操作审计日志的二开,核心是三条线:

采集隔离:通过注解驱动的AOP切面,在业务方法执行前后自动采集操作人、租户、请求上下文和执行结果。tenant_id从框架层的TenantContext读取,不依赖前端参数;异步落库时显式传递租户上下文,杜绝线程池导致的隔离丢失。敏感参数在落库前脱敏。

查询隔离:审计日志的查询根据当前登录角色的层级自动限定tenant_id范围——平台看全量,商户只看自己,子账号只看自己。tenant_id永远不从前端接收。(tenant_id, create_time)联合索引保障商户维度的时间范围查询性能。

安全审计独立:越权访问尝试作为独立的安全事件记录,包含操作人、所属租户、目标租户和请求信息,与常规操作日志共享存储但可独立查询和告警。

守住三条底线:采集时的tenant_id来自上下文、查询时的tenant_id来自角色、异步落库时上下文必须显式传递。这样审计日志才能真正成为多商户平台上的“可追溯、可隔离、可合规”的安全基础设施,而不是一个随时可能泄露商户数据的旁路漏洞。

目录
相关文章
|
6天前
|
Linux Go 开发工具
手机上跑 DeepSeek 智能体:开源安卓客户端 DSH Go 安装与使用指南
DSH Go 是一款开源安卓客户端,将 DeepSeek Harness 智能体引擎装进手机:免 Root、免 Termux,一键安装即用;支持本机运行(内置 Ubuntu+Node.js)或远程接管电脑会话;具备插话打断、过程折叠、屏幕操控、端到端加密分享等特色功能,真正实现智能体“口袋化”。
7269 18
|
6天前
|
弹性计算 人工智能 API
Codex超详细入门指南(下载·安装·登录·上手,全版本覆盖,2026最新版)
建议收藏本教程,2026 全年各版本更新随时回来查阅。如果你在搭建过程中遇到任何问题,欢迎结合 阿里云工单系统 提交技术支持请求,或在 阿里云开发者社区 搜索 Codex 相关话题交流。 祝你编码愉快,效率翻倍!
2399 10
|
8天前
|
人工智能 前端开发 API
阿里云Qwen4-Max 大模型详解:定位、特征、能力、适用场景与相对Qwen3-Max差异解析
2026年11月11日,阿里发布第四代旗舰模型Qwen4-Max预览版,首发千问AI平台Token Plan并接入千问办公、Qoder等入口。该版本聚焦知识理解、世界感知、编程与Agentic四项升级,主打复杂编程、专业办公、前端设计与专业软件操作等真实任务。预览期为11月11日10:00至11月25日24:00,仅支持Token Plan调用,到期后模型标识下线;限时2折、新用户再享5折,最低1折可体验。
|
8天前
|
JSON 前端开发 API
阿里云最新Qwen4-Max大模型介绍:模型定位、特征、能力、适用场景解析
2026 年 11 月 11 日,阿里发布第四代旗舰模型Qwen4-Max预览版,首发千问 AI 平台 Token Plan,并同步接入千问办公、Qoder 等入口。该版本聚焦知识理解、世界感知、编程与 Agentic 四项升级,主打复杂编程、专业办公、前端设计与专业软件操作。预览期至 11 月 25 日 24:00,到期后模型标识下线;限时 2 折、新用户再享 5 折,最低 1 折可体验。
|
4天前
|
传感器 安全 区块链
Windows 电脑运行安卓应用教程:开源工具 ApkStart 双击 APK 即装、独立窗口运行
ApkStart 是一款开源Windows工具,让安卓APP像原生软件一样运行:双击APK即安装、生成真实图标、独立窗口启动、开始菜单可搜索。无需传统模拟器,内置QEMU运行时,支持数据互通、ARM兼容与命令行操作。(239字)
|
21天前
|
Linux 开发工具 iOS开发
Codex保姆级教程(下载+安装+登录+使用,含所有版本,2026最新)
Codex是OpenAI推出的开源AI编程智能体,本地运行,可理解整个代码库,支持自然语言指令改代码、执行命令、跑测试、修Bug,兼容Win/macOS/Linux。(239字)
10360 59
|
4天前
|
人工智能 弹性计算 开发工具
零成本玩各大模型!DeepSeek Harness dsh-our-free-model 插件,13 个厂商模型直接用
总结一下:装这个插件,你不用注册、不用绑卡、不用填一个 Key,就能在 DeepSeek Harness 里用上 DeepSeek V4.1 Flash、Kimi K3 这一批前沿模型,而且是白嫖的、还不限量。三步搞定:下载插件,复制包含 `package.json` 的插件目录路径,在「添加插件」里粘贴路径安装并重启。无论是在阿里云 ECS 上通过命令行部署的 Web 版,还是本地的 Electron 桌面端,都能顺利跑通,快速搭建一套零成本的免费模型使用环境。
1079 1
|
7天前
|
Linux API iOS开发
【DSH】DeepSeek Harness新手保姆教程(下载+安装+配置+使用,2026最新实测)
DeepSeek Harness(dsh)是DeepSeek AI开源的智能体框架,秉持“一切皆插件”理念,支持读文件、改代码、跑命令、处理表格、联网搜索等操作。免费开源,兼容Windows/macOS/Linux,提供桌面端与网页端,可灵活安装插件扩展能力。
|
16天前
|
Linux 开发工具 iOS开发
2026最新codex下载安装保姆级使用教程(下载+安装+登录+使用,含所有历史版本)
本文详解OpenAI Codex国内快速上手指南:提供Win/macOS/Linux全平台免安装包、npm/Homebrew等多方式安装、账号/API Key双登录、简体中文切换,覆盖下载、安装、汉化、使用及高频避坑(如微软商店失败、npm超时等),10分钟即可跑通。
3536 9