The Bug That Only Happens Sometimes User reports: "I updated my profile but it still shows the old name." You refresh: new name appears. You ask them to refresh: still old name. You debug together: it's back to new name. The user: "This is clearly broken." You: "It's working for me..." Congratulations, you're debugging eventual consistency. What Eventual Consistency Actually Means In a distributed system, a write to one node takes time to propagate to others. During that window: Some reads see the new value Some reads see the old value All reads will eventually see the new value That "eventually" window can be milliseconds or seconds. Sometimes minutes if something is wrong. Users don't care about CAP theorem. They care that they updated their profile and it shows wrong. Why It's So Hard to Debug Three reasons: 1. Non-deterministic reproduction You can't reliably reproduce it. Sometimes the bug fires, sometimes it doesn't. This makes unit tests useless and traditional debugging painful. 2.…