ตรวจสอบหาสาเหตุของการส่งออกไฟล์ PDF ที่ล้มเหลวของ ONLYOFFICE

บันทึกเอกสารต้นฉบับก่อน จากนั้นตรวจสอบว่าความผิดพลาดเกิดขึ้นในการแปลงไฟล์ PDF ของ ONLYOFFICE หรือในการดาวน์โหลดขั้นสุดท้ายของเบราว์เซอร์ หากโปรแกรมแก้ไขรายงานข้อผิดพลาดในการแปลง ให้ตรวจสอบบันทึกของเซิร์ฟเวอร์เอกสารและยืนยันว่าเซิร์ฟเวอร์สามารถเข้าถึงไฟล์ต้นฉบับได้ หากการแปลงสำเร็จ แต่เบราว์เซอร์แสดงข้อความ “การดาวน์โหลดล้มเหลว” ให้ตรวจสอบสถานะการดาวน์โหลด สิทธิ์การเข้าถึงเว็บไซต์ และพื้นที่ว่างในดิสก์ของเบราว์เซอร์แทน

ตัวอย่างสถานการณ์:ลองนึกภาพว่าจอร์แดน ผู้ดูแลระบบที่ใช้โปรแกรมแก้ไขเอกสาร ONLYOFFICE Docs ที่ติดตั้งเอง เลือก ไฟล์ > ดาวน์โหลดเป็น > PDF สำหรับรายงานโครงการ โปรแกรมแก้ไขแสดงข้อผิดพลาดและไม่มีไฟล์ PDF ปรากฏขึ้น นี่เป็นเพียงตัวอย่างสมมติ ไม่ใช่เหตุการณ์ที่เกิดขึ้นจริง อาการเดียวกันนี้อาจเกิดขึ้นได้ในขั้นตอนต่างๆ ดังนั้นการตรวจสอบด้านล่างจึงมุ่งเน้นไปที่จุดที่กระบวนการหยุดลง

1. ป้องกันซอร์สโค้ดและจำลองข้อผิดพลาดเพียงครั้งเดียว

ก่อนเริ่มแก้ไขปัญหา ให้ใช้คำสั่งบันทึกหรือ Ctrl+S เพื่อบันทึกการแก้ไขปัจจุบัน ในโปรแกรมแก้ไขเอกสารออนไลน์ ONLYOFFICE จะระบุเส้นทางการส่งออก PDF เป็น ไฟล์ > ดาวน์โหลดเป็น > PDF โปรแกรมแก้ไขอาจเตรียมไฟล์ PDF ก่อน แล้วจึงส่งผลลัพธ์ไปยังเบราว์เซอร์ ดังนั้นการดาวน์โหลดผ่านเบราว์เซอร์ที่ล้มเหลวไม่ได้หมายความว่าการแปลงล้มเหลวเสมอไป

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

2. หากเบราว์เซอร์แสดงข้อความว่าการดาวน์โหลด PDF ล้มเหลว

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

กรณีสมมติของจอร์แดนชี้ให้เห็นว่าปัญหาอาจอยู่ที่เบราว์เซอร์ เมื่อโปรแกรมแก้ไขเตรียมไฟล์ PDF เสร็จแล้ว แต่รายการดาวน์โหลดกลับรายงานข้อผิดพลาดด้านเครือข่ายหรือสิทธิ์การเข้าถึง วิธีแก้ปัญหาที่ได้ผลคือใช้เมนู ไฟล์ > พิมพ์ แล้วเลือก "บันทึกเป็น PDF" ของเบราว์เซอร์หรือระบบปฏิบัติการ (ถ้ามี) ตรวจสอบหน้าเว็บ ฟอนต์ และลิงก์ที่ได้ เพราะผลลัพธ์การพิมพ์อาจแตกต่างจากการส่งออก PDF โดยตรงจากโปรแกรมแก้ไข วิธีแก้ปัญหานี้ไม่ได้แก้ไขข้อผิดพลาดในการแปลงไฟล์ฝั่งเซิร์ฟเวอร์

3. หากการแปลงหรือการดึงข้อมูลจากแหล่งที่มาล้มเหลว

สำหรับการติดตั้งแบบโฮสต์เอง โปรดขอให้ผู้ดูแลระบบตรวจสอบบันทึกของ Document Server ในขณะที่ลองใหม่ ONLYOFFICE จะจัดเก็บบันทึก Linux ไว้ที่/var/log/onlyoffice/documentserver; สำหรับ Docker บันทึกจะอยู่ที่ภายในคอนเทนเนอร์ตามเส้นทางนั้น และสามารถตรวจสอบเอาต์พุตของ Docker ได้ด้วยdocker logs <container>ส่วนประกอบและข้อความในบันทึกจะขึ้นอยู่กับการติดตั้งและเวอร์ชัน มองหาข้อผิดพลาดในการแปลง การหมดเวลา คำขอที่ล้มเหลว รหัสสถานะ HTTP หรือข้อผิดพลาด DNS และการเชื่อมต่อ อย่าโพสต์บรรทัดบันทึกทั้งหมดต่อสาธารณะหากมี URL ส่วนตัว โทเค็นการเข้าถึง ชื่อผู้ใช้ หรือชื่อเอกสาร

เมื่อบันทึกหรือ API ระบุปัญหาการดาวน์โหลดแหล่งที่มา ให้ตรวจสอบว่าเซิร์ฟเวอร์เอกสารสามารถเข้าถึง URL ของเอกสารต้นฉบับจากเน็ตเวิร์กเนมสเปซของตนเองได้หรือไม่ ผู้ดูแลระบบสามารถทดสอบ URL ที่ได้รับอนุญาตจากเซิร์ฟเวอร์หรือคอนเทนเนอร์ และตรวจสอบ DNS การกำหนดเส้นทาง กฎไฟร์วอลล์ การตั้งค่าพร็อกซี ใบรับรอง TLS และการตอบสนองของแอปจัดเก็บข้อมูล URL ที่เปิดในเบราว์เซอร์บนเดสก์ท็อปของคุณอาจยังไม่สามารถเข้าถึงได้จากเซิร์ฟเวอร์เอกสาร ในทางกลับกัน หากดาวน์โหลดแหล่งที่มาสำเร็จ แต่การแปลงล้มเหลว ให้ตรวจสอบข้อผิดพลาดของตัวแปลงแทนที่จะเปลี่ยนการเข้าถึงเครือข่าย

สำหรับเวิร์กโฟลว์การแปลงไฟล์ผ่าน API ให้ใช้รหัสข้อผิดพลาดที่ได้รับกลับมาเพื่อระบุปัญหาให้แคบลง ONLYOFFICE กำหนดข้อผิด พลาดในการแปลงไฟล์ไว้ดังนี้: ข้อ -4ผิดพลาดในการดาวน์โหลดไฟล์อินพุต, -2หมดเวลา, -3ข้อผิดพลาดในการแปลงไฟล์ และ-8โทเค็นไม่ถูกต้อง รหัสเหล่านี้เป็นรหัสเฉพาะสำหรับการตอบสนองของ API การแปลงไฟล์ ข้อความ "ดาวน์โหลดล้มเหลว" ทั่วไปในโปรแกรมแก้ไขไม่ได้พิสูจน์ว่าการแปลงไฟล์ PDF ส่งคืนรหัสใดรหัสหนึ่งเหล่านี้

4. ตรวจสอบการเข้าถึง สิทธิ์อนุญาต และขนาดไฟล์เฉพาะเมื่อมีหลักฐานชี้ชัดเท่านั้น

หากไฟล์ที่จัดเก็บอยู่ในแพลตฟอร์มที่เชื่อมต่อเพียงแพลตฟอร์มเดียวใช้งานไม่ได้ ให้ตรวจสอบที่อยู่เซิร์ฟเวอร์เอกสารและการตั้งค่าการเข้าถึงภายในของตัวเชื่อมต่อ บริการแก้ไขต้องสามารถดึงไฟล์จากระบบจัดเก็บข้อมูลได้ เอกสารการแก้ไขปัญหาของ ONLYOFFICE อธิบายว่า “การดาวน์โหลดล้มเหลว” ระหว่างการโหลดตัวแก้ไขนั้นเกิดจากบริการแก้ไขไม่สามารถเข้าถึง URL ของไฟล์ได้ คำแนะนำนั้นมีประโยชน์เมื่อรายงานไม่สามารถเปิดหรือโหลดได้ หากตัวแก้ไขเปิดได้ตามปกติและมีเพียงการส่งออก PDF เท่านั้นที่ล้มเหลว ให้ตรวจสอบขั้นตอนการส่งออกหรือการดาวน์โหลดก่อน

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

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

ตรวจสอบผลลัพธ์

• ตรวจสอบว่าไฟล์ที่ดาวน์โหลดมามีอยู่จริง มีขนาดไม่เป็นศูนย์ และสามารถเปิดได้ในโปรแกรมอ่านไฟล์ PDF
• ตรวจสอบหน้าแรกและหน้าสุดท้าย จำนวนหน้า และแบบอักษรหรือรูปภาพที่สำคัญบางส่วนเทียบกับต้นฉบับ
• ลองทำการส่งออกซ้ำอีกครั้งหลังจากแก้ไขปัญหาแล้ว หากยังคงล้มเหลว ให้บันทึกเวลา เวอร์ชันของ ONLYOFFICE Docs ขั้นตอนการส่งออก และรหัสข้อผิดพลาดที่ปกปิดแล้ว หรือส่วนหนึ่งของบันทึกการทำงาน

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