使用 Resilia 为 Node.js 应用打造坚不可摧：轻量级弹性堆栈

I’m happy to translate the article for you, but I’ll need the article’s text (the content you’d like translated) in order to do so. Could you please paste the full markdown content of the post here? Once I have that, I’ll provide a Simplified‑Chinese translation while preserving the source line, formatting, code blocks, URLs, and technical terms as requested.

介绍 Resilia

Resilia 是一个零依赖、基于装饰器的库，它将关键方法包装在稳定的保护层中。它为 TypeScript 应用程序添加专业级的弹性模式，而不会产生臃肿。

如果你厌倦了编写重复的 try‑catch‑retry 逻辑或手动管理并发限制，这个工具正适合你。

为什么弹性很重要

在微服务环境中，故障不是如果会发生，而是何时会发生的问题。网络数据包会丢失，服务会超载，数据库会超时。如果没有合适的弹性策略，单个故障组件就可能耗尽线程池或连接限制，导致整个应用停摆。

为防止这种情况，通常需要三件事：

1. Circuit Breakers – 停止调用出现故障的服务。
2. Retries – 处理临时的短暂故障。
3. Bulkheads – 限制并行运行的请求数量。

手动为每个函数都接入这些机制既繁琐又容易出错。Resilia 能自动化完成整个堆栈的配置。

“Matryoshka”模型

Resilia 采用三层式方法来保护代码执行。它使用 TypeScript 装饰器以声明式方式应用这些层。

外层 – 断路器

• 类似电气面板中的安全开关。
• 如果某个服务的错误率超过可配置阈值（例如 50 % 错误率），断路器 跳闸 并打开。
• 打开状态下，Resilia 会立即拒绝新请求，而不调用底层函数，防止资源浪费。
• 在可配置的休眠窗口后，允许一次测试请求（半开状态）以检查健康是否恢复。

中层 – 带指数退避和抖动的重试

• 处理瞬时错误——一次性的网络故障，重试即可消失。
• 使用指数退避结合抖动，避免“惊群”问题。
• 每次重试的等待时间比前一次更长，加入的随机性确保多个客户端不会在同一毫秒对服务器发起冲击。

内层 – 隔舱（并发隔离）

• 限制特定方法的并发执行数量。
• 示例：将一个耗资源的报表查询限制为最多 5 个并发运行；其余请求排队等待空位。
• 确保某个慢特性不会独占服务器的 CPU 或内存。

安装与使用

npm install resilia reflect-metadata

import { Resilient } from 'resilia';

class PaymentService {
  @Resilient({
    concurrency: 5,        // Max 5 simultaneous requests
    queue: 10,             // Max 10 waiting in line
    maxRetries: 3,        // Try 3 times before failing
    errorThreshold: 0.5,  // Trip circuit if >50 % fail
    sleepWindowMs: 30000  // Rest for 30 s when tripped
  })
  async processTransaction(id: string) {
    // Your critical business logic here
    return await db.payments.create({ id });
  }
}

就这样——processTransaction 现在已经受到断路器、舱壁以及智能重试机制的保护。

可观测性

Resilia 在设计时就考虑了可观测性。每个组件都是事件发射器，允许您实时挂钩状态变化和指标。

import { resilienceRegistry } from 'resilia';

// Monitor your application health
resilienceRegistry.forEach(({ breaker, bulkhead }, key) => {
  breaker.on('state:changed', (event) => {
    console.log(`Circuit ${key} changed state to ${event.to}`);
  });
});

您可以监听断路器状态的变化（例如，Closed → Open），或追踪 bulkhead 队列拒绝请求的情况，这使得与 Prometheus 或 Grafana 等监控工具的集成变得轻而易举。

关键收益

• 零依赖 – 保持 node_modules 轻量，安全足迹小。
• 性能 – 轻量且几乎没有额外开销。
• TypeScript 原生 – 利用装饰器实现简洁、现代的语法。

参与

如果您觉得 Resilia 有用，请考虑支持该项目：

• GitHub: – 为仓库加星，提交 issue，或提交 pull request。
• Feedback: 在仓库的 issue 跟踪器中提出问题或评论。

您的星标有助于让其他人发现此工具，并激励持续开发，包括即将推出的速率限制和高级超时策略等功能。