Documentation
¶
Overview ¶
Package retry 提供独立的重试机制支持。
从 event/deadletter.go 和 web/server/retry.go 抽取而来, 为事件处理、HTTP 请求等场景提供统一的重试策略和执行器。
核心组件:
- RetryPolicy: 重试策略配置(最大次数、退避策略、延迟计算)
- Executor: 重试执行器(支持 jitter 防惊群、上下文取消、回调通知)
- BackoffStrategy: 退避策略(None/Fixed/Linear/Exponential)
使用示例:
policy := retry.ExponentialBackoff(3, 100*time.Millisecond, 10*time.Second)
executor := retry.NewExecutor(policy)
result, err := executor.Execute(ctx, func(ctx context.Context) (any, error) {
return httpClient.Get(ctx, url)
})
Index ¶
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
Types ¶
type BackoffStrategy ¶
type BackoffStrategy string
BackoffStrategy 退避策略
const ( // BackoffNone 无退避,立即重试。 BackoffNone BackoffStrategy = "none" // 无退避,立即重试 // BackoffFixed 固定间隔退避。 BackoffFixed BackoffStrategy = "fixed" // 固定间隔退避 // BackoffLinear 线性退避。 BackoffLinear BackoffStrategy = "linear" // 线性退避 // BackoffExponential 指数退避。 BackoffExponential BackoffStrategy = "exponential" // 指数退避 )
type Executor ¶
type Executor struct {
// contains filtered or unexported fields
}
Executor 重试执行器
func MustNewExecutor ¶
func MustNewExecutor(policy RetryPolicy, opts ...ExecutorOption) *Executor
MustNewExecutor 创建重试执行器(失败时 panic)
func NewExecutor ¶
func NewExecutor(policy RetryPolicy, opts ...ExecutorOption) (*Executor, error)
NewExecutor 创建重试执行器
type ExecutorOption ¶
type ExecutorOption func(*Executor)
ExecutorOption 执行器选项
func WithRetryable ¶
func WithRetryable(fn func(error) bool) ExecutorOption
WithRetryable 设置可重试错误判断函数
type RetryInfo ¶
type RetryInfo struct {
Attempt int // 当前尝试次数(从 0 开始)
MaxAttempts int // 最大尝试次数
Delay time.Duration // 下次重试延迟
LastErr error // 最后一次错误
}
RetryInfo 重试信息(用于回调)
type RetryPolicy ¶
type RetryPolicy struct {
MaxAttempts int // 最大尝试次数(包含首次),0 表示不重试
Strategy BackoffStrategy // 退避策略
InitialDelay time.Duration // 初始延迟
MaxDelay time.Duration // 最大延迟(指数退避上限)
Multiplier float64 // 退避乘数(指数退避用)
Jitter float64 // 抖动比例 (0.0-1.0),防止惊群效应
}
RetryPolicy 重试策略配置
func ExponentialBackoff ¶
func ExponentialBackoff(maxAttempts int, initialDelay, maxDelay time.Duration) RetryPolicy
ExponentialBackoff 创建指数退避策略(带 jitter 防惊群)
func FixedDelay ¶
func FixedDelay(maxAttempts int, delay time.Duration) RetryPolicy
FixedDelay 创建固定延迟重试策略
func LinearBackoff ¶
func LinearBackoff(maxAttempts int, initialDelay, maxDelay time.Duration) RetryPolicy
LinearBackoff 创建线性退避策略
func (RetryPolicy) CalculateDelay ¶
func (p RetryPolicy) CalculateDelay(attempt int) time.Duration
CalculateDelay 计算当前重试次数对应的延迟(含 jitter)
Click to show internal directories.
Click to hide internal directories.