Unkey项目中覆盖限制计数显示异常问题分析

问题背景

在Unkey项目的API密钥管理系统中，存在一个关于覆盖限制(Override Limits)计数显示不准确的技术问题。该系统允许用户为特定命名空间创建覆盖限制规则，但在删除这些规则后，界面仍会将被删除的规则计入总数。

技术现象

当用户执行以下操作序列时会出现问题：

1. 创建新的命名空间
2. 在该命名空间内创建覆盖限制规则
3. 删除已创建的覆盖限制规则
4. 系统界面仍显示包含已删除规则的计数

问题本质

这个问题属于典型的"软删除"实现不完整导致的显示异常。在数据库设计中，系统采用了软删除模式（通过deleted_at字段标记删除状态），但在前端计数查询时没有正确过滤已标记为删除的记录。

技术解决方案

要解决这个问题，需要在数据查询层添加对deleted_at字段的判空检查。具体来说：

1. 在SQL查询中添加WHERE deleted_at IS NULL条件
2. 或者在ORM查询中明确排除软删除记录
3. 确保所有计数查询都遵循相同的过滤逻辑

影响范围

这个问题主要影响：

• 用户界面的数据显示准确性
• 管理员对实际生效规则数量的判断
• 系统状态的可信度

最佳实践建议

对于类似系统，建议：

1. 实现统一的软删除处理中间件
2. 建立计数查询的规范模板
3. 在前端和后端添加数据状态标识
4. 考虑实现缓存机制提高计数查询效率

总结

这个看似简单的计数显示问题实际上反映了系统在数据生命周期管理上的不足。通过修复这个问题，不仅可以提高界面显示的准确性，还能为系统未来的扩展奠定更健壮的基础。对于开发者而言，这也是一个很好的案例，说明软删除实现需要考虑完整的应用场景。