核心用法
Simple HTTP 是一个基于 Node.js 原生 http/https 模块构建的轻量级 HTTP 客户端，完全零依赖。通过 HttpClient 类提供标准化的请求接口，支持 GET/POST/PUT/PATCH/DELETE/HEAD/OPTIONS 等所有 HTTP 方法，允许自定义请求头和请求体，且对象类型 body 会自动序列化为 JSON。
显著优点
- 零依赖设计：仅使用 Node.js 内置模块，避免供应链攻击风险，安装包体积极小
- 智能重试机制：对连接错误、超时及 429/5xx 响应自动执行指数退避重试（默认 3 次），带抖动避免惊群效应
- 永不抛错设计：所有调用均返回可检查的统一响应对象，通过
resp.ok判断成功状态，错误信息通过resp.error获取，大幅降低异常处理复杂度 - 灵活配置：支持客户端级默认配置（headers、timeout、重试参数）和请求级覆盖，满足多样化场景
- 自动解析响应：根据 Content-Type 自动将 JSON 响应解析为对象，其他情况保留字符串
潜在缺点与局限性
- 功能精简：缺乏高级功能如请求/响应拦截器、流式处理、Cookie 自动管理、代理配置等
- 无浏览器支持：纯 Node.js 实现，无法直接用于前端环境
- 类型安全缺失：JSDoc 注释简单，无 TypeScript 类型定义，大型项目需自行封装
- 测试覆盖未知：文档未提及单元测试，生产环境稳定性需自行验证
- 生态隔离：与主流 HTTP 生态（如 axios、fetch 的 polyfill）不兼容，迁移成本较高
适合人群
- 追求极致依赖安全、需审计所有第三方代码的企业环境
- 资源受限场景（Serverless、边缘计算）对包体积敏感的项目
- 需要稳定 HTTP 基础能力、不需要高级特性的内部工具或脚本
- 学习 Node.js HTTP 模块底层原理的教学场景
常规风险
- 网络层风险：原生模块对 TLS 证书验证行为依赖 Node.js 版本，旧版本可能存在验证绕过问题
- 重试风暴：默认重试配置在下游服务已过载时可能加剧压力，需根据实际调整
maxRetries和退避参数 - 敏感信息泄露：请求头中的认证信息可能被错误日志记录，需自行实现脱敏逻辑
- 无请求取消：不支持 AbortController，长时间请求无法中途终止