Rack Mini Profiler 4.0.0 版本发布：性能分析工具的重大升级

Rack Mini Profiler 是一个轻量级的 Ruby 性能分析工具，它能够帮助开发者快速识别应用程序中的性能瓶颈。通过在页面角落显示一个小型性能分析窗口，开发者可以直观地看到页面加载时间、SQL查询耗时、内存使用情况等关键指标。

重大变更：Ruby 3.1.0 成为最低要求

本次 4.0.0 版本最显著的变更是将最低 Ruby 版本要求提升至 3.1.0。这一变更意味着：

1. 项目正式放弃对 Ruby 2.x 系列的支持
2. 开发者可以充分利用 Ruby 3.x 的新特性来优化性能分析器
3. 代码库可以简化，移除为兼容旧版本而存在的冗余代码

对于仍在使用 Ruby 2.x 的项目，建议先升级 Ruby 版本再考虑使用 Rack Mini Profiler 4.0.0。

PostgreSQL 预处理补丁实现

新版本引入了对 PostgreSQL 的预处理补丁支持（prepend patch），这一改进带来了以下优势：

1. 更准确的 SQL 查询时间测量
2. 减少了性能分析器本身对数据库查询性能的影响
3. 提供了更细粒度的查询执行细节

这一特性特别适合大型 PostgreSQL 数据库应用，能够帮助开发者更精确地定位数据库性能问题。

查询缓存命中显示增强

Active Record 的查询缓存是一个重要的性能优化手段，新版本增加了对查询缓存命中的可视化支持：

1. 在 SQL 查询列表中明确标记缓存命中
2. 区分实际执行的查询和从缓存中获取的结果
3. 帮助开发者评估查询缓存的实际效果

这一改进使得开发者能够更清楚地了解应用程序中哪些查询真正命中了缓存，从而更好地优化查询策略。

SQL 查询详情增强

新版本在 SQL 查询详情展示方面做了两项重要改进：

1. 记录类型和计数显示：现在可以直观地看到每个查询返回的记录类型和数量
2. 查询开始时间对齐：修复了查询时间轴显示不准确的问题，使时间线更加精确

这些改进使得性能分析结果更加直观，开发者能够更快地理解查询性能特征。

其他重要修复

本次发布还包含了一系列稳定性改进和用户体验优化：

1. 修复了请求页面因字符串冻结导致的崩溃问题
2. 改进了 HTTP 响应头处理，确保与 Rack 3 的兼容性
3. 优化了性能分析器名称的显示，避免长名称破坏界面布局
4. 修复了火焰图模式参数无效的问题
5. 解决了最大跟踪数设置可能导致前端崩溃的问题

这些修复提升了工具的稳定性和可靠性，使开发者能够更顺畅地进行性能分析工作。

升级建议

对于现有项目，升级到 4.0.0 版本需要注意以下几点：

1. 确保 Ruby 版本至少为 3.1.0
2. 检查项目中是否有依赖 Rack Mini Profiler 的特定配置
3. 测试性能分析功能在开发环境中的表现
4. 关注新版本带来的额外性能开销（通常很小）

新版本的功能增强和稳定性改进使其成为追求更精确性能分析的项目的理想选择。特别是对于使用 PostgreSQL 数据库和 Active Record 的项目，新版本提供了更有价值的性能洞察。