Supabase CLI 3.2.0-beta.17 เตือนเมื่อ gen types ทำ --schema หล่น แต่ยัง Exit 0
Supabase CLI beta เพิ่มคำเตือนบน stderr เมื่อ gen types ไม่พบ schema ที่ระบุ แต่ exit code ยังเป็น 0 ผู้ดูแล CI ต้องตรวจผลลัพธ์เพิ่ม
Supabase CLI 3.2.0-beta.17 เตือนเมื่อ gen types หา schema ที่ระบุไม่พบ แต่ยังจบด้วย exit code 0
Supabase เผยแพร่ CLI 3.2.0-beta.17 เมื่อ 16 พฤศจิกายน 2026 เวลา 09:01 UTC โดยรายการแก้ไขหลักใน release notes คือเพิ่มคำเตือนเมื่อ supabase gen types ทำ schema ที่ผู้ใช้ระบุผ่าน --schema หล่นจากผลลัพธ์ การเปลี่ยนนี้ดูเล็ก แต่กระทบขั้นตอนสร้าง TypeScript types ในโปรเจ็กต์ที่แยกข้อมูลหลาย schema เพราะไฟล์ types เดิมอาจถูกสร้างสำเร็จทั้งที่ขาด schema ที่ทีมคาดว่าจะมี
รายละเอียดจาก pull request ของทีม Supabase อธิบายปัญหาเดิมชัดเจน: หากชื่อ schema ที่ส่งเข้า --schema ไม่ถูกส่งกลับมาจากฐานข้อมูล คำสั่งจะตัดชื่อนั้นทิ้งเงียบ ๆ แล้ว ยังคืน exit code 0 สาเหตุอาจเป็นพิมพ์ชื่อผิด มีช่องว่างเกินหลังเครื่องหมายจุลภาค migration ยังไม่รัน หรือ role ที่เชื่อมต่อไม่มีสิทธิ์ใช้ schema ดังกล่าว ผลคือไฟล์ types ดูเหมือนถูกต้อง แต่ไม่มี namespace หรือชนิดข้อมูลของ schema ที่ขาดไป เมื่อทีมพึ่งไฟล์นี้เพื่อตรวจ type ของ query หรือสร้าง client อาจพบปัญหาช้ากว่าจุดที่ควรพบ
คำเตือนใหม่บอกอะไร และยังไม่แก้อะไร
ตั้งแต่เบตานี้ แต่ละชื่อ schema ที่ผู้ใช้ระบุเองแล้วหายไปจากผลที่สร้าง จะมี warning หนึ่งรายการบน stderr ข้อความแจ้งว่าชื่อนั้นไม่อยู่ใน generated types และให้พิจารณาว่า schema ไม่มีจริง, role ที่เชื่อมต่อใช้ไม่ได้ หรือชื่อขึ้นต้นด้วย pg_ คำเตือนจะเกิดกับชื่อที่ส่งผ่าน --schema เท่านั้น ไม่เกิดกับ schema ค่าเริ่มต้น จุดสำคัญคือ stdout และ exit code ยังคงเดิม จึงไม่ใช่การเปลี่ยนให้ CI ล้มเหลวโดยอัตโนมัติ ผู้ดูแลที่ต้องการ gate แบบเข้มต้องตรวจ stderr หรือยืนยันเนื้อหาไฟล์ที่สร้างด้วยตนเอง
ยังมีขอบเขตอีกข้อ: ทีมพัฒนาระบุว่าเส้นทางสร้าง types ผ่าน Management API ไม่มีรายการ schema ที่ใช้เทียบ จึงยังไม่เปลี่ยนพฤติกรรมในเส้นทางนั้น อย่าเข้าใจว่าคำเตือนนี้ครอบคลุมทุกวิธีเรียก gen types เท่ากัน หาก pipeline ของทีมใช้ project ID หรือ API แทนการต่อฐานข้อมูลโดยตรง ควรทดสอบคำสั่งจริงของทีมว่ามี warning หรือไม่ ก่อนนำไปใช้เป็นสัญญาณความถูกต้อง
ตรวจ pipeline อย่างไรให้เจอ schema ที่หาย
เริ่มจากค้นทุกจุดที่รัน supabase gen types ใน package scripts, CI workflow และเอกสารสำหรับนักพัฒนา เทียบรายการ --schema กับ schema ที่อยู่ในฐานข้อมูลของ environment เป้าหมาย โดยระวังช่องว่างในรายการที่คั่นด้วยจุลภาค หากมี migration ที่สร้าง schema ใหม่ ให้เรียงขั้นตอนให้ migration เสร็จและตรวจสิทธิ์ role ก่อนสร้าง types มิฉะนั้นคำเตือนจะสะท้อนสภาพฐานข้อมูลที่ยังไม่พร้อม ซึ่งควรแก้ที่กระบวนการเตรียมฐานข้อมูล ไม่ใช่แค่ปิดข้อความเตือน
เมื่อทดลองเบตา ให้บันทึก stderr แยกจาก stdout เพราะหลาย pipeline redirect เฉพาะ stdout ไปเป็นไฟล์ .ts แล้วทิ้งข้อความอีกช่องทาง ถ้าต้องการให้คำเตือนมีผลต่อการผ่าน CI สามารถตรวจรายการ warning ที่เกี่ยวข้องหรือ assert ว่าไฟล์ generated มี namespace ของ schema สำคัญอยู่ครบ วิธีหลังช่วยครอบคลุมเส้นทางที่ไม่มี warning ด้วย แต่ควรเขียนเงื่อนไขให้ตรงกับชื่อ schema ที่ระบบต้องใช้จริง ไม่ใช่ตรวจเพียงว่าไฟล์ไม่ว่าง
ตัวอย่างสถานการณ์คือโปรเจ็กต์มี public สำหรับข้อมูลทั่วไปและ billing สำหรับตารางธุรกรรม ถ้าคำสั่งระบุทั้งสองชื่อ แต่ role ของ CI ไม่มีสิทธิ์เห็น billing ไฟล์ types ที่ได้อาจยังมี public และดูปกติ การเห็น warning ที่ชี้ billing ทำให้ทีมย้อนตรวจสิทธิ์หรือ connection string ได้ทันที ก่อนปล่อยไฟล์ types ที่ขาดชนิดข้อมูลไปให้แอปใช้งาน ตรงนี้เป็นตัวอย่างการใช้งานเพื่ออธิบายผลกระทบ ไม่ใช่ข้ออ้างว่า Supabase เปลี่ยนสิทธิ์ของฐานข้อมูลในรุ่นนี้
เบตา v4.0.0-next.26 ที่ออกในวันเดียวกันมีรายการแก้เดียวกันด้วย แต่เป็นอีกช่องทางทดลองของ CLI จึงไม่ควรนับเป็นฟีเจอร์แยกหรืออัปเกรดทั้งสองสายพร้อมกัน สำหรับทีมที่ใช้เวอร์ชันเสถียร การเปลี่ยนนี้ยังเป็น pre-release ควรรอรุ่นเสถียรหรือทดลองแบบ pin เวอร์ชันใน branch ก่อน และอย่าใช้เพียงสถานะคำสั่งเป็นหลักฐานว่า generated types ครบตาม schema ที่ตั้งใจ
แหล่งต้นทาง: Supabase CLI v3.2.0-beta.17 release เผยแพร่ 16 พฤศจิกายน 2026 เวลา 09:01 UTC และ คำอธิบายการแก้ใน PR #7627
URL ต้นทาง: https://github.com/supabase/cli/releases/tag/v3.2.0-beta.17