แก้ไขปัญหา “ข้อผิดพลาดฐานข้อมูล” บน Nextcloud WebGUI หลังจากการอัปเดต: คู่มือการแก้ไขปัญหาเชิงปฏิบัติ

ข้อความแจ้งเตือนบน Nextcloud WebGUI เช่นException: Database Error ปรากฏขึ้นทันทีหลังจากการอัปเดต โดยปกติแล้วหมายความว่าเว็บแอปพลิเคชันสามารถโหลดได้ไกลพอที่จะเข้าถึงเลเยอร์ฐานข้อมูล แต่การสืบค้นข้อมูล การย้ายข้อมูล การตรวจสอบโครงสร้างข้อมูล การเชื่อมต่อ หรือการดำเนินการฐานข้อมูลเฉพาะแอปพลิเคชันล้มเหลว อย่าเริ่มต้นด้วยการลบตาราง ติดตั้ง Nextcloud ใหม่ หรือกู้คืนไดเร็กทอรีโค้ดเก่าทับไดเร็กทอรีใหม่ ลำดับขั้นตอนที่ปลอดภัยกว่าคือการระบุคำสั่ง SQL หรือการย้ายข้อมูลที่ล้มเหลว ดำเนินการอัปเดตให้เสร็จสิ้นตามเส้นทางที่รองรับ ซ่อมแซมเฉพาะสิ่งที่ Nextcloud รู้จักวิธีการซ่อมแซม และตรวจสอบบริการฐานข้อมูลและโครงสร้างข้อมูลก่อนที่จะเปิดให้เข้าถึงอีกครั้ง

เอกสารอ้างอิงนี้อ้างอิงจากเอกสารการดูแลระบบ Nextcloud 35 ฉบับปัจจุบันที่มีให้ใช้งานในเดือนตุลาคม 2026 คำสั่งด้านล่างนี้สมมติว่าเป็นการติดตั้งแบบ Debian/Ubuntu ทั่วไป โดย/var/www/nextcloudใช้ผู้ใช้เว็บเซิร์ฟเวอร์www-dataโปรดปรับเส้นทาง ไบนารี PHP คำสั่งคอนเทนเนอร์ หรือผู้ใช้ HTTP ให้เหมาะสมกับการใช้งานของคุณ

การวินิจฉัยอย่างรวดเร็ว: ข้อผิดพลาดนี้มักบ่งชี้ถึงอะไร

1. รักษาข้อมูลสถานะปัจจุบันไว้ก่อนทำการเปลี่ยนแปลงฐานข้อมูล

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

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

2. อ่านข้อความแสดงข้อผิดพลาดของฐานข้อมูลอย่างละเอียดในบันทึกของ Nextcloud

สำหรับการบันทึกข้อมูลลงไฟล์ ไฟล์บันทึกเริ่มต้นจะอยู่nextcloud.logในไดเร็กทอรีข้อมูลที่กำหนดค่าไว้ คู่มือการแก้ไขปัญหาของ Nextcloud แนะนำให้ตรวจสอบไฟล์บันทึกนั้น และหากเกี่ยวข้อง ให้ตรวจสอบไฟล์บันทึกของเว็บเซิร์ฟเวอร์และ PHP ด้วย หากหน้าแสดงข้อผิดพลาดแสดงรหัสคำขอ ให้ค้นหารหัสคำขอนั้นเพื่อแยกธุรกรรมที่ตรงกัน

sudo -u www-data tail -n 100 /var/www/nextcloud/data/nextcloud.log

อย่าลดข้อความบันทึกให้เหลือเพียง “ข้อผิดพลาดของฐานข้อมูล” ให้บันทึกรหัส SQLSTATE, คลาสของข้อยกเว้น, ตารางหรือคอลัมน์ที่เกิดข้อผิดพลาด และแอปพลิเคชันหรือส่วนประกอบหลักที่ระบุใน stack trace ตัวอย่างเช่น “ตารางไม่มีอยู่” เป็นข้อผิดพลาดที่แตกต่างจาก “การเชื่อมต่อมากเกินไป” หรือ “เซิร์ฟเวอร์ MySQL หยุดทำงาน” Nextcloud ได้ระบุข้อผิดพลาดทั่วไปหลายรายการในรูปแบบ SQLSTATE ไว้ในเอกสารการแก้ไขปัญหาทั่วไป

