VueHooks Plus 2.3 版本中 useRequest 的 manual 参数失效问题分析

问题背景

在 VueHooks Plus 项目中，useRequest 是一个常用的异步请求管理 Hook。2.3 版本发布后，用户反馈了一个严重问题：当设置 options.manual = true 时，请求会在页面加载时自动执行，而不是等待手动调用 run 函数。这与预期行为不符，影响了众多依赖此特性的项目。

问题表现

在 VueHooks Plus 2.2.3 版本中，当开发者设置 manual: true 时，useRequest 会严格遵循手动触发的原则，不会自动执行请求。然而升级到 2.3 版本后，即使明确设置了 manual: true，请求也会在组件挂载时自动执行。

影响范围

这个问题影响所有使用 VueHooks Plus 2.3 版本的项目，特别是那些依赖 manual 参数来控制请求时机的场景。例如：

1. 需要用户交互后才发起的请求
2. 表单提交等需要验证后触发的操作
3. 条件性触发的数据加载

临时解决方案

项目维护者迅速响应，建议用户立即回退到 2.2.3 版本。同时，2.4.0 和 2.2.4 版本已从 npm 仓库中移除，以避免更多用户受到影响。

问题根源

初步分析表明，这个问题与依赖自动刷新机制的引入有关。在 2.3 版本中，可能错误地处理了 manual 参数的逻辑，导致请求自动触发。这种变更破坏了向后兼容性，影响了现有项目的正常运行。

后续改进

项目团队已经制定了以下改进措施：

1. 将依赖自动刷新功能移至 beta 版本进行充分测试
2. 增加单元测试覆盖率，特别是针对各种边界条件和参数组合
3. 建立更严格的版本发布流程，确保类似问题不会再次发生

开发者建议

对于使用 VueHooks Plus 的开发者，建议：

1. 暂时锁定版本为 2.2.3
2. 密切关注项目更新，等待稳定版本发布
3. 在升级前充分测试 manual 参数的行为

总结

这个事件凸显了开源项目中版本兼容性的重要性。VueHooks Plus 团队快速响应问题的态度值得肯定，同时也提醒我们在引入新特性时需要更加谨慎。对于开发者而言，保持对依赖库变更的关注，并在生产环境升级前进行充分测试是必要的开发实践。