1. Giới thiệu
Trong bài viết này, chúng ta sẽ khám phá cách xử lý lỗi và ngoại lệ một cách an toàn trong các ứng dụng Node.js Express. Chúng ta sẽ thảo luận về các loại lỗi khác nhau, các phương pháp hay nhất để xử lý lỗi cũng như cách xử lý các lỗi và ngoại lệ cụ thể. Đến cuối bài viết này, bạn sẽ hiểu sâu về xử lý lỗi trong Express và cách tạo các ứng dụng mạnh mẽ và an toàn.
1.1 Các loại lỗi trong Node.js
Có ba loại lỗi chính trong Node.js:
- Lỗi cú pháp: Lỗi này xảy ra khi có lỗi trong cú pháp mã, chẳng hạn như dấu ngoặc nhọn bị thiếu hoặc dấu chấm phẩy được đặt không chính xác.
- Lỗi thời gian chạy: Những lỗi này xảy ra trong quá trình thực thi mã, chẳng hạn như cố gắng truy cập một biến không xác định hoặc gọi một hàm không tồn tại.
- Lỗi logic: Đây là những lỗi trong logic mã gây ra kết quả hoặc hành vi không chính xác, mặc dù cú pháp và thời gian chạy không có lỗi.
1.2 Xử lý lỗi nhanh
Express là một khung ứng dụng web mạnh mẽ và linh hoạt dành cho Node.js. Nó được thiết kế để xử lý các lỗi và ngoại lệ một cách khéo léo, cung cấp cho các nhà phát triển các công cụ để tạo ra các ứng dụng mạnh mẽ. Express sử dụng các chức năng của phần mềm trung gian để quản lý luồng các đối tượng yêu cầu và phản hồi thông qua ứng dụng. Các chức năng phần mềm trung gian này có thể được sử dụng để xử lý lỗi, đảm bảo rằng mọi lỗi xảy ra đều được nắm bắt và xử lý chính xác.
2. Thực tiễn tốt nhất để xử lý lỗi trong Express
Trước khi đi sâu vào các kỹ thuật xử lý lỗi cụ thể, chúng ta hãy thảo luận về một số phương pháp hay nhất nên tuân theo khi xử lý lỗi trong ứng dụng Express.
2.1 Sử dụng Middleware xử lý lỗi tập trung
Tập trung xử lý lỗi trong một chức năng phần mềm trung gian duy nhất là một phương pháp hay vì nó cho phép bạn quản lý lỗi một cách nhất quán trong ứng dụng của mình. Sau đó, bạn có thể xử lý lỗi ở một nơi duy nhất, giúp việc bảo trì và cập nhật mã xử lý lỗi của bạn trở nên dễ dàng hơn.
2.2 Nhật ký lỗi
Ghi nhật ký lỗi là điều cần thiết để chẩn đoán và khắc phục sự cố có thể phát sinh trong ứng dụng của bạn. Đảm bảo ghi lại cả thông báo lỗi và bất kỳ thông tin bổ sung nào có thể hữu ích cho việc gỡ lỗi.
2.3 Không tiết lộ thông tin nhạy cảm
Khi phản hồi lỗi cho khách hàng, điều quan trọng là không để lộ thông tin nhạy cảm về ứng dụng hoặc máy chủ của bạn. Điều này có thể giúp ngăn chặn các lỗ hổng bảo mật tiềm ẩn. Thay vào đó, hãy cung cấp một thông báo lỗi chung chung không tiết lộ các chi tiết cụ thể của lỗi hoặc hoạt động nội bộ của ứng dụng của bạn.
2.4 Sử dụng mã trạng thái HTTP thích hợp
Sử dụng mã trạng thái HTTP chính xác khi phản hồi lỗi là điều cần thiết để cung cấp trải nghiệm người dùng nhất quán và nhiều thông tin. Đảm bảo rằng ứng dụng của bạn trả về mã trạng thái phù hợp dựa trên loại lỗi đã xảy ra.
3. Xử lý các lỗi và ngoại lệ cụ thể trong Express
Bây giờ chúng ta đã thảo luận về các phương pháp hay nhất để xử lý lỗi trong Express, hãy đi sâu vào xử lý các lỗi và ngoại lệ cụ thể.
3.1 Xử lý lỗi 404 Not Found
Lỗi 404 Not Found xảy ra khi không tìm thấy tài nguyên được yêu cầu trên máy chủ. Để xử lý những lỗi này, hãy thêm chức năng phần mềm trung gian vào cuối tuyến đường của bạn để nắm bắt mọi yêu cầu không khớp với bất kỳ tuyến đường nào đã xác định:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 | app <span class="token punctuation">.</span> <span class="token function">use</span> <span class="token punctuation">(</span> <span class="token punctuation">(</span> <span class="token parameter">req <span class="token punctuation">,</span> res <span class="token punctuation">,</span> next</span> <span class="token punctuation">)</span> <span class="token operator">=></span> <span class="token punctuation">{</span> res <span class="token punctuation">.</span> <span class="token function">status</span> <span class="token punctuation">(</span> <span class="token number">404</span> <span class="token punctuation">)</span> <span class="token punctuation">.</span> <span class="token function">send</span> <span class="token punctuation">(</span> <span class="token string">'Resource not found'</span> <span class="token punctuation">)</span> <span class="token punctuation">;</span> <span class="token punctuation">}</span> <span class="token punctuation">)</span> <span class="token punctuation">;</span> <span class="token number">3.2</span> Handling Syntax Errors Syntax errors can be caught by adding a middleware <span class="token keyword">function</span> that listens <span class="token keyword">for</span> the SyntaxError event <span class="token operator">:</span> javascript Copy code app <span class="token punctuation">.</span> <span class="token function">use</span> <span class="token punctuation">(</span> <span class="token punctuation">(</span> <span class="token parameter">err <span class="token punctuation">,</span> req <span class="token punctuation">,</span> res <span class="token punctuation">,</span> next</span> <span class="token punctuation">)</span> <span class="token operator">=></span> <span class="token punctuation">{</span> <span class="token keyword">if</span> <span class="token punctuation">(</span> err <span class="token keyword">instanceof</span> <span class="token class-name">SyntaxError</span> <span class="token punctuation">)</span> <span class="token punctuation">{</span> res <span class="token punctuation">.</span> <span class="token function">status</span> <span class="token punctuation">(</span> <span class="token number">400</span> <span class="token punctuation">)</span> <span class="token punctuation">.</span> <span class="token function">send</span> <span class="token punctuation">(</span> <span class="token string">'Bad Request'</span> <span class="token punctuation">)</span> <span class="token punctuation">;</span> <span class="token punctuation">}</span> <span class="token keyword">else</span> <span class="token punctuation">{</span> <span class="token function">next</span> <span class="token punctuation">(</span> err <span class="token punctuation">)</span> <span class="token punctuation">;</span> <span class="token punctuation">}</span> <span class="token punctuation">}</span> <span class="token punctuation">)</span> <span class="token punctuation">;</span> |
3.3 Xử lý lỗi thời gian chạy
Các lỗi thời gian chạy có thể được phát hiện bằng cách sử dụng kết hợp các khối thử bắt và các chức năng phần mềm trung gian xử lý lỗi. Khi sử dụng các khối try-catch, hãy đảm bảo rằng bạn chuyển lỗi bắt được sang hàm next() để phần mềm trung gian xử lý lỗi có thể xử lý lỗi này:
1 2 3 4 5 6 7 8 | app <span class="token punctuation">.</span> <span class="token function">get</span> <span class="token punctuation">(</span> <span class="token string">'/route'</span> <span class="token punctuation">,</span> <span class="token keyword">async</span> <span class="token punctuation">(</span> <span class="token parameter">req <span class="token punctuation">,</span> res <span class="token punctuation">,</span> next</span> <span class="token punctuation">)</span> <span class="token operator">=></span> <span class="token punctuation">{</span> <span class="token keyword">try</span> <span class="token punctuation">{</span> <span class="token comment">// Your code here</span> <span class="token punctuation">}</span> <span class="token keyword">catch</span> <span class="token punctuation">(</span> err <span class="token punctuation">)</span> <span class="token punctuation">{</span> <span class="token function">next</span> <span class="token punctuation">(</span> err <span class="token punctuation">)</span> <span class="token punctuation">;</span> <span class="token punctuation">}</span> <span class="token punctuation">}</span> <span class="token punctuation">)</span> <span class="token punctuation">;</span> |
Trong phần mềm trung gian xử lý lỗi, bạn có thể xác định loại lỗi và phản hồi tương ứng:
1 2 3 4 5 6 7 8 | app <span class="token punctuation">.</span> <span class="token function">use</span> <span class="token punctuation">(</span> <span class="token punctuation">(</span> <span class="token parameter">err <span class="token punctuation">,</span> req <span class="token punctuation">,</span> res <span class="token punctuation">,</span> next</span> <span class="token punctuation">)</span> <span class="token operator">=></span> <span class="token punctuation">{</span> <span class="token keyword">if</span> <span class="token punctuation">(</span> err <span class="token punctuation">.</span> name <span class="token operator">===</span> <span class="token string">'TypeError'</span> <span class="token punctuation">)</span> <span class="token punctuation">{</span> res <span class="token punctuation">.</span> <span class="token function">status</span> <span class="token punctuation">(</span> <span class="token number">500</span> <span class="token punctuation">)</span> <span class="token punctuation">.</span> <span class="token function">send</span> <span class="token punctuation">(</span> <span class="token string">'Internal Server Error'</span> <span class="token punctuation">)</span> <span class="token punctuation">;</span> <span class="token punctuation">}</span> <span class="token keyword">else</span> <span class="token punctuation">{</span> <span class="token function">next</span> <span class="token punctuation">(</span> err <span class="token punctuation">)</span> <span class="token punctuation">;</span> <span class="token punctuation">}</span> <span class="token punctuation">}</span> <span class="token punctuation">)</span> <span class="token punctuation">;</span> |
3.4 Xử lý lỗi logic
Việc xử lý các lỗi logic mang tính cụ thể hơn cho từng ứng dụng và sẽ phụ thuộc vào logic cụ thể của ứng dụng của bạn. Nói chung, nên xác thực dữ liệu đầu vào và xử lý mọi vấn đề có thể phát sinh do dữ liệu không chính xác. Ví dụ: bạn có thể sử dụng thư viện xác thực như Joi để xác thực dữ liệu đầu vào và trả về thông báo lỗi thích hợp cho máy khách:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 | <span class="token keyword">const</span> Joi <span class="token operator">=</span> <span class="token function">require</span> <span class="token punctuation">(</span> <span class="token string">'joi'</span> <span class="token punctuation">)</span> <span class="token punctuation">;</span> <span class="token keyword">const</span> schema <span class="token operator">=</span> Joi <span class="token punctuation">.</span> <span class="token function">object</span> <span class="token punctuation">(</span> <span class="token punctuation">{</span> name <span class="token operator">:</span> Joi <span class="token punctuation">.</span> <span class="token function">string</span> <span class="token punctuation">(</span> <span class="token punctuation">)</span> <span class="token punctuation">.</span> <span class="token function">required</span> <span class="token punctuation">(</span> <span class="token punctuation">)</span> <span class="token punctuation">,</span> age <span class="token operator">:</span> Joi <span class="token punctuation">.</span> <span class="token function">number</span> <span class="token punctuation">(</span> <span class="token punctuation">)</span> <span class="token punctuation">.</span> <span class="token function">integer</span> <span class="token punctuation">(</span> <span class="token punctuation">)</span> <span class="token punctuation">.</span> <span class="token function">required</span> <span class="token punctuation">(</span> <span class="token punctuation">)</span> <span class="token punctuation">,</span> <span class="token punctuation">}</span> <span class="token punctuation">)</span> <span class="token punctuation">;</span> app <span class="token punctuation">.</span> <span class="token function">post</span> <span class="token punctuation">(</span> <span class="token string">'/route'</span> <span class="token punctuation">,</span> <span class="token keyword">async</span> <span class="token punctuation">(</span> <span class="token parameter">req <span class="token punctuation">,</span> res <span class="token punctuation">,</span> next</span> <span class="token punctuation">)</span> <span class="token operator">=></span> <span class="token punctuation">{</span> <span class="token keyword">try</span> <span class="token punctuation">{</span> <span class="token keyword">const</span> validatedData <span class="token operator">=</span> <span class="token keyword">await</span> schema <span class="token punctuation">.</span> <span class="token function">validateAsync</span> <span class="token punctuation">(</span> req <span class="token punctuation">.</span> body <span class="token punctuation">)</span> <span class="token punctuation">;</span> <span class="token comment">// Your code here</span> <span class="token punctuation">}</span> <span class="token keyword">catch</span> <span class="token punctuation">(</span> err <span class="token punctuation">)</span> <span class="token punctuation">{</span> <span class="token keyword">if</span> <span class="token punctuation">(</span> err <span class="token keyword">instanceof</span> <span class="token class-name">Joi <span class="token punctuation">.</span> ValidationError</span> <span class="token punctuation">)</span> <span class="token punctuation">{</span> res <span class="token punctuation">.</span> <span class="token function">status</span> <span class="token punctuation">(</span> <span class="token number">400</span> <span class="token punctuation">)</span> <span class="token punctuation">.</span> <span class="token function">send</span> <span class="token punctuation">(</span> <span class="token string">'Bad Request'</span> <span class="token punctuation">)</span> <span class="token punctuation">;</span> <span class="token punctuation">}</span> <span class="token keyword">else</span> <span class="token punctuation">{</span> <span class="token function">next</span> <span class="token punctuation">(</span> err <span class="token punctuation">)</span> <span class="token punctuation">;</span> <span class="token punctuation">}</span> <span class="token punctuation">}</span> <span class="token punctuation">}</span> <span class="token punctuation">)</span> <span class="token punctuation">;</span> |
3.5 Xử lý từ chối lời hứa
Việc từ chối lời hứa chưa được xử lý có thể dẫn đến hành vi không mong muốn và các vấn đề bảo mật tiềm ẩn. Điều quan trọng là xử lý các lời hứa bị từ chối một cách chính xác. Bạn có thể sử dụng phương thức catch() cho các lời hứa hoặc sử dụng try-catch với async-await như trong các ví dụ trước. Ngoài ra, bạn có thể lắng nghe sự kiện unhandledRejection trên đối tượng process để nắm bắt bất kỳ lời từ chối lời hứa chưa được xử lý nào trong ứng dụng của bạn:
1 2 3 4 5 | process <span class="token punctuation">.</span> <span class="token function">on</span> <span class="token punctuation">(</span> <span class="token string">'unhandledRejection'</span> <span class="token punctuation">,</span> <span class="token punctuation">(</span> <span class="token parameter">reason <span class="token punctuation">,</span> promise</span> <span class="token punctuation">)</span> <span class="token operator">=></span> <span class="token punctuation">{</span> console <span class="token punctuation">.</span> <span class="token function">error</span> <span class="token punctuation">(</span> <span class="token string">'Unhandled Rejection:'</span> <span class="token punctuation">,</span> reason <span class="token punctuation">)</span> <span class="token punctuation">;</span> <span class="token comment">// You can perform additional actions here, such as logging the error or notifying a monitoring service</span> <span class="token punctuation">}</span> <span class="token punctuation">)</span> <span class="token punctuation">;</span> |
Phần kết luận
Xử lý lỗi và ngoại lệ một cách an toàn trong các ứng dụng Node.js Express là điều cần thiết để tạo các ứng dụng mạnh mẽ và an toàn. Bằng cách làm theo các phương pháp hay nhất, chẳng hạn như xử lý lỗi tập trung, ghi nhật ký lỗi và sử dụng mã trạng thái HTTP phù hợp, bạn có thể đảm bảo trải nghiệm người dùng nhất quán và nhiều thông tin. Ngoài ra, hiểu cách xử lý các lỗi và ngoại lệ cụ thể, chẳng hạn như 404 Not Found, lỗi cú pháp, lỗi thời gian chạy, lỗi logic và từ chối lời hứa, sẽ cho phép bạn xây dựng một ứng dụng an toàn và đáng tin cậy.
Bằng cách áp dụng các kỹ thuật và phương pháp hay nhất được thảo luận trong bài viết này, bạn sẽ được trang bị đầy đủ để xử lý các lỗi và ngoại lệ một cách an toàn trong các ứng dụng Node.js Express của mình, giúp bạn tạo ra các ứng dụng linh hoạt và đáng tin cậy hơn.
Và cuối cùng
Như mọi khi, tôi hy vọng bạn thích bài viết này và có một cái gì đó mới. Xin cảm ơn và hẹn gặp lại các bạn trong những bài viết tiếp theo!
Nếu các bạn thích bài viết này thì hãy cho mình 1 like và subscribe để ủng hộ mình nhé. Cảm ơn.