ข้ามไปเนื้อหา

Webhook มาผิดลำดับ ทำไมสถานะชำระแล้วจึงย้อนกลับ

อ่านบทความนี้เป็น English 中文

Webhook มาผิดลำดับ ทำไมสถานะชำระแล้วจึงย้อนกลับ

ข้อมูลมาทีหลัง ไม่ได้แปลว่าใหม่กว่า

ระบบรับแจ้งว่าชำระเงินแล้ว จากนั้นกลับแสดงว่ารอชำระ ทั้งที่ไม่มีการยกเลิก อาการนี้อาจเกิดจาก webhook ของเหตุการณ์เก่ามาถึงทีหลังแล้วเขียนทับสถานะใหม่ วิธีแก้ต้องตรวจลำดับเหตุการณ์และกติกาการเปลี่ยนสถานะ ไม่ใช่เพิ่มความเร็วเซิร์ฟเวอร์อย่างเดียว และต้องแยกออกจากปัญหาเหตุการณ์เดิมถูกส่งซ้ำ

Webhook คือการที่ระบบต้นทางส่งข้อความแจ้งเหตุการณ์มายังระบบปลายทาง แต่การเกิดเหตุการณ์ การส่ง การรับเข้าคิว และการประมวลผลเสร็จเป็นคนละเวลา Stripe ระบุชัดว่าไม่รับประกันการส่งตามลำดับที่เกิด และแนะนำให้ดึงข้อมูลวัตถุที่ขาดจาก API ได้ หลักการนี้เป็นตัวอย่างของผู้ให้บริการรายหนึ่ง ต้องอ่านสัญญาการทำงานของระบบที่ใช้อยู่จริงก่อนออกแบบ

แยกการส่งซ้ำออกจากการย้อนสถานะ

ตัวอย่างสมมติ: เหตุการณ์ A ระบุว่าคำสั่งซื้อกำลังรอชำระ ส่วน B ระบุว่าชำระแล้ว ถ้า B ถูกประมวลผลก่อน A การเก็บ event ID ป้องกันซ้ำจะยังยอมรับ A เพราะเป็นคนละ ID จึงอาจย้อนสถานะได้ แม้ระบบไม่มีรายการซ้ำเลย ในทางกลับกัน การเรียงลำดับอย่างเดียวก็ไม่ได้กันการออกใบเสร็จหรือส่งสินค้าเดิมสองครั้ง ต้องมีการควบคุมทั้งสองเรื่อง

เก็บอย่างน้อยรหัสเหตุการณ์ รหัสวัตถุทางธุรกิจ ประเภทเหตุการณ์ เวลาเกิดจากต้นทางถ้ามี เวลารับ ผลประมวลผล และรหัสเชื่อมโยงงานปลายทาง ใช้ข้อมูลนี้ไล่ว่าเหตุการณ์ไหนเปลี่ยนอะไร ไม่เก็บเพียงข้อความสำเร็จทั่วไป และจำกัดข้อมูลส่วนบุคคลกับสิทธิ์อ่าน log ตามความจำเป็น

เลือกแหล่งสถานะและกติกาที่พิสูจน์ได้

ถ้าต้นทางมี API อ่านสถานะปัจจุบันที่เชื่อถือได้ อาจใช้ webhook เป็นสัญญาณให้ไปตรวจวัตถุล่าสุด แล้วค่อยปรับข้อมูลปลายทางตามกติกา วิธีนี้ลดการเชื่อ snapshot เก่า แต่เพิ่มจำนวนคำขอและต้องรับมือ API ช้า จำกัดอัตรา หรือข้อมูลยังไม่ทันเปลี่ยน หากดึงไม่ได้ให้ค้างงานพร้อมเหตุผลและ retry ที่ควบคุมได้ ไม่ตั้งเป็นสำเร็จจากการคาดเดา

