Guides

Forward Recovery Saga


Forward Recovery Saga

Instead of compensating failed steps (backward recovery), a forward recovery saga retries each step with increasing delays until it eventually succeeds. This approach is appropriate when the operation must eventually complete — for example, when inventory has already been reserved and payment captured, the shipment must be created even if the shipping service is temporarily down. Use durable ctx.sleep() timers between retries so the workflow survives worker restarts.

Forward Recovery
retry until success — no compensation
reserve_inventory#1✓
charge_payment#1✓
💤sleep(1s)
create_shipment#1✗
💤sleep(5s)
create_shipment#2✗
💤sleep(30s)
create_shipment#3✗
create_shipment#4✓
send_confirmation#1✓
1
use orcher::prelude::*;
2
use anyhow::Result;
3
use std::time::Duration;
4
5
// Forward recovery saga - retry until success
6
#[workflow(name = "forward_recovery_saga", version = "1.0.0")]
7
pub async fn forward_recovery_saga(
8
ctx: WorkflowContext,
9
order: OrderData,
10
) -> Result<OrderResult> {
11
println!("Starting forward recovery saga");
12
13
// Step 1: Reserve inventory (retry until success)
14
let inventory_id = loop {
15
match ctx.execute_task(reserve_inventory, order.items.clone()).await {
16
Ok(id) => break id,
17
Err(e) => {
18
println!("Inventory reservation failed: {}, retrying in 30s", e);
19
ctx.sleep(Duration::from_secs(30)).await?;
20
continue;
21
}
22
}
23
};
24
25
println!("Inventory reserved: {}", inventory_id);
26
27
// Step 2: Charge payment (retry until success)
28
let payment_id = loop {
29
match ctx.execute_task(charge_payment, order.amount).await {
30
Ok(id) => break id,
31
Err(e) => {
32
println!("Payment failed: {}, retrying in 60s", e);
33
ctx.sleep(Duration::from_secs(60)).await?;
34
continue;
35
}
36
}
37
};
38
39
println!("Payment captured: {}", payment_id);
40
41
// Step 3: Create shipment (retry until success)
42
let shipment_id = loop {
43
match ctx.execute_task(create_shipment, order.order_id.clone()).await {
44
Ok(id) => break id,
45
Err(e) => {
46
println!("Shipment creation failed: {}, retrying in 120s", e);
47
ctx.sleep(Duration::from_secs(120)).await?;
48
continue;
49
}
50
}
51
};
52
53
println!("Forward recovery saga completed");
54
Ok(OrderResult {
55
order_id: order.order_id,
56
success: true,
57
payment_id: Some(payment_id),
58
inventory_id: Some(inventory_id),
59
shipment_id: Some(shipment_id),
60
})
61
}

Next Steps