การแก้ปัญหา Zinnector®

ข้อผิดพลาดที่ผู้ใช้พบเจอบ่อยจริง ๆ ใน Zinnector® CLI ความหมายของแต่ละข้อผิดพลาด และวิธีแก้ไข แต่ละรายการระบุข้อความที่ตรงกันทุกประการกับสิ่งที่คุณจะเห็น เพื่อให้คุณสามารถค้นหาได้ในหน้านี้ หากข้อผิดพลาดของคุณไม่มีอยู่ที่นี่ ให้รันคำสั่งที่มีปัญหาพร้อมกับ ZINNECTOR_DEBUG=1 และเปิด issue ได้ที่ github.com/Zinn-Digital/zinnector/issues พร้อมแนบข้อมูลผลลัพธ์ดังกล่าว, node --version ของคุณ และระบบปฏิบัติการของคุณ

"spawn EINVAL" ทันทีหลังจากยอมรับการติดตั้งรันไทม์ (Windows)

ข้อบกพร่องใน Zinnector® 0.1.0 และ 0.1.1 บน Windows ตัวติดตั้งรันไทม์จะรัน npm.cmd ตามชื่อ และ Node ปฏิเสธที่จะ spawn ไฟล์ .cmd โดยไม่มีเชลล์มาตั้งแต่การแก้ไขช่องโหว่ CVE-2024-27980 — การติดตั้งจึงขัดข้องในหนึ่งวินาทีหลังจากที่คุณตอบ Y แก้ไขแล้วใน 0.1.2: ตอนนี้ npm จะถูกรันในรูปแบบ node npm-cli.js ซึ่งเหมือนกันในทุกแพลตฟอร์มและไม่ต้องใช้เชลล์ ให้รัน npm install -g zinnector@latest แล้วตามด้วย zinnector dev อีกครั้ง

"npm WARN EBADENGINE" ระหว่างการติดตั้ง หรือ "Zinnector® needs Node 24 or newer"

Node ของคุณเก่ากว่าเวอร์ชัน 24 โดย npm จะแสดงคำเตือนเนื่องจากแพ็กเกจประกาศว่า engines: >=24.18.1 การติดตั้งยังคงเสร็จสิ้นตามปกติ แต่หลังจากนั้น zinnector จะปฏิเสธที่จะเริ่มทำงาน (exit code 78) แทนที่จะไปล้มเหลวในจุดอื่นที่ชวนสับสนในภายหลัง โปรดติดตั้งเวอร์ชัน LTS ปัจจุบันจาก nodejs.org — winget install OpenJS.NodeJS.LTS บน Windows, brew install node@24 บน macOS — ยืนยันว่า node --version แสดงเป็น v24 หรือสูงกว่า แล้วติดตั้ง Zinnector® ใหม่อีกครั้ง

"gyp ERR!", "Building from source with node-gyp" หรือ "You need to install Visual Studio"

รันไทม์ของ WordPress มีเนทีฟโมดูลซึ่งมีไบนารีที่สร้างไว้ล่วงหน้าสำหรับ Node 24 และ 25 เท่านั้น หากใช้ Node เวอร์ชันที่ใหม่กว่า (ตั้งแต่ 26 ขึ้นไป ณ เดือนกันยายน 2026) ตัวติดตั้งจะเปลี่ยนไปคอมไพล์จากซอร์สโค้ดแทน ซึ่งในเครื่อง Windows ทั่วไปจะจบลงด้วยการร้องขอ Visual Studio แก้ไขแล้วใน 0.1.2: Zinnector® จะตรวจจับสิ่งนี้ก่อนที่จะดาวน์โหลดอะไร และจะดึง Node 24 มาสำหรับตัวรันไทม์โดยเฉพาะ — ขนาดประมาณ 30 MB ซึ่งได้รับการตรวจสอบความถูกต้องเทียบกับเช็คซัมของ nodejs.org แล้ว — ดังนั้นจึงไม่มีสิ่งใดถูกคอมไพล์เลย หากคุณยังคงพบข้อผิดพลาดนี้หลังจากอัปเกรดแล้ว ให้รัน zinnector dev --reset-runtime เพื่อทิ้งการติดตั้งที่ค้างไว้ก่อนหน้านี้ออกไปก่อน

