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来自角色、异步落库时上下文必须显式传递。这样审计日志才能真正成为多商户平台上的“可追溯、可隔离、可合规”的安全基础设施,而不是一个随时可能泄露商户数据的旁路漏洞。