架构与系统设计 / 系统课时

更新删除安全约束

更新删除安全约束

本课解决多租户系统中写操作范围过大的风险。完成后,更新与删除只能通过受控仓储方法执行,最终 SQL 必须同时包含业务主键和当前租户条件,并用影响行数识别越权或数据不存在。

学习目标

  • 理解仅有主键或仅有租户条件为何都不安全
  • 为更新、删除固化 id + tenant_id 双条件
  • 使用影响行数验证写操作是否真正命中目标数据

双条件是写操作的最低边界

只按主键更新,攻击者猜到其他租户的主键就可能越权修改。只按租户更新,条件遗漏时又可能修改当前租户的整张表。因此单记录写操作应固定满足:

WHERE id = <ID> AND tenant_id = <CURRENT_TENANT_ID>

租户编号只能从服务端上下文获取,主键来自接口路径或经过校验的命令对象。客户端不得同时控制这两个条件。

更新删除双条件安全链路

在仓储层固化安全 SQL

下面代码是片段示例,依赖 MyBatis、Spring 与前一课的 TenantContext。Mapper 保持包级可见,只允许同包仓储类调用,业务服务不直接接触通用写方法。

java
import org.apache.ibatis.annotations.Delete;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;
import org.apache.ibatis.annotations.Update;

@Mapper
interface ProjectWriteMapper {

    @Update("""
        UPDATE biz_project
        SET project_name = #{projectName}
        WHERE id = #{id}
          AND tenant_id = #{tenantId}
        """)
    int updateName(@Param("id") Long id,
                   @Param("tenantId") Long tenantId,
                   @Param("projectName") String projectName);

    @Delete("""
        DELETE FROM biz_project
        WHERE id = #{id}
          AND tenant_id = #{tenantId}
        """)
    int deleteByIdAndTenant(@Param("id") Long id,
                            @Param("tenantId") Long tenantId);
}

这两条 SQL 没有可选条件,也不接受外部传入的任意查询包装器,因此不会因调用方漏写条件而退化为租户级或全表写操作。

封装更新与删除入口

仓储方法内部读取当前租户,并要求影响行数恰好为 1。返回 0 时,不向调用方区分“记录不存在”和“属于其他租户”,避免泄露其他租户的数据存在性。

java
import lombok.RequiredArgsConstructor;
import org.springframework.stereotype.Repository;
import org.springframework.transaction.annotation.Transactional;

@Repository
@RequiredArgsConstructor
public class ProjectRepository {
    private final ProjectWriteMapper mapper;

    @Transactional
    public void rename(Long id, String projectName) {
        int affectedRows = mapper.updateName(
                id,
                TenantContext.requireTenantId(),
                projectName
        );
        requireSingleRow(affectedRows);
    }

    @Transactional
    public void delete(Long id) {
        int affectedRows = mapper.deleteByIdAndTenant(
                id,
                TenantContext.requireTenantId()
        );
        requireSingleRow(affectedRows);
    }

    private void requireSingleRow(int affectedRows) {
        if (affectedRows != 1) {
            throw new TenantResourceNotFoundException("资源不存在或无权操作");
        }
    }
}

异常类可以由全局异常处理器统一映射为 404。删除接口若需要幂等,也可以把 0 视为成功,但审计日志仍应记录未命中结果,不能悄悄忽略异常频率。

验证最终 SQL

假设 <ID> 属于租户 1001。当前上下文为 1001 时执行更新,预期影响 1 行。

sql
UPDATE biz_project
SET project_name = '结算中心'
WHERE id = <ID>
  AND tenant_id = 1001;

预期结果

text
Rows affected: 1

将当前上下文切换为 2002 后,对同一个 <ID> 执行相同操作,预期影响 0 行,仓储层抛出统一异常。

sql
DELETE FROM biz_project
WHERE id = <ID>
  AND tenant_id = 2002;

预期结果

text
Rows affected: 0
TenantResourceNotFoundException: 资源不存在或无权操作

真实接口测试还应覆盖正确租户更新、跨租户更新、正确租户删除、跨租户删除四个场景,并检查 SQL 日志中两个条件都存在。

防止绕过安全入口

不要在业务代码中暴露 BaseMapper.update、delete 或允许任意 Wrapper 的通用仓储方法。它们虽然灵活,却会把条件完整性交还给每个调用方,难以稳定审计。

批量更新必须另建明确接口,例如按一组主键更新,并同时限制当前租户;禁止只用 tenant_id 作为批量写条件。确需租户级清理时,应使用独立的运维命令、审批和审计链路,而不是复用普通业务接口。

数据库唯一索引、外键和事务可以保护一致性,但不能替代租户条件。最终验收标准始终是:写 SQL 同时包含目标主键与可信租户编号,且调用方检查影响行数。

本课总结

  • 单记录更新和删除必须固定使用 id + tenant_id 双条件
  • 租户编号由仓储层从上下文读取,业务接口不能直接传入
  • 影响行数为 0 时应按不存在或无权处理,避免泄露跨租户信息

下一课预告

下一课将继续处理查询场景中的复杂边界,包括自定义 SQL、关联查询和可能绕过自动租户条件的特殊写法。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

更新删除安全约束

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通