คำเตือน "EPERM" จาก npm ขณะกำลังล้างข้อมูล (Windows)

แทบจะเกือบทุกกรณีเกิดจากโปรแกรมสแกนไวรัสหรือตัวจัดทำดัชนีการค้นหากำลังเปิดไฟล์ค้างไว้อยู่ภายใต้ node_modules ของรันไทม์ ในขณะที่ npm พยายามจะลบไฟล์นั้น การติดตั้งจะถูกลองใหม่จากไดเรกทอรีที่สะอาดในการรัน zinnector dev ครั้งถัดไป หากยังคงเกิดขึ้นเรื่อย ๆ คำสั่ง zinnector dev --reset-runtime จะลบไดเรกทอรีรันไทม์ทั้งหมดออกก่อนแล้วจึงทำการติดตั้งใหม่อีกครั้ง

"the local playground runtime could not be installed"

ข้อความดังกล่าวจะรวมถึงบรรทัดสุดท้ายของ npm เองและคำสั่งที่ตรงกันทุกประการที่ Zinnector® รัน เพื่อให้คุณสามารถรันคำสั่งนั้นด้วยตนเองและดูผลลัพธ์ทั้งหมดได้ สาเหตุโดยทั่วไปคือปัญหาเกี่ยวกับเครือข่ายหรือพร็อกซี — เนื่องจากรันไทม์ถูกดึงข้อมูลผ่าน npm ของคุณเอง ดังนั้นการตั้งค่า npm config set proxy … และ registry mirror จึงมีผลด้วย — หรืออาจเกิดจากการติดตั้งก่อนหน้าที่ยังไม่เสร็จสมบูรณ์ ซึ่ง --reset-runtime จะช่วยล้างข้อมูลนี้ได้

"the local playground exited before it was ready" หรือไม่พร้อมทำงานเสียที

รัน zinnector dev --verbose เพื่อดูเอาต์พุตของตัวรันไทม์เอง ปัญหาที่พบบ่อยคือพอร์ตถูกใช้งานอยู่แล้ว: ให้ใช้ zinnector dev --port 9401 หรือกำหนดค่า port ใน zinnector.json สำหรับรันไทม์ที่ติดตั้งแล้วแต่ไม่ยอมบูต: ให้ใช้ zinnector dev --reset-runtime การบูตครั้งแรกจะมีการดาวน์โหลดตัว WordPress เองด้วย ดังนั้นหากการเชื่อมต่อช้า โปรดรอสักสองสามนาที CLI จะรอสูงสุดถึงห้านาทีก่อนที่จะรายงานการหมดเวลาแทนที่จะค้างไปเฉย ๆ

"this project is not a git repository" เมื่อ push

การปรับใช้ (deploy) จะดำเนินการจากที่เก็บโค้ด (repository) ดังนั้น zinnector push จึงต้องใช้ repository ที่มี remote ซึ่งแพลตฟอร์มสามารถเข้าถึงได้ ให้รัน git init && git add -A && git commit -m initial เพิ่ม GitHub หรือ GitLab remote ของคุณ จากนั้นรัน zinnector link เพื่อเชื่อมต่อเข้ากับเว็บไซต์

เว็บไซต์กลายเป็นหน้าขาวหลังจาก deploy

ให้รัน zinnector check ร้อยละเก้าสิบเกิดจากความแตกต่างของเวอร์ชัน PHP — คุณสร้างงานบน PHP เวอร์ชันที่ใหม่กว่าเวอร์ชันที่สล็อตกำลังทำงานอยู่ — และรายงานจะระบุว่าควรสลับสล็อตไปใช้เวอร์ชันใดด้วย zinnector php <version> หรือควรพัฒนาเทียบกับเวอร์ชันใดด้วย zinnector dev --php <version> ส่วนคำสั่ง zinnector logs --error จะแสดงข้อผิดพลาดร้ายแรง (fatal) ตัวจริง

เนื้อหาที่เกี่ยวข้อง

• เริ่มต้นใช้งาน · การพัฒนาในเครื่อง · การปรับใช้ · ข้อมูลอ้างอิงคำสั่ง