https://yentsaidev.com/tags/idempotency/ Recent content in Idempotency on Yen Tsai dev Hugo -- 0.147.0 zh-tw Fri, 04 Sep 2026 20:16:00 +0800 https://yentsaidev.com/blog/sql-timeout-transaction-retry-idempotency/ Fri, 04 Sep 2026 20:16:00 +0800 https://yentsaidev.com/blog/sql-timeout-transaction-retry-idempotency/ <p>最近在處理一個付款流程問題時，遇到一支 API 發生 SQL timeout。</p> <p>第一時間我先往 SQL query 本身去想，但後來把整個 request flow 跟時間線整理出來後，才發現問題跟前一支付款 API 的 transaction scope 有關。</p> <p>這次排查剛好把幾個平常分開看的概念串在一起：</p> <ul> <li>Transaction</li> <li>Database Lock</li> <li>Third-party API</li> <li>Retry</li> <li>Compensation</li> <li>Idempotency</li> <li>Race Condition</li> </ul> <p>這篇就記錄一下整個思考過程。</p> <h2 id="問題現象">問題現象</h2> <p>流程大概是這樣：</p> <div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-text" data-lang="text"><span style="display:flex;"><span>付款 API </span></span><span style="display:flex;"><span> ↓ </span></span><span style="display:flex;"><span>呼叫第三方系統 </span></span><span style="display:flex;"><span> ↓ </span></span><span style="display:flex;"><span>後續查詢 API </span></span><span style="display:flex;"><span> ↓ </span></span><span style="display:flex;"><span>成功頁面 </span></span></code></pre></div><p>實際發生問題時，付款 API 呼叫第三方系統後等待了很長一段時間。</p> <p>同時間，後續另一支 API 需要查詢資料，但最後發生 SQL timeout，導致後面的流程沒有繼續。</p> <p>一開始看到 SQL timeout，很自然會先懷疑：</p> <blockquote> <p>Query 是不是太慢？</p></blockquote> <p>但把兩支 API 的時間線放在一起看後，我注意到前一支付款 API 有使用 transaction，而且兩個流程都會碰到同一筆資料。</p> <h2 id="開始懷疑-blocking">開始懷疑 Blocking</h2> <p>我的思路是：付款 API 有 transaction，後面的 API 又在讀相同資料，而且前面的 transaction 還沒有結束，那就有可能是 lock 還沒被釋放。</p>