แก้ปัญหาที่พบบ่อย
หน้านี้รวมเฉพาะปัญหาที่คู่มือและบันทึกการเปลี่ยนแปลงของโครงการบันทึกไว้ ถ้าปัญหาของท่านไม่อยู่ในหน้านี้ ให้เปิดตรวจความพร้อมของระบบดูก่อน แล้วขอความช่วยเหลือ
ตอนติดตั้ง
| อาการ | ตรวจและแก้ |
|---|---|
ตัวติดตั้งแจ้งล็อก พบ .env หรือ installed marker จากเว็บเดิม | ระบบไม่ฝืนลบ เปิดหลังบ้านเดิม หรือใช้โฟลเดอร์และฐานข้อมูลใหม่สำหรับทดลอง |
| ฐานข้อมูลไม่ว่าง | ตรวจว่ากรอกฐานใหม่จริง และไม่มีตาราง WordPress หรือของโครงการอื่น ตัวติดตั้งไม่ลบทับ |
| เชื่อมฐานข้อมูลไม่ได้ | ตรวจ host, port, prefix ของชื่อฐานและผู้ใช้ที่ hosting เติมให้ ทดสอบสิทธิ์เฉพาะฐานนั้น และไม่ส่งรหัสผ่านใน screenshot สาธารณะ |
สร้าง owner-token หรือ .env ไม่ได้ | แก้ ownership และ permission ของ website account ให้เขียน storage/ และ bootstrap/cache/ ได้ ไม่ใช้ chmod 777 |
| 419 | session หรือ CSRF หมดอายุ โหลดหน้าตัวติดตั้งใหม่และกรอกรหัสเจ้าของอีกครั้ง |
| รูปข้อมูลตัวอย่างไม่ครบ | ตรวจ resources/install/demo/media และ manifest จากแพ็กเกจเดิม ห้ามแก้ค่า hash เพื่อข้ามไฟล์ |
| ขัดข้องระหว่างติดตั้ง | กลับหน้าเดิมด้วยรหัสเจ้าของและฐานข้อมูลเป้าหมายเดิม ต้องใช้บัญชี รหัสผ่าน และโหมดเดิม ถ้า migration ค้างกลางการสร้างตาราง ให้เริ่มด้วยฐานใหม่และซอร์สแยก ไม่ reset ฐานเดิม |
หลังติดตั้ง
| อาการ | ตรวจและแก้ |
|---|---|
| ทุกหน้าขึ้น 404 | ตรวจว่า DocumentRoot ชี้ public/ ตรวจ mod_rewrite และ AllowOverride (Apache) หรือ try_files (nginx) ว่าไม่ชี้ไปที่ root ของแอป |
| ติดตั้งสำเร็จแต่เข้าสู่ระบบแล้วไม่อยู่ | ตรวจ APP_URL, HTTPS, SESSION_SECURE_COOKIE และ SESSION_PATH บน localhost ต้องใช้ config local ที่ตัวติดตั้งสร้าง ไม่คัด config คุกกี้จากโดเมนอื่น |
| เมนูยังแสดงแบบเก่า | ตรวจเลขรุ่นของไฟล์ asset แล้ว reload หลัง deploy ล้าง Laravel view และ config cache ตรวจ breakpoint ของธีมที่เพิ่มเอง และดู console errors |
มีแถบเตือนสีส้มบนหน้า /cms และ /work ว่า cron ไม่ทำงาน | ตรวจ path ของ PHP (ต้อง 8.4.1 ขึ้นไป) path ของ artisan และบัญชีผู้ใช้ แล้วดูรายการ "cron (schedule:run) ทำงาน" ที่ /cms#deployment หรือสั่ง school:doctor ติดตั้งแบบมาตรฐานต้องมี cron ทั้งสองโฟลเดอร์ ดูการตั้ง cron |
| หน้าบ้านไม่ได้ข่าวใหม่ หรือฟอร์มจากหน้าบ้านไม่เข้าระบบภายใน | cron ของระบบภายในหยุด หรือการจับคู่หลุด เปิด /admin/pairing ดูสถานะ ตรวจ cron แล้วสั่ง php artisan saan:publish --full ถ้ามี SSH |
| "ไฟล์สำรองล่าสุด" เตือน | ยังไม่มีไฟล์ใน storage/app/private/backups หรือเก่ากว่า 3 วัน ตรวจ cron และ SAAN_BACKUP_DAILY_AT หรือสำรองด้วยมือ ดูสำรองและกู้คืนข้อมูล |
ระหว่างและหลังอัปเดต
หน้า "กำลังปรับปรุงระบบ" ไม่หาย
ระบบปิดเว็บชั่วคราวระหว่างสลับไฟล์ ถ้าหน้านี้ค้างนานผิดปกติหลังอัปเดต
- รอ cron ปิดงานที่ค้างให้เอง ภายในหนึ่งนาที (cron
schedule:runสั่งsaan:update --recover --autoทุกนาที) ถ้าทุกขั้นผ่านแล้วเว็บเปิดเป็นรุ่นใหม่ ถ้าไม่ครบจะคืนรุ่นเดิม - ถ้ามี SSH สั่งเองได้ด้วย
php artisan saan:update --recover
ถ้าตัวที่เริ่มอัปเดตตายกลางการสลับไฟล์ และไม่มีขั้นทำต่อทำงานอยู่ คำขอแรกของผู้เข้าชมจะคืนไฟล์จากสำเนาและเปิดเว็บเอง ไม่ต้องมี cron หรือ SSH ดูอัปเดตสาน
OPcache: หลังอัปเดตเว็บยังเป็นโค้ดเก่า หรือปุ่มอัปเดตในหลังบ้านไม่ยอมทำงาน
บนโฮสต์ที่ตั้ง opcache.validate_timestamps=0 PHP-FPM ไม่เห็นไฟล์ที่เปลี่ยน ตัวอัปเดตของสานล้าง OPcache ของเว็บให้เองทีละไฟล์ (ทั้งตอนอัปเดตสำเร็จและตอนคืนรุ่นเดิม) แต่ทำไม่ได้เมื่อโฮสต์ห้ามเว็บใช้ API ของ OPcache (opcache.restrict_api)
- เปิดหน้า
/cms#deploymentดูรายการ "OPcache หลังอัปเดต" ซึ่งบอกว่าเป็นกรณีใด - ถ้ารายการนั้นเตือนว่าไม่ตรวจไฟล์ที่เปลี่ยนและเว็บล้างเองไม่ได้ ให้ restart PHP หลังอัปเดตทุกครั้ง
- ในกรณีนี้ระบบปฏิเสธการอัปเดตจากปุ่มในหลังบ้านก่อนแตะไฟล์ ให้อัปเดตด้วย
php artisan saan:updateจาก SSH หรือจาก cron ที่ PHP CLI เริ่ม process ได้ แล้ว restart PHP - ถ้าเว็บยังตรวจไฟล์ที่เปลี่ยนเอง (
opcache.validate_timestamps=1) ตัวอัปเดตรอรอบตรวจหนึ่งครั้ง (3 วินาที) ก่อนขั้นตอนหลังสลับไฟล์และก่อนเปิดเว็บ ไม่ต้องทำอะไรเพิ่ม
ตัวอัปเดตปฏิเสธตั้งแต่ต้น
คำสั่ง saan:update ปฏิเสธเมื่อผู้ใช้ระบบที่รันคำสั่งไม่ใช่เจ้าของไฟล์ของแอป เช่น รันด้วย root ให้รันด้วยบัญชีเดียวกับที่เป็นเจ้าของไฟล์ของแอป
--all หยุดกลางทาง
ข้อความ [ERR] หยุดที่ <ไฟล์> บอกว่าแพ็กเกจนั้นคืนรุ่นเดิมแล้ว และกี่แพ็กเกจติดตั้งไปแล้ว แก้สาเหตุตามข้อความแล้วสั่งคำสั่งเดิมซ้ำได้ ถ้าคำสั่งบอกว่าเริ่ม PHP CLI ไม่ได้ ให้ติดตั้งทีละแพ็กเกจตามลำดับที่แสดง หรือกำหนด SAAN_PHP_CLI
ยังแก้ไม่ได้
ขอความช่วยเหลือ และแนบข้อความที่ระบบแสดง (ไม่ต้องแนบรหัสผ่านหรือข้อมูลส่วนบุคคลของนักเรียน)
พบข้อผิดพลาดหรืออยากให้เพิ่มเนื้อหา แจ้งได้ที่ แบบฟอร์มติดต่อ