Bruno项目中集合级Pre-Request脚本的异步执行问题解析

在API开发测试工具Bruno的使用过程中，开发者经常需要在集合级别设置预请求脚本（Pre-Request Script）来实现全局性的认证逻辑。本文将通过一个典型的Bearer Token认证案例，深入分析集合级预请求脚本的执行机制和常见问题。

问题现象

开发者在Bruno集合中配置了预请求脚本，目的是：

1. 实现密码认证流程
2. 获取用户信息
3. 刷新访问令牌
4. 将最终获得的访问令牌设置为后续请求的Authorization头

但实际运行时发现，集合中的请求在预请求脚本完成前就已执行，导致Authorization头始终为null。

核心原因分析

通过代码审查发现，问题根源在于异步处理的不当使用。原脚本采用了Promise的.then()链式调用方式，这种写法虽然语法正确，但在Bruno的预请求脚本执行环境中，会导致主线程在Promise解析完成前就结束执行。

具体来说，Bruno的脚本执行引擎会等待主线程同步代码执行完毕，但不会自动等待异步Promise链的完成。这就造成了：

• 脚本开始执行
• 发起异步认证流程
• 主线程立即结束
• Bruno继续执行实际请求
• 此时认证流程可能尚未完成

解决方案

将Promise链式调用改为async/await模式可以完美解决这个问题：

// 修改前的代码片段
processAuthentication()
  .then(() => {
    // 设置header逻辑
  }).catch((error) => {
    // 错误处理
  });

// 修改后的正确写法
try {
  await processAuthentication();
  const accessToken = bru.getEnvVar("ACCESS_TOKEN");
  req.setHeader("Authorization", `Bearer ${accessToken}`);
} catch (error) {
  console.error("认证流程出错:", error);
}

这种改写确保了：

1. 脚本执行引擎会等待整个认证流程完成
2. 请求头设置操作在认证成功后执行
3. 错误处理更加直观清晰

最佳实践建议

在Bruno中编写预请求脚本时，建议遵循以下原则：

1. 优先使用async/await：相比Promise链，async/await更符合脚本执行的线性思维

2. 完整的错误处理：确保每个异步操作都有对应的错误捕获

3. 环境变量验证：在脚本开头检查必需的环境变量是否已设置

4. 执行顺序控制：对于有依赖关系的操作，明确使用await保证执行顺序

5. 日志输出：在关键步骤添加console.log，便于调试

认证流程优化

针对示例中的Bearer Token认证流程，还可以做以下优化：

1. 令牌缓存：检查现有令牌是否有效，避免不必要的重复认证

2. 自动刷新：在令牌接近过期时自动触发刷新机制

3. 多环境支持：使脚本能适应不同环境(endpoints)的配置

4. 性能监控：记录各步骤耗时，优化慢速操作

通过理解Bruno的脚本执行机制和正确使用异步编程模式，开发者可以构建出稳定可靠的全局认证方案，显著提升API测试的效率和质量。