3. ตรวจสอบว่าการอัปเดตเสร็จสมบูรณ์แล้วหรือไม่

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

cd /var/www/nextcloud
sudo -E -u www-data php occ status

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

sudo -E -u www-data php occ maintenance:mode --on
sudo -E -u www-data php occ status

4. ดำเนินการย้ายฐานข้อมูลและแอปพลิเคชันที่รองรับให้เสร็จสมบูรณ์ด้วยคำสั่ง occ upgrade

หากโค้ดได้รับการอัปเดตแล้ว แต่การย้ายข้อมูลยังไม่เสร็จสมบูรณ์ ให้เรียกใช้คำสั่งอัปเกรดในฐานะผู้ใช้ HTTP:

cd /var/www/nextcloud
sudo -E -u www-data php occ upgrade

เฝ้าดูผลลัพธ์จนกว่าคำสั่งจะรายงานว่าสำเร็จหรือหยุดทำงานเนื่องจากความล้มเหลวเฉพาะอย่างใดอย่างหนึ่ง หากล้มเหลว ให้แก้ไข ข้อกำหนดเบื้องต้น นั้นก่อนที่จะทำซ้ำคำสั่ง สาเหตุที่พบบ่อย ได้แก่ แอปที่ไม่เข้ากัน เวอร์ชัน PHP/ฐานข้อมูลที่ไม่รองรับ บริการฐานข้อมูลไม่พร้อมใช้งาน หรือสิทธิ์ที่ขัดขวางการทำงานอัปเดตที่จำเป็น อย่ารีเฟรช WebGUI ซ้ำๆ ในขณะที่การย้ายข้อมูลล้มเหลว

เอกสารแนะนำการอัปเกรดของ Nextcloud ยังเตือนไม่ให้ข้ามเวอร์ชันหลัก ควรอัปเกรดทีละเวอร์ชันหลักเมื่อต้องการเปลี่ยนเวอร์ชันหลัก

5. เรียกใช้ขั้นตอนการซ่อมแซมของ Nextcloud หลังจากแก้ไขปัญหาการย้ายข้อมูลเรียบร้อยแล้ว

maintenance:repairคำสั่งนี้จะดำเนินการขั้นตอนการซ่อมแซมของ Nextcloud และจะทำงานโดยอัตโนมัติระหว่างการอัปเกรด การเรียกใช้คำสั่งนี้ด้วยตนเองเป็นสิ่งที่เหมาะสมหลังจากที่คุณแก้ไขปัญหาที่ขัดขวางการอัปเดตแล้ว:

sudo -E -u www-data php occ maintenance:repair

วิธีนี้ปลอดภัยกว่าการสร้างคำสั่ง SQL เอง เพราะขั้นตอนการซ่อมแซมนั้นมีอยู่ในระบบหลักและแอปพลิเคชันของ Nextcloud อยู่แล้ว อย่างไรก็ตาม มันไม่ใช่สิ่งที่จะมาทดแทนคำสั่ง `make` ได้อย่างมหัศจรรย์occ upgradeและจะไม่สามารถแก้ไขเซิร์ฟเวอร์ฐานข้อมูลที่หยุดทำงานหรือฐานข้อมูลเวอร์ชันที่ไม่ได้รับการสนับสนุนได้ คำสั่งนี้มีเอกสารอธิบายไว้ในคู่มือคำสั่งระบบและการบำรุงรักษาของ Nextcloud

6. ตรวจสอบบริการฐานข้อมูล การตั้งค่าการเชื่อมต่อ และเวอร์ชันที่รองรับ

หากบันทึกชี้ไปที่การเชื่อมต่อมากกว่าโครงสร้างข้อมูล ให้ตรวจสอบว่าบริการฐานข้อมูลทำงานอยู่และสามารถเข้าถึงได้จากสภาพแวดล้อม PHP ของ Nextcloud โดยทั่วไปแล้ว บนโฮสต์ MariaDB การตรวจสอบที่มีประโยชน์อย่างหนึ่งคือ:

sudo systemctl status mariadb

จากนั้นตรวจสอบการตั้งค่าฐานข้อมูลในส่วนต่างๆconfig/config.phpได้แก่ ประเภทฐานข้อมูล โฮสต์ ชื่อฐานข้อมูล ผู้ใช้ และการตั้งค่าซ็อกเก็ตหรือพอร์ต ข้อผิดพลาดของซ็อกเก็ต Unix อาจปรากฏเป็น “ไม่มีไฟล์หรือไดเร็กทอรีดังกล่าว” ในขณะที่ฐานข้อมูลระยะไกลอาจล้มเหลวเนื่องจากการกำหนดเส้นทาง DNS TLS กฎไฟร์วอลล์ ข้อมูลรับรอง หรือตัวเซิร์ฟเวอร์เอง

