SCT

กำลังเตรียมประสบการณ์ดิจิทัล

Cloudflare เขียน module registry ของ Workers ใหม่: ทำไมการเปลี่ยนจากพาธเป็น URL ถึงปลดล็อกความเข้ากันได้กับ Node.js

ทีมที่เคยย้ายโค้ด Node.js ขึ้น Cloudflare Workers แล้วเจอไลบรารีที่เรียก import.meta.resolve() หรือพึ่งพฤติกรรม require() แบบ Node พังกลางทาง มีทางออกแล้ว Cloudflare เขียน module registry ส่วนที่ค้นหา โหลด และคอมไพล์โมดูลของ Workers ใหม่ ให้มองตัวระบุโมดูลเป็น URL ตามมาตรฐาน คอมไพล์เฉพาะโมดูลที่ถูกเรียกจริง และทำตัวใกล้ Node.js ขึ้น ระบบใหม่ต้องเปิดเองด้วยแฟล็ก บทความนี้สรุปว่าอะไรเปลี่ยน อะไรอาจทำให้โค้ดเดิมสะดุด และควรทดลองอย่างไร

ทีมที่เคยย้ายโค้ด Node.js ขึ้น Cloudflare Workers แล้วเจอไลบรารีที่เรียก import.meta.resolve() หรือพึ่งพฤติกรรม require() แบบ Node พังกลางทาง มีทางออกแล้ว Cloudflare เขียน module registry ส่วนที่ค้นหา โหลด และคอมไพล์โมดูลของ Workers ใหม่ ให้มองตัวระบุโมดูลเป็น URL ตามมาตรฐาน คอมไพล์เฉพาะโมดูลที่ถูกเรียกจริง และทำตัวใกล้ Node.js ขึ้น ระบบใหม่ต้องเปิดเองด้วยแฟล็ก บทความนี้สรุปว่าอะไรเปลี่ยน อะไรอาจทำให้โค้ดเดิมสะดุด และควรทดลองอย่างไร

module registry ทำหน้าที่อะไร

ข้อความหลังคำสั่ง import หรือ require เช่น './utils.js' หรือ 'node:fs' เรียกว่าตัวระบุโมดูล (specifier) ต้องมีผู้แปลงเป็นโค้ดจริง คอมไพล์ แล้วส่งให้เอนจิน V8 รัน ใน workerd ซึ่งเป็นแกนโอเพนซอร์สของ Workers ผู้ทำงานนี้คือ module registry

เดิมบทบาทนี้ดูไม่สำคัญ เพราะ Wrangler ใช้ esbuild รวมเกือบทุกอย่างเป็นไฟล์เดียว แต่ Vite 8 ที่ใช้ Rolldown แยกผลลัพธ์เป็นหลายโมดูล โมดูล Node.js ที่ import ก็อยู่ใน workerd ไม่ใช่ polyfill และการ deploy ด้วย --no-bundle ส่งกราฟโมดูลไปทุกไฟล์ registry จึงสำคัญขึ้น

ระบบเดิมติดอยู่ตรงไหน

อาการที่นักพัฒนาเจอคือโค้ดที่เรียก import.meta.resolve() ล้มทันที ต้นเหตุคือระบบเดิมไม่ได้ถือว่าตัวระบุเป็น URL แต่ปฏิบัติเหมือนพาธของไฟล์ จึงไม่มีทางทำ import.meta.url ให้ถูกต้องได้ โปรโตคอลอย่าง node: และ cloudflare: ต้องเขียนเป็นข้อยกเว้นทีละกรณี และการ import แบบสัมพัทธ์ก็คำนวณคนละกฎกับ new URL() บทเรียนคือเลือกตามมาตรฐานตั้งแต่วันแรกถูกกว่าแก้ทีหลัง

ด้านประสิทธิภาพ ระบบเดิมคอมไพล์ทั้งบันเดิลตั้งแต่เริ่ม และ isolate ของ V8 (สภาพแวดล้อมรันโค้ดที่แยกจากกัน) แต่ละชุดที่รัน Worker เดียวกันบนหลายคอร์มีสำเนาของตัวเอง ซอร์สเดียวกันจึงถูกคอมไพล์และเก็บซ้ำ ระบบใหม่ออกแบบให้คอมไพล์เมื่อถูก import ครั้งแรกและแบ่งปันแคชตั้งแต่ต้น ส่วนระบบเดิมยังอยู่ Worker ที่ deploy แล้วทำงานเหมือนเดิม