ถ้ามีเลขเวอร์ชันที่ต้นทางรับประกันว่าเพิ่มตามวัตถุเดียวกัน สามารถใช้เปรียบเทียบก่อนเขียนได้ แต่ไม่ควรเดาลำดับจากรูปแบบ event ID หรือเวลารับเพียงอย่างเดียว Timestamp อาจเท่ากันหรือมาจากนาฬิกาคนละระบบ และสถานะธุรกิจไม่ได้เพิ่มเป็นเส้นตรงเสมอ เช่น คืนเงินหรือเปิดงานใหม่ กฎว่ารับแล้วห้ามเปลี่ยนกลับทุกกรณีอาจปิดกั้นเหตุการณ์ที่ถูกต้อง

คิวช่วยรับงาน แต่ต้องกันการเขียนชนกัน

แม้จัดคิวแล้ว worker สองตัวอาจอ่านสถานะเดียวกันและเขียนทับกันได้ ให้ทีมพัฒนากำหนดการประมวลผลแยกตามรหัสวัตถุ หรือใช้การตรวจเวอร์ชันขณะเขียนและ transaction ตามระบบฐานข้อมูล เมื่อรับ webhook ควรตรวจลายเซ็นตามคู่มือผู้ให้บริการและบันทึกงานอย่างทนทานก่อนตอบรับ การตอบรับไม่ใช่หลักฐานว่างานธุรกิจเสร็จแล้ว

งานที่ก่อผลภายนอก เช่น ส่งสินค้า ส่งอีเมล หรือออกเอกสาร ต้องมีรหัสอ้างอิงผลที่ทำแล้วและวิธีกระทบยอดเมื่อปลายทางตอบไม่ชัด ห้าม replay เหตุการณ์ทั้งหมดเข้าสู่ระบบจริงโดยไม่ตรวจผลเดิม บทความอ่านประกอบเรื่องส่งข้อมูลซ้ำของ Chawinnix ช่วยวางส่วนป้องกันซ้ำนี้ แต่ต้องใช้ควบคู่กับกฎลำดับและสถานะในเรื่องนี้

ทดสอบให้เห็นผลธุรกิจ ไม่ใช่แค่ HTTP สำเร็จ

ชุดทดสอบควรมีเหตุการณ์ตามลำดับ ย้อนลำดับ ส่งซ้ำ พร้อมกัน และกรณีอ่าน API ไม่สำเร็จ ใช้คำสั่งซื้อทดสอบเดียวกันตรวจว่าสถานะสุดท้ายตรงต้นทาง ผลภายนอกเกิดตามที่ควรเพียงครั้งเดียว และงานที่ยังยืนยันไม่ได้ยังแสดงว่าค้าง ให้เก็บผลก่อนและหลังพร้อม log เพื่อแยกข้อผิดพลาดของข้อมูลจากข้อผิดพลาดของ worker

ก่อนเปิดใช้ ให้เจ้าของกระบวนการยืนยันแหล่งข้อมูลหลัก เหตุการณ์ที่มีสิทธิ์เปลี่ยนสถานะ ผู้รับผิดชอบงานค้าง และวิธีหยุดผลภายนอกเมื่อพบความคลาดเคลื่อน Chawinnix ให้บริการระบบไอทีและระบบอัตโนมัติตามหน้าบริการ การส่งตัวอย่าง log ที่ปกปิดข้อมูลสำคัญพร้อมแผนผังการเชื่อมต่อ จะช่วยเริ่มวิเคราะห์ได้ตรงกว่าการแจ้งเพียงว่าระบบช้า

ภาพแนวคิดการ์ดเหตุการณ์หลายเส้นทางผ่านจุดตรวจเข้าสู่ฐานข้อมูล

แหล่งอ้างอิง

กลับไปหน้าบทความทั้งหมด

เริ่มคุยกับเรา

เล่าสิ่งที่กังวลสั้น ๆ ทีมงานจะติดต่อกลับ ทุกอย่างที่ส่งมาเก็บเป็นความลับ