ความเข้ากันได้ของเวอร์ชันมีความสำคัญหลังจากการอัปเดต Nextcloud ครั้งใหญ่ สำหรับ Nextcloud 35 บันทึกการเผยแพร่ฉบับทางการระบุว่า MariaDB 10.6 และ MySQL 8.0 ไม่ได้รับการสนับสนุนอีกต่อไป เวอร์ชันขั้นต่ำที่ระบุไว้คือ MariaDB 10.11 LTS และ MySQL 8.4 LTS ตรวจสอบข้อกำหนดสำหรับเวอร์ชันหลักของ Nextcloud ของคุณก่อนที่จะอัปเกรดฐานข้อมูลด้วยตนเอง ดูที่การอัปเกรดเป็น Nextcloud 35

7. ตรวจสอบความคลาดเคลื่อนของโครงสร้างข้อมูล และเพิ่มเฉพาะโครงสร้างที่ขาดหายไปตามที่ระบุไว้ในเอกสารเท่านั้น

Nextcloud 35 เพิ่มdb:schema:checkฟังก์ชันที่เปรียบเทียบสคีมาปัจจุบันกับสคีมาที่คาดหวังโดยระบบหลักและการย้ายข้อมูลแอปพลิเคชันที่ติดตั้งไว้ ฟังก์ชันนี้เป็นแบบอ่านอย่างเดียว: จะรายงานความแตกต่างโดยไม่เปลี่ยนแปลงฐานข้อมูล

sudo -E -u www-data php occ db:schema:check
sudo -E -u www-data php occ db:schema:check -v

หากหน้าภาพรวมผู้ดูแลระบบหรือผลลัพธ์คำสั่งรายงานว่ามีคอลัมน์เสริม ดัชนี หรือคีย์หลักหายไป ให้ใช้คำสั่งการบำรุงรักษาที่ระบุไว้ในเอกสาร:

sudo -E -u www-data php occ db:add-missing-columns
sudo -E -u www-data php occ db:add-missing-indices
sudo -E -u www-data php occ db:add-missing-primary-keys

แต่ละคำสั่งรองรับ--dry-runการแสดงตัวอย่าง SQL คำสั่งเหล่านี้ไม่ควรใช้แทนการย้ายข้อมูลหลักที่ล้มเหลว หากdb:schema:checkรายงานวัตถุที่ไม่คาดคิดหรือความแตกต่างของคุณสมบัติคอลัมน์ โปรดตรวจสอบสิ่งที่พบก่อนเปลี่ยนแปลงใดๆ Nextcloud ระบุว่าค่าเริ่มต้นบางอย่างทั่วทั้งฐานข้อมูลอยู่นอกเหนือแบบจำลองสคีมาที่คาดหวังไว้ เอกสารอ้างอิงคำสั่งที่เชื่อถือได้คือ คำสั่ง Nextcloud DAV และฐานข้อมูล

8. แยกแยะปัญหาที่เกิดจากแอปพลิเคชันของบุคคลที่สามก่อนที่จะเปิด WebGUI อีกครั้ง

หากข้อความแสดงข้อผิดพลาด (stack trace) ระบุชื่อแอปที่ไม่ใช่แอปที่ติดตั้งมาพร้อมกับระบบ การย้ายแอปนั้นอาจไม่เข้ากันกับเวอร์ชันเซิร์ฟเวอร์ใหม่ คู่มือการแก้ไขปัญหาของ Nextcloud แนะนำให้ปิดใช้งานแอปของบุคคลที่สาม/แอปที่ไม่ใช่แอปที่ติดตั้งมาพร้อมกับระบบสำหรับการอัปเกรดและการแก้ไขปัญหา ใช้คำสั่งแอปที่มีอยู่ในเวอร์ชันที่คุณติดตั้งเพื่อปิดใช้งานแอปที่ต้องสงสัยจากบรรทัดคำสั่ง เรียกใช้คำสั่งอีกครั้งocc upgradeและเปิดใช้งานแอปอีกครั้งหลังจากยืนยันแล้วว่าเวอร์ชันนั้นเข้ากันได้

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