เปิดแฟล็กแล้วได้อะไร

  • import.meta ครบ — import.meta.url คืน URL ของโมดูล import.meta.main เป็นจริงเฉพาะโมดูลที่เป็นจุดเริ่มของ Worker และ import.meta.resolve() แปลงตัวระบุเป็น URL โดยไม่โหลดจริง
  • ตัวระบุเป็น URL จริง — ใช้ URL เต็มได้ และรองรับ query string กับ fragment
  • require(esm) ตามกฎ Node.js — ทั้งใน CommonJS และผ่าน createRequire()
  • ตรวจ import attribute จริง — ตอนนี้รองรับเฉพาะ type: 'json' ข้อเสนอเดียวที่ถึง Stage 4 ของ TC39
  • WebAssembly แบบ source phase — import source mod from './add.wasm' ได้ WebAssembly.Module ที่คอมไพล์แล้วแต่ยังไม่สร้างอินสแตนซ์
  • ข้อผิดพลาดแบบเดียวกันทุกทาง — หาไม่เจอเป็น Error ตัวระบุที่แปลงเป็น URL ไม่ได้เป็น TypeError ไม่ว่าโหลดด้วยวิธีใด

จุดที่อาจทำให้โค้ดเดิมสะดุด

การทำตามมาตรฐานเคร่งขึ้นแปลว่าโค้ดที่เคยรอดเพราะระบบเดิมมองข้าม อาจเริ่มโยนข้อผิดพลาด ควรไล่ตรวจก่อนเปิดแฟล็ก

  • attribute ที่ระบบเดิมเพิกเฉยเงียบ ๆ เช่น type: 'text' หรือ 'bytes' จะได้ TypeError ว่ายังไม่รองรับ คีย์อื่นนอกจาก type ก็ผิด
  • import ไฟล์เดียวกันด้วย query string ต่างกัน เช่น ./store.js?a กับ ./store.js?b ได้โมดูลสองชุดที่มีตัวแปรระดับบนแยกกัน ถ้าโค้ดเคยต่อ query string เพื่อเลี่ยงแคช ค่าที่ควรมีชุดเดียวอาจแตกเป็นหลายชุด
  • require() โมดูลที่มี top-level await ในกราฟจะ throw ทันที เหมือน ERR_REQUIRE_ASYNC_MODULE ของ Node.js ให้ใช้ import() แทน

ลองใช้อย่างไร และอะไรได้ทันทีโดยไม่ต้องเปิดแฟล็ก

เพิ่ม new_module_registry ในรายการ compatibility_flags ของไฟล์ตั้งค่า Wrangler แฟล็กนี้ยังไม่มีวันที่เปิดเป็นค่าเริ่มต้น จึงไม่ถูกเปิดให้เองไม่ว่า compatibility date จะเป็นวันไหน

ส่วนที่มีผลทันทีคือ Workers รองรับ API ที่เสถียรของ Node.js ที่ใช้ได้ในบริบท serverless ครบและเปิดเป็นค่าเริ่มต้น ขนาดแอปขยายเป็น 64 MiB ทุกแผน และยกเลิกเพดานขนาดบันเดิลหลังบีบอัด

สำหรับทีมพัฒนาเว็บในไทยที่ใช้ Workers หรือกำลังพิจารณาย้ายระบบขึ้นแพลตฟอร์มไร้เซิร์ฟเวอร์ การเปิดแฟล็กนี้ในสภาพแวดล้อมทดสอบก่อนคือขั้นตอนที่ควรทำ เพราะพฤติกรรมการแปลงตัวระบุที่เปลี่ยนไปอาจกระทบไลบรารีที่พึ่งพารูปแบบเดิม และควรตรวจให้ครบก่อนใช้กับระบบจริง ทีมงาน Smart Cyber Tech รับทำเว็บไซต์และเว็บแอปพลิเคชัน React และ Next.js รวมถึงวางระบบบนแพลตฟอร์มขอบเครือข่ายให้รองรับผู้ใช้จำนวนมากโดยคุมค่าใช้จ่ายได้ ปรึกษาได้ที่ แบบฟอร์มติดต่อ

