提前预警磁盘爆满，避免数据库因空间不足宕机、写入失败；定位大表、冗余表，做分表、归档、数据清理优化；统计索引占用空间，判断索引是否冗余、低效；服务器资源评估，为磁盘扩容、云数据库规格选型提供数据依据。MySQL 中存在逻辑数据大小和物理磁盘占用两个概念：逻辑大小是单纯数据 + 索引的统计值，物理大小包含日志、碎片、临时空间，二者结果会存在差异，下文会逐一区分讲解。环境说明：本文所有 SQL 语句兼

官方文档虽然把查询参数讲得很简单，但根据我们的线上经验，对于复杂的分页过滤接口，强烈建议用Pydantic模型来封装查询参数，而不是把一长串参数都列在函数定义里，维护起来简直是灾难。这个工具的选择，好比选螺丝刀，不是最贵的就好，而是最趁手的。踩坑提醒：当同一个参数既可能是路径参数又可能是查询参数时（虽然设计上应避免），FastAPI默认会认为是查询参数。item_id: int = Path(..