架构与系统设计 / 系统课时
更新删除安全约束
更新删除安全约束
本课解决多租户系统中写操作范围过大的风险。完成后,更新与删除只能通过受控仓储方法执行,最终 SQL 必须同时包含业务主键和当前租户条件,并用影响行数识别越权或数据不存在。
学习目标
- 理解仅有主键或仅有租户条件为何都不安全
- 为更新、删除固化
id + tenant_id双条件 - 使用影响行数验证写操作是否真正命中目标数据
双条件是写操作的最低边界
只按主键更新,攻击者猜到其他租户的主键就可能越权修改。只按租户更新,条件遗漏时又可能修改当前租户的整张表。因此单记录写操作应固定满足:
WHERE id = <ID> AND tenant_id = <CURRENT_TENANT_ID>
租户编号只能从服务端上下文获取,主键来自接口路径或经过校验的命令对象。客户端不得同时控制这两个条件。

在仓储层固化安全 SQL
下面代码是片段示例,依赖 MyBatis、Spring 与前一课的 TenantContext。Mapper 保持包级可见,只允许同包仓储类调用,业务服务不直接接触通用写方法。
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 时,不向调用方区分“记录不存在”和“属于其他租户”,避免泄露其他租户的数据存在性。
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 行。
UPDATE biz_project
SET project_name = '结算中心'
WHERE id = <ID>
AND tenant_id = 1001;预期结果
Rows affected: 1将当前上下文切换为 2002 后,对同一个 <ID> 执行相同操作,预期影响 0 行,仓储层抛出统一异常。
DELETE FROM biz_project
WHERE id = <ID>
AND tenant_id = 2002;预期结果
Rows affected: 0
TenantResourceNotFoundException: 资源不存在或无权操作真实接口测试还应覆盖正确租户更新、跨租户更新、正确租户删除、跨租户删除四个场景,并检查 SQL 日志中两个条件都存在。
防止绕过安全入口
不要在业务代码中暴露 BaseMapper.update、delete 或允许任意 Wrapper 的通用仓储方法。它们虽然灵活,却会把条件完整性交还给每个调用方,难以稳定审计。
批量更新必须另建明确接口,例如按一组主键更新,并同时限制当前租户;禁止只用 tenant_id 作为批量写条件。确需租户级清理时,应使用独立的运维命令、审批和审计链路,而不是复用普通业务接口。
数据库唯一索引、外键和事务可以保护一致性,但不能替代租户条件。最终验收标准始终是:写 SQL 同时包含目标主键与可信租户编号,且调用方检查影响行数。
本课总结
- 单记录更新和删除必须固定使用
id + tenant_id双条件 - 租户编号由仓储层从上下文读取,业务接口不能直接传入
- 影响行数为 0 时应按不存在或无权处理,避免泄露跨租户信息
下一课预告
下一课将继续处理查询场景中的复杂边界,包括自定义 SQL、关联查询和可能绕过自动租户条件的特殊写法。