การแก้ปัญหาการดีพลอย
เมื่อเวอร์ชันล้มเหลว ให้อ่านสาเหตุในหน้าเวอร์ชันก่อน ถ้าเนื้อหาถูกปฏิเสธ ให้แก้แล้วอัปโหลดใหม่ ถ้าแพลตฟอร์มขัดข้อง ให้ลองอีกครั้ง
เนื้อหาถูกปฏิเสธ#
| สิ่งที่เห็น | สาเหตุ | วิธีแก้ |
|---|---|---|
| ไม่รู้ว่าจะบิลด์ซอร์สนี้อย่างไร | ชั้นบนสุดของ zip ไม่มี package.json, index.html หรือ Dockerfile | บีบอัดจากในโฟลเดอร์โปรเจกต์ หรือดูดีพลอยจากซอร์สโค้ด |
| โปรเจกต์เป็นบริการ แต่สิ่งที่อัปโหลดถูกอ่านเป็นไฟล์ธรรมดา | ชั้นบนสุดของ zip ไม่มี Dockerfile หรือไฟล์กำหนด (package.json, go.mod, pyproject.toml, requirements.txt, setup.py) โปรเจกต์อยู่ในโฟลเดอร์ย่อย เช่น backend/ | ตั้งไดเรกทอรีราก (Root Directory) เป็นโฟลเดอร์นั้นที่ การตั้งค่า › การตั้งค่าการบิลด์ แล้วดีพลอยอีกครั้ง ความล้มเหลวจะแสดงโฟลเดอร์ที่เป็นไปได้ |
ไม่พบ index.html | บีบอัดทั้งโฟลเดอร์แทนที่จะเป็นเนื้อหาในโฟลเดอร์ | บีบอัดจากในโฟลเดอร์ให้ index.html อยู่ชั้นบนสุด |
| พบความลับในไฟล์ | ไฟล์ที่อัปโหลดมีข้อความคล้าย API key หรือโทเค็น | ลบออกจากไฟล์ เปลี่ยนคีย์ใหม่ ป้อนใน ตั้งค่า ของโปรเจกต์ แล้วอัปโหลดใหม่ |
อิมเมจไม่มี CMD | Dockerfile ไม่มีคำสั่งเริ่มต้น | เพิ่ม CMD หรือ ENTRYPOINT |
ไม่มี USER นี้ | Dockerfile ระบุผู้ใช้ที่ไม่มีในอิมเมจ | ใช้ uid ที่เป็นตัวเลข หรือผู้ใช้ที่อิมเมจมี เช่น node |
| ช่องโหว่ร้ายแรง | แพ็กเกจในอิมเมจมีช่องโหว่ร้ายแรงที่รู้จักแล้ว | อัปเกรดแพ็กเกจเป็นเวอร์ชันที่ผลการสแกนระบุ หรือเปลี่ยนไปใช้อิมเมจฐานรุ่นใหม่ที่มีเวอร์ชันนั้น |
บิลด์ทำงานแล้วแต่ล้มเหลว#
รหัสความล้มเหลวคือ buildFailed บิลด์เริ่มทำงานแล้ว แต่มีขั้นตอนหนึ่งล้มเหลว ความล้มเหลวจะแสดงขั้นตอนนั้น สิ่งที่ขั้นตอนนั้นพิมพ์ออกมา และ exit code ที่จบด้วย ในคอนโซล ให้อ่านบันทึกที่ตัดมาในแถบแจ้งความล้มเหลวบนหน้าเวอร์ชัน ผ่าน MCP ให้อ่าน failure.buildLog ใน sites_deploy_status
| Exit code | สาเหตุ | วิธีแก้ |
|---|---|---|
| 127 | บิลด์เรียกใช้คำสั่งที่ไม่ได้ติดตั้ง เช่น บิลด์เรียก tsc แต่ไม่มี typescript ทั้งใน dependencies และ devDependencies ของ package.json | เพิ่มแพ็กเกจนั้น หรือนำคำสั่งนั้นออกจากคำสั่งบิลด์ |
แก้โปรเจกต์แล้วดีพลอยอีกครั้ง นี่คือการอัปโหลดใหม่ การลองเวอร์ชันเดิมอีกครั้งจะล้มเหลวแบบเดิม
ที่อยู่พรีวิวไม่ตอบ#
- หน้าเว็บ (เว็บไซต์แบบสแตติก): ที่อยู่พรีวิวจะตอบ
404site not foundจนกว่าเวอร์ชันจะเผยแพร่ - บริการ: เวอร์ชันที่ไม่เคยเผยแพร่จะยังไม่ถูกเริ่มทำงาน ที่อยู่พรีวิวจึงตอบ
502service unavailableพร้อมเฮดเดอร์X-Sites-Refusal: relay-unavailableจนกว่าจะเผยแพร่ ซึ่งไม่ใช่บิลด์ล้มเหลว
หลังเผยแพร่ ให้เปิดที่อยู่สาธารณะตรวจทันที ถ้าใช้งานไม่ได้ ให้แก้แล้วดีพลอยอีกครั้ง หากต้องการพบปัญหาก่อนผู้เข้าชม ให้ลองเวอร์ชันในสภาพแวดล้อมแยก เช่น staging ก่อน
รอการยืนยัน#
เมื่อการตรวจที่ตั้งเป็น "ถามก่อน" พบปัญหา เวอร์ชันจะหยุดที่ รอการยืนยัน หลังอ่านผลแล้ว คุณยังเผยแพร่ต่อได้ ช่องโหว่ระดับสูงอยู่ในกลุ่มนี้ วิธีแก้เหมือนช่องโหว่ร้ายแรง และคำเตือนจะหายไปเมื่ออัปเกรดแล้ว
เวอร์ชันไม่พร้อมเสียที#
ถ้าบิลด์สำเร็จและเผยแพร่แล้ว แต่แท็บ การทำงาน ไม่มีอินสแตนซ์ที่พร้อม ส่วนใหญ่เป็นเพราะเซิร์ฟเวอร์ไม่ได้รอรับที่พอร์ตที่แพลตฟอร์มกำหนด
- ดูว่าหน้าเวอร์ชันมีประกาศ
imagePortsAmbiguousหรือไม่ - ให้เซิร์ฟเวอร์รอรับที่ตัวแปรสภาพแวดล้อม
PORTหรือใส่พอร์ตที่เซิร์ฟเวอร์รอรับจริงใน ตั้งค่า › การตั้งค่าการทำงาน › พอร์ต - เลือก รีสตาร์ตบริการ
รีสตาร์ตซ้ำไปเรื่อย ๆ#
สาเหตุที่พบบ่อยคือโปรแกรมเขียนไฟล์นอก /tmp บนระบบไฟล์แบบอ่านอย่างเดียว ให้ย้ายไปเขียนที่ /tmp ดูข้อกำหนดการรันคอนเทนเนอร์
แพลตฟอร์มขัดข้อง#
เมื่อสาเหตุมาจากแพลตฟอร์มเอง ให้ลองเวอร์ชันเดิมอีกครั้ง ไม่ต้องแก้ไขหรืออัปโหลดใหม่
เวอร์ชันที่ไม่มีเครื่องบิลด์รับไปภายในหนึ่งชั่วโมงจะถูกนำกลับเข้าคิวเองหนึ่งครั้งในตำแหน่งเดิม ถ้าผ่านไปอีกหนึ่งชั่วโมงจึงจะแสดงว่าหมดอายุ ลองอีกครั้งด้วยวิธีเดียวกันได้ภายในหนึ่งวันหลังอัปโหลด หลังจากนั้นให้อัปโหลดใหม่
ถ้าส่งเวอร์ชันเข้าคิวโดยไม่ได้ตั้งใจ หรือไม่อยากรอ ให้ยกเลิกระหว่างที่ยังรอคิวอยู่ ดูยกเลิกบิลด์ที่รอคิว
ยังแก้ไม่ได้#
- ในแท็บ การทำงาน ดูสถานะอินสแตนซ์และบันทึกล่าสุด
- ในหน้าเวอร์ชัน อ่านประกาศที่แพลตฟอร์มแสดงไว้
- ขอให้เครื่องมือ AI ที่เชื่อมต่อ Agent Lab MCP อ่านสถานะการดีพลอยให้ ซึ่งเห็นรหัสเดียวกับหน้านี้