9. ออกจากโหมดบำรุงรักษาและตรวจสอบข้อมูลเพิ่มเติมมากกว่าแค่หน้าเข้าสู่ระบบ

หลังจากocc upgradeดำเนินการเสร็จสิ้น การซ่อมแซม/ตรวจสอบโครงสร้างฐานข้อมูลจะไม่พบปัญหาที่ทำให้การทำงานหยุดชะงักอีกต่อไป และบริการฐานข้อมูลมีเสถียรภาพแล้ว ให้ปิดใช้งานโหมดบำรุงรักษา:

sudo -E -u www-data php occ maintenance:mode --off

จากนั้นตรวจสอบอินสแตนซ์ทีละชั้น: โหลดหน้าเข้าสู่ระบบ ลงชื่อเข้าใช้ เปิดไฟล์ เรียกดูโฟลเดอร์ต่างๆ ทดสอบการอัปโหลด/ดาวน์โหลดไฟล์ ตรวจสอบการตั้งค่าการดูแลระบบเพื่อดูคำเตือน และตรวจสอบnextcloud.logรายการใหม่ล่าสุด นอกจากนี้ ตรวจสอบให้แน่ใจว่า cron/งานเบื้องหลังทำงานได้ตามปกติ การกู้คืนหน้าแรกเพียงอย่างเดียวไม่ได้พิสูจน์ว่าการย้ายแอป การดำเนินการไฟล์ และงานเบื้องหลังทำงานได้อย่างปกติ

รายการตรวจสอบการกู้คืน

• เก็บไฟล์สำรองข้อมูลก่อนอัปเดตไว้ และหลีกเลี่ยงการดาวน์เกรดที่ไม่ได้รับการสนับสนุน
• อ่านรายละเอียดข้อผิดพลาดของฐานข้อมูลทั้งหมดnextcloud.logรวมถึง SQLSTATE และส่วนประกอบที่ระบุในข้อมูลการติดตาม
• ตรวจสอบocc statusและตั้งค่าอินสแตนซ์ให้อยู่ในโหมดบำรุงรักษาในระหว่างการซ่อมแซม
• เรียกใช้คำสั่งocc upgradeเพื่อดำเนินการย้ายข้อมูลหลักและแอปพลิเคชันที่รองรับให้เสร็จสมบูรณ์
• แก้ไขปัญหาอุปสรรคแรกที่เป็นต้นเหตุ แทนที่จะแก้ไขตารางฐานข้อมูลโดยไม่ไตร่ตรอง
• เรียกใช้งานmaintenance:repairหลังจากแก้ไขข้อผิดพลาดที่เกิดขึ้นแล้ว
• ตรวจสอบสถานะการทำงานของบริการฐานข้อมูล การตั้งค่าการเชื่อมต่อ และความเข้ากันได้ของเวอร์ชัน
• ใช้db:schema:checkกับ Nextcloud 35 และdb:add-missing-*คำสั่งที่ระบุไว้ในเอกสารตามความเหมาะสม
• หากพบร่องรอยการทำงานผิดพลาด ให้ปิดใช้งานแอปพลิเคชันของบุคคลที่สามที่ทำให้เกิดข้อผิดพลาด จากนั้นลองทำการอัปเกรดอีกครั้ง
• ปิดโหมดบำรุงรักษาหลังจากตรวจสอบ CLI ผ่านแล้ว จากนั้นจึงทดสอบไฟล์ การถ่ายโอน คำเตือนของผู้ดูแลระบบ บันทึก และงานเบื้องหลัง

เมื่อใดควรบูรณะแทนการซ่อมแซม

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

หลักการสำคัญนั้นง่ายมาก: ข้อความ "ข้อผิดพลาดฐานข้อมูล" หลังการอัปเดตไม่ใช่เหตุผลที่จะต้องเดาโค้ด SQL รอให้บันทึกการทำงานระบุสาเหตุของความล้มเหลว รอให้occ upgradeการย้ายข้อมูลเสร็จสมบูรณ์ ใช้เครื่องมือซ่อมแซมและโครงสร้างฐานข้อมูลของ Nextcloud เอง และตรวจสอบความถูกต้องของแพลตฟอร์มฐานข้อมูลก่อนที่จะเปิดใช้งานอินสแตนซ์อีกครั้ง