สรุปสาระสำคัญ

  • module registry ทำหน้าที่อะไร
  • ระบบเดิมติดอยู่ตรงไหน
  • เปิดแฟล็กแล้วได้อะไร
แหล่งอ้างอิงเรียบเรียงจาก Cloudflare Blog — How we rebuilt Cloudflare Workers' module registry for Node.js compatibility — อ่านบทความต้นฉบับ
ภาพปก: Cloudflare Blog · ลิขสิทธิ์ภาพเป็นของเจ้าของต้นฉบับ ใช้ประกอบการรายงานพร้อมอ้างอิงแหล่งที่มา
มีคำถามเพิ่มเติมเกี่ยวกับบทความนี้? เขียนหาเราได้ที่ info@smart-cyber-tech.com
บริการที่เกี่ยวข้องจากทีมงาน Smart Cyber Tech

บทความอื่นที่เกี่ยวข้อง

บทความที่เกี่ยวข้อง

MCP เวอร์ชัน 2026-07-28 กลายเป็นโปรโตคอลไร้สถานะ: บทเรียนออกแบบ API ให้เอเจนต์เรียกใช้ได้จริง ข้อมูลและ AI

MCP เวอร์ชัน 2026-07-28 กลายเป็นโปรโตคอลไร้สถานะ: บทเรียนออกแบบ API ให้เอเจนต์เรียกใช้ได้จริง

ใครที่เคยทำ MCP server แล้วต้องปวดหัวกับการจำ session ข่าวดีคือสเปกฉบับ 2026-07-28 ตัดเรื่องนี้ทิ้งไปแล้ว MCP (Model Context Protocol) มาตรฐานที่ให้เอเจนต์ AI เรียกใช้เครื่องมือและข้อมูลภายนอก กลายเป็นโปรโตคอลไร้สถานะ แต่ละคำขอจบในตัวเอง จึงรันบน serverless ธรรมดาอย่าง Cloudflare Workers ได้โดยไม่ต้องมีระบบคอยจำสถานะ บทความนี้สรุปจากประสบการณ์ของ Cloudflare ว่าอะไรเปลี่ยน ย้ายอย่างไร และหลักออกแบบที่ทีมไทยใช้กับ API ของตัวเองได้

อ่านบทความ
ToolHive: รัน MCP server ในคอนเทนเนอร์แบบปลอดภัยด้วยเครื่องมือโอเพนซอร์ส ก่อนให้เอเจนต์ AI เข้าถึงระบบภายใน ความปลอดภัย

ToolHive: รัน MCP server ในคอนเทนเนอร์แบบปลอดภัยด้วยเครื่องมือโอเพนซอร์ส ก่อนให้เอเจนต์ AI เข้าถึงระบบภายใน

ทุกครั้งที่ทีมติดตั้ง MCP server ให้เอเจนต์ AI ใช้งาน ตัวเชื่อมนั้นมักได้สิทธิ์ทุกอย่างที่เครื่องนักพัฒนามี ทั้งไฟล์ คีย์ API และเครือข่ายภายใน โดยไม่มีใครเห็นว่ามันทำอะไรไปบ้าง ToolHive จาก Stacklok เป็นเครื่องมือโอเพนซอร์สสัญญาอนุญาต Apache 2.0 ที่จับ MCP server แต่ละตัวแยกไว้ในคอนเทนเนอร์ และต่อยอดไปถึงการยืนยันตัวตนกับบันทึกการใช้งานระดับองค์กร เราสรุปว่าอะไรได้ทันทีหลังติดตั้ง อะไรต้องลงแรงเพิ่ม และองค์กรไทยควรเริ่มอย่างไร

อ่านบทความ
รันเอเจนต์หลายตัวพร้อมกันอย่างปลอดภัย: แยกงานด้วย Git worktree ให้แต่ละเซสชันไม่รบกวนกัน DevOps

รันเอเจนต์หลายตัวพร้อมกันอย่างปลอดภัย: แยกงานด้วย Git worktree ให้แต่ละเซสชันไม่รบกวนกัน

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

อ่านบทความ

ติดต่อเพื่อขอรับคำปรึกษาจากทีมงาน

ตั้งแต่ประเมินระบบปัจจุบัน วางแผน จนถึงลงมือพัฒนา — คุยกับเราได้โดยไม่มีค่าใช้จ่าย

ปรึกษาทีมของเรา