วิธีแก้ไขข้อความแสดงข้อผิดพลาดทั่วไปของ Nginx: คำแนะนำทีละขั้นตอน

ข้อผิดพลาด NGINX คืออะไร?

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

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

ข้อผิดพลาด Nginx สามารถแสดงออกมาในรูปแบบต่างๆ ซึ่งบางอย่างคุณอาจคุ้นเคยอยู่แล้ว ตัวอย่างเช่น ข้อผิดพลาด 502 Bad Gateway nginx, 404 Not Found Error, 503 Service Unavailable Error, 504 Gateway Timeout Error รวมถึงข้อผิดพลาดในการเปลี่ยนเส้นทาง (301 และ 302)

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

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

ข้อผิดพลาด Nginx ทั่วไปบางประเภท

ข้อผิดพลาด Nginx อาจเกิดจากแหล่งที่มาต่างๆ รวมถึงการกำหนดค่าผิดพลาด ปัญหาฝั่งเซิร์ฟเวอร์ ปัญหาเครือข่าย หรือคำขอของไคลเอ็นต์ มาดูข้อผิดพลาด Nginx ประเภททั่วไปที่คุณอาจพบ:

ข้อความแสดงข้อผิดพลาดและวิธีแก้ปัญหาทั่วไปของ Nginx:

1. ข้อผิดพลาดเกตเวย์ 502 ไม่ถูกต้อง:

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

อ่าน: วิธีแก้ไขข้อผิดพลาด 502 Bad Gateway NGINX (7 วิธี)

2. ข้อผิดพลาด 404 ไม่พบ:

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

• สาเหตุ: ข้อผิดพลาดนี้บ่งชี้ว่าไม่พบทรัพยากรที่ร้องขอบนเซิร์ฟเวอร์
• วิธีแก้ไข: เพื่อแก้ไขปัญหานี้ ให้ตรวจสอบการมีอยู่ของไฟล์หรือไดเร็กทอรี nginx.conf ตรวจสอบการกำหนดค่า URL และตรวจหาปัญหาความไวของตัวพิมพ์เล็กและใหญ่

อ่าน: วิธีแก้ไขข้อผิดพลาด 404 ไม่พบสำหรับเว็บไซต์ WordPress และ Android

3. ข้อผิดพลาด 503 บริการไม่พร้อมใช้งาน:

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

อ่าน: วิธีแก้ไข “บริการ HTTP Error 503 ไม่พร้อมใช้งาน”

4. ข้อผิดพลาดการหมดเวลาของเกตเวย์ 504 (ต่อ):

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

อ่าน: วิธีแก้ไขข้อผิดพลาดการหมดเวลาเกตเวย์ HTTP 504

5. ปัญหาการเปลี่ยนเส้นทาง 301 และ 302:

• สาเหตุ: ข้อผิดพลาดเหล่านี้เกิดขึ้นเมื่อมีปัญหาเกี่ยวกับการเปลี่ยนเส้นทาง URL เช่น การกำหนดค่าที่ไม่ถูกต้องหรือการวนซ้ำในกระบวนการเปลี่ยนเส้นทาง
• โซลูชั่น:

• ตรวจสอบการกำหนดค่า Nginx: ตรวจสอบไฟล์การกำหนดค่า Nginx เพื่อให้แน่ใจว่ามีการกำหนดกฎการเปลี่ยนเส้นทางอย่างถูกต้อง โดยทั่วไป ไฟล์การกำหนดค่าจะอยู่ที่ /etc/nginx/nginx.conf หรือในไฟล์แยกต่างหากภายในไดเร็กทอรี /etc/nginx/conf.d/
• ตรวจสอบการกำหนดค่าบล็อกเซิร์ฟเวอร์: ภายในไฟล์การกำหนดค่า ค้นหาบล็อกเซิร์ฟเวอร์ที่สอดคล้องกับโดเมนหรือโฮสต์เสมือนที่ได้รับผลกระทบ ตรวจสอบให้แน่ใจว่าคำสั่ง server_name ที่เหมาะสมถูกตั้งค่าเป็นชื่อโดเมนที่ถูกต้อง
• ตรวจสอบกฎการเปลี่ยนเส้นทาง: ตรวจสอบบล็อก location หรือบล็อก server ที่กำหนดกฎการเปลี่ยนเส้นทาง ตรวจสอบให้แน่ใจว่าคำสั่ง rewrite หรือ return ได้รับการกำหนดค่าอย่างถูกต้องเพื่อเปลี่ยนเส้นทางคำขอไปยังตำแหน่งที่ต้องการ ให้ความสนใจกับนิพจน์ทั่วไปและ URL ปลายทาง
• รีสตาร์ท Nginx : หลังจากทำการเปลี่ยนแปลงใดๆ กับไฟล์การกำหนดค่า คุณต้องเริ่มบริการ Nginx ใหม่เพื่อใช้การเปลี่ยนแปลง ใช้คำสั่งต่อไปนี้เพื่อรีสตาร์ท Nginx:

sudo service nginx restart

• ล้างแคชของเบราว์เซอร์ : บางครั้ง เบราว์เซอร์จะแคชการตอบสนองการเปลี่ยนเส้นทาง ล้างแคชของเบราว์เซอร์ของคุณหรือลองเข้าถึงเว็บไซต์ในหน้าต่างส่วนตัวหรือไม่ระบุตัวตนเพื่อให้แน่ใจว่าแคชไม่รบกวนการเปลี่ยนเส้นทาง
• ทดสอบการเปลี่ยนเส้นทาง : เปิดเว็บเบราว์เซอร์และลองเข้าถึง URL ที่ควรเรียกใช้การเปลี่ยนเส้นทาง ตรวจสอบว่าการเปลี่ยนเส้นทางทำงานตามที่คาดไว้และกำลังถึงปลายทางที่ต้องการ
• ตรวจสอบบันทึกข้อผิดพลาด: หากการเปลี่ยนเส้นทางยังไม่ทำงาน ให้ตรวจสอบบันทึกข้อผิดพลาด Nginx ( /var/log/nginx/error.log ) เพื่อหาข้อความแสดงข้อผิดพลาดที่เกี่ยวข้อง บันทึกสามารถให้ข้อมูลที่มีค่าในการระบุสาเหตุของปัญหา

เมื่อทำตามขั้นตอนเหล่านี้ คุณจะสามารถวินิจฉัยและแก้ไขปัญหาการเปลี่ยนเส้นทางทั่วไปใน Nginx ได้

ฉันจะแก้ไขข้อผิดพลาด NGINX ได้อย่างไร

เมื่อคุณได้เห็นข้อผิดพลาดทั่วไปของ NGINX แล้ว คุณอาจมีคำถามในใจ: 'ฉันจะแก้ไขข้อผิดพลาด NGINX ได้อย่างไร'

คำตอบนั้นไม่ยากอย่างที่คิด มีวิธีแก้ไขปัญหาต่างๆ สำหรับข้อผิดพลาด NGINX อย่างไรก็ตาม สิ่งสำคัญคือต้องทราบว่าวิธีการแก้ไขปัญหาเหล่านี้มีไว้สำหรับระยะเริ่มต้นเท่านั้น จำเป็นต้องมีการตรวจสอบเพิ่มเติมเพื่อหาสาเหตุที่แท้จริงของปัญหา

โดยทั่วไปมีสามคำสั่งที่สามารถช่วยคุณเริ่มต้นเส้นทางการแก้ไขปัญหาสำหรับข้อผิดพลาด NGINX

• รับบันทึกข้อผิดพลาดและรายละเอียดของปัญหาโดยใช้คำสั่งนี้: sudo cat /var/log/nginx/error.log
• สำหรับการตรวจสอบสถานะการใช้งานของ Nginx: sudo systemctl status nginx
• สำหรับตรวจสอบข้อผิดพลาดทางไวยากรณ์ในไฟล์ปรับแต่ง: sudo nginx -t

1. การแก้ไขปัญหาข้อผิดพลาด Nginx ด้วยบันทึกข้อผิดพลาด

เมื่อคุณพบปัญหาเกี่ยวกับ NGINX ข้อผิดพลาดส่วนใหญ่ของ NGINX เหล่านี้จะคลุมเครือ และไม่ง่ายเลยที่จะระบุปัญหาที่เกิดขึ้นจริง ข้อผิดพลาดสามารถเกิดขึ้นได้เนื่องจากปัญหาที่ใหญ่กว่าหรืออาจไม่เกี่ยวข้องกันโดยสิ้นเชิง

ทั้งหมดนี้ขึ้นอยู่กับว่าคุณกำหนดค่าการตั้งค่า NGINX อย่างไรและสถานการณ์เฉพาะที่คุณกำลังเผชิญอยู่

เพื่อให้เข้าใจข้อผิดพลาด NGINX ที่เกิดขึ้นได้ดีขึ้น คุณสามารถเรียกใช้คำสั่งเพื่อดูรายการข้อผิดพลาดเหล่านี้ได้ นี่คือคำสั่ง:

sudo cat /var/log/nginx/error.log

ในการเรียกใช้คำสั่งนี้ คุณจะต้องเป็นผู้ใช้ที่มีสิทธิ์ ขอแนะนำให้เข้าถึง sudo แทนการใช้ผู้ใช้รูท

คำสั่งนี้อนุญาตให้คุณอ่านเนื้อหาทั้งหมดของไฟล์ /var/log/nginx/error.log ซึ่งมีบันทึกข้อผิดพลาด NGINX มันจะแสดงบันทึกเหล่านี้บนหน้าต่างเทอร์มินัลของคุณ

เมื่อเรียกใช้คำสั่งนี้ คุณจะสามารถเห็นรายการข้อผิดพลาด NGINX ที่ได้รับการบันทึก อย่าลืมสิ่งหนึ่งถ้าไม่มีการบันทึกข้อผิดพลาดในบันทึก คุณจะไม่เห็นผลลัพธ์ใด ๆ เมื่อคุณรันคำสั่ง

นี่คือตัวอย่างบันทึกข้อผิดพลาดสำหรับการอ้างอิงของคุณ

2023/05/31 10:15:23 [error] 1234#0: *1 open() "/var/www/html/missing-page.html"
failed (2: No such file or directory), client: 192.168.0.1, server: example.com,
request: "GET /nonexistent-page HTTP/1.1", host: "example.com"

2023/05/31 12:45:57 [error] 1234#0: *2 upstream timed out (110: Connection timed out)
while reading response header from upstream, client: 192.168.0.2, server:
example.com, request: "GET /api/data HTTP/1.1", upstream:
"http://127.0.0.1:8000/api/data", host: "example.com"

2023/05/31 15:22:10 [error] 1234#0: *3 rewrite or internal redirection cycle while internally redirecting to "/index.php", client: 192.168.0.3, server: example.com, request: "GET /category/products/ HTTP/1.1", host: "example.com"

ในตัวอย่างนี้ แต่ละบรรทัดแสดงข้อผิดพลาดแยกต่างหากที่บันทึกโดย NGINX มาแบ่งข้อมูลที่ให้ไว้:

• การประทับเวลา: ส่วนแรกของแต่ละบรรทัดแสดงวันที่และเวลาที่ข้อผิดพลาดเกิดขึ้น โดยมีรูปแบบเป็น YYYY/MM/DD HH:MM:SS
• ระดับข้อผิดพลาด: แท็ก [error] ระบุว่าบรรทัดนี้แสดงถึงข้อผิดพลาด
• รหัสกระบวนการ: ตัวเลขหลังสัญลักษณ์ # (เช่น 1234#0 ) แสดงถึงรหัสกระบวนการ NGINX ที่จัดการคำขอ
• ข้อความแสดงข้อผิดพลาด: ข้อความแสดงข้อผิดพลาดแสดงรายละเอียดเกี่ยวกับข้อผิดพลาดเฉพาะ ซึ่งจะรวมถึงข้อมูลต่างๆ เช่น ความล้มเหลวในการเข้าถึงไฟล์หรือทรัพยากร การหมดเวลาการเชื่อมต่ออัปสตรีม หรือปัญหาการเปลี่ยนเส้นทางภายใน
• IP ไคลเอนต์: ฟิลด์ client แสดงที่อยู่ IP ของไคลเอ็นต์ที่ส่งคำขอไปยังเซิร์ฟเวอร์
• ชื่อเซิร์ฟเวอร์: ฟิลด์ server ระบุชื่อเซิร์ฟเวอร์หรือโฮสต์เสมือนที่เกิดข้อผิดพลาด
• รายละเอียดคำขอ: ฟิลด์ request แสดงเมธอด HTTP, URL ที่ร้องขอ และเวอร์ชันของโปรโตคอลที่ไคลเอนต์ใช้
• โฮสต์: ช่อง host ระบุชื่อโฮสต์หรือที่อยู่ IP ที่ใช้ในการร้องขอ

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

2. การแก้ไขปัญหา NGINX โดยการตรวจสอบสถานะ

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

ในการตรวจสอบสถานะบริการ NGINX ให้ใช้คำสั่งต่อไปนี้:

sudo systemctl status nginx

หากบริการ NGINX ทำงานอยู่ ผลลัพธ์จะเป็นดังนี้

nginx.service - The NGINX HTTP and reverse proxy server
Loaded: loaded (/lib/systemd/system/nginx.service; enabled; vendor preset:
enabled)
Active: active (running) since Mon 2023-05-31 14:30:00 UTC; 5min ago
Docs: http://nginx.org/en/docs/
Process: 1234 ExecStart=/usr/sbin/nginx -g daemon on;
master_process on;
(code=exited, status=0/SUCCESS)
Main PID: 1234 (nginx)
Tasks: 2 (limit: 2319)
Memory: 3.9M
CGroup: /system.slice/nginx.service
├─1234 nginx: master process /usr/sbin/nginx -g daemon on; master_process on;
└─5678 nginx: worker process

และหากสถานะ NGINX ไม่ทำงาน เอาต์พุตของ สถานะ sudo systemctl nginx คำสั่งจะระบุว่าบริการไม่ได้ใช้งานหรือหยุดทำงานดังนี้

nginx.service - The NGINX HTTP and reverse proxy server
Loaded: loaded (/lib/systemd/system/nginx.service; enabled; vendor preset: enabled)
Active: inactive (dead)
Docs: http://nginx.org/en/docs/

หากเป็นเช่นนั้น สิ่งเดียวที่คุณต้องทำคือเริ่มบริการ NGINX ใหม่โดยใช้คำสั่งนี้:

sudo systemctl restart nginx

หลังจากนั้นคุณสามารถใช้คำสั่งสถานะอีกครั้งเพื่อตรวจสอบว่าบริการ NGINX เปิดใช้งานอยู่หรือไม่

3. การแก้ไขปัญหา NGINX โดยการตรวจสอบข้อผิดพลาดทางไวยากรณ์

ข้อผิดพลาดทางไวยากรณ์เป็นปัญหาทั่วไปที่สามารถเกิดขึ้นได้เมื่อเขียนสคริปต์ โค้ด หรือกำหนดค่าไฟล์ Nginx

ไม่ว่าคุณจะใช้โครงสร้างไวยากรณ์ที่ไม่ถูกต้องหรือละเว้นอักขระบางตัว ไวยากรณ์ที่ไม่ถูกต้องจะทำให้โค้ดหรือการกำหนดค่าทำงานไม่ถูกต้อง

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

หากต้องการตรวจสอบข้อผิดพลาดทางไวยากรณ์ในไฟล์การกำหนดค่า Nginx ของคุณ ให้ใช้คำสั่งต่อไปนี้

sudo nginx -t

หากไวยากรณ์ถูกต้องผลลัพธ์จะเป็น

nginx: configuration file /etc/nginx/nginx.conf test is successful

อย่างไรก็ตาม หากมีปัญหาในไวยากรณ์ ผลลัพธ์จะแสดงเป็น

nginx: [emerg] unexpected end of file, expecting ";" or "}" in
/etc/nginx/nginx.conf:42
nginx: configuration file /etc/nginx/nginx.conf test failed

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

หมายเหตุ: เราขอแนะนำให้รันคำสั่งไวยากรณ์นี้เพื่อตรวจสอบข้อผิดพลาดในไฟล์การกำหนดค่า Nginx ของคุณและตรวจสอบให้แน่ใจว่าไม่มีสิ่งใดขาดหายไป

สรุป

โดยสรุป ข้อผิดพลาด Nginx อาจเกิดขึ้นขณะใช้เว็บเซิร์ฟเวอร์ Nginx ทำให้เว็บไซต์หรือเว็บแอปพลิเคชันของคุณหยุดชะงัก ข้อผิดพลาดเหล่านี้มาในรูปแบบต่างๆ รวมถึงข้อผิดพลาด 502 Bad Gateway, ข้อผิดพลาด 404 Not Found, ข้อผิดพลาด 503 Service Unavailable, ข้อผิดพลาด 504 Gateway Timeout และข้อผิดพลาดในการเปลี่ยนเส้นทาง (301 และ 302)

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

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

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

คำถามที่พบบ่อย