Bruno项目中的代理配置问题分析与解决方案

问题背景

Bruno是一款开源的API测试工具，在1.35版本之前存在一个严重的网络配置问题。当用户通过环境变量设置HTTP/HTTPS网络连接时，Bruno无法正确识别这些设置，导致无法通过企业级网络服务器访问外部API服务。

问题现象

用户报告的主要症状包括：

1. 通过环境变量设置的网络配置被Bruno忽略
2. 直接尝试与HTTPS端点建立连接而非通过网络
3. 网络服务器返回500错误或403禁止访问
4. 网络抓包显示缺少CONNECT方法调用

技术分析

问题根源在于Bruno底层使用的Axios库存在一个长期未修复的缺陷。当检测到https_network环境变量时，Axios会错误地假设网络服务器使用HTTPS协议，从而直接发送TLS握手请求，而不是先发送HTTP CONNECT请求建立隧道。

在企业环境中，网络服务器通常：

• 监听HTTP端口以提高效率
• 要求客户端先发送CONNECT方法建立隧道
• 然后才会处理HTTPS流量

解决方案演进

Bruno团队分阶段解决了这个问题：

1. 1.35版本：首次引入"系统网络"选项，允许用户在GUI中显式选择使用系统网络设置

2. 1.37版本：改进了CLI工具对网络的支持，解决了部分环境下的问题

3. 1.39版本：进一步优化了网络处理逻辑，特别是对PAC文件的支持

4. 1.40版本：最终完全修复了系统网络识别问题，确保在各种企业网络环境下都能正常工作

最佳实践建议

对于Bruno用户，特别是在企业网络环境下，建议：

1. 确保使用1.40或更高版本
2. 在Preferences → Network中选择"System network"选项
3. 检查集合级别的网络设置是否配置为"global"
4. 对于复杂环境(如Zscaler)，可能需要手动指定网络地址
5. 当使用PAC文件时，可能需要从PAC脚本中提取具体的网络URI进行手动配置

总结

Bruno项目团队通过多个版本的迭代，最终解决了这个影响企业用户的关键问题。现在的版本能够正确处理各种网络配置场景，包括环境变量、系统网络设置和PAC文件等复杂情况。对于API测试工具而言，完善的网络支持是企业环境下不可或缺的功能，这次改进显著提升了Bruno在企业环境中的可用性。