存量异步任务迁移如何避免权限回退
TOPIC SOURCE
为多租户后台任务实现租户隔离:从任务上下文传递到跨租户回归测试
存量异步任务迁移时,最容易踩的坑不是新代码写错,而是为了“先把队列跑起来”,临时放宽租户校验。旧任务可能没有签名上下文,也可能只带着一个可被修改的 tenant_id。消费者如果遇到校验失败就默认使用系统租户、最近一次任务的身份,或者直接按参数查数据,权限回退就发生了。
先分清哪些任务能救
迁移前应先盘点队列中的任务:消息格式、任务类型、资源 ID、原始创建请求,以及是否能从受信任的任务记录恢复租户归属。能证明归属的任务,可以重新生成带签名声明的新消息,并保留旧任务与新任务的关联;无法证明归属的任务,则应进入受控死信或待人工处理状态,不能靠补写一个 tenant_id“修复”。
签名声明至少应绑定租户、主体、权限范围、发布时间和过期时间。消费者验证通过后,才创建只读的租户上下文。业务参数里的租户字段不能覆盖它,数据查询、缓存、对象存储和文件生成也都必须使用这个可信上下文。任务身份一旦无法验证,就在访问数据之前失败。
回退也不能拆掉隔离
切换时可以先让小比例消费者启用强制校验,观察缺失上下文、签名不匹配、过期任务、积压和死信情况。旧消费者可以短暂保留,但只能处理已经迁移且可验证的消息,不能继续接受任意租户参数。跨租户负向测试要覆盖读取、列表、统计、导出、缓存、下载链接、重试和任务状态查询,避免主查询隔离了,文件或缓存却漏了。
真正的回退应该是恢复旧版本或消费策略,而不是关闭租户校验、开放全局数据库权限,或允许缺失上下文继续执行。重试和人工重放同样要重新验证授权,并记录操作者、原因、目标租户和新任务 ID。这样迁移失败最多造成可审计的任务失败,不会把“兼容旧消息”变成跨租户访问的后门。

参与讨论
迁移时最怕为了赶进度放宽校验