ERR_HTTP2_PROTOCOL_ERROR: nguyên nhân và cách khắc phục

ERR_HTTP2_PROTOCOL_ERROR là gì?

ERR_HTTP2_PROTOCOL_ERROR là lỗi trên Chrome và Edge, cho biết luồng HTTP/2 chứa trang đã thất bại: máy chủ đã reset luồng trước khi hoàn tất hoặc gửi các header mà trình duyệt từ chối. Trong Chromium, đây là mã lỗi mạng -337: "There is an HTTP/2 protocol error" (net_error_list.h). Chrome không có trang lỗi riêng cho nó, nên bạn sẽ thấy trang chung: "Không thể truy cập trang web này" cùng dòng "Trang web tại … có thể tạm thời không hoạt động hay được chuyển vĩnh viễn sang địa chỉ web mới", với ERR_HTTP2_PROTOCOL_ERROR bên dưới. Edge hiển thị cùng mã lỗi trên màn hình riêng của nó, "Hmm… can't reach this page".

HTTP/2 là phiên bản HTTP nhanh hơn mà hầu hết các trang HTTPS hiện nay đều sử dụng. Mỗi yêu cầu đi trong một luồng (stream) riêng bên trong một kết nối duy nhất, và cả hai phía đều có thể hủy một luồng bằng cách reset. Chrome báo mọi lần reset từ máy chủ là lỗi giao thức, bất kể lý do reset là gì, và tự hủy luồng khi header vi phạm quy tắc của HTTP/2 (header Transfer-Encoding, chữ in hoa trong tên header, thiếu trạng thái).

Lập trình viên thường thấy lỗi này trong console của DevTools dưới dạng net::ERR_HTTP2_PROTOCOL_ERROR 200 (OK). Sự kết hợp đó là một manh mối rõ ràng: header hợp lệ và máy chủ đã trả lời 200, nhưng luồng bị lỗi trong lúc phần thân đang đến.

Những gì HTTP/2 coi là sai định dạng

Chuẩn HTTP/2 (RFC 9113) liệt kê các lỗi khiến một phản hồi bị coi là sai định dạng. Đây là những vấn đề đứng sau hầu hết các lỗi trong thực tế, cùng cách mỗi lỗi đến được trình duyệt:

Nguyên nhân gây ra lỗi ERR_HTTP2_PROTOCOL_ERROR

Hầu hết các trường hợp đến từ phía máy chủ, nhưng một vài thứ trên chính máy tính của bạn cũng có thể làm hỏng phản hồi trên đường đến:

• Trên máy chủ: phản hồi mà máy chủ hoặc proxy không hoàn tất được (proxy hết dung lượng ổ đĩa hoặc không ghi được tệp tạm, ứng dụng bị crash khi đang truyền dữ liệu, hết thời gian chờ), giá trị Content-Length sai khiến proxy phía trước bỏ cuộc, header bị cấm hoặc không hợp lệ, và hỗ trợ HTTP/2 bị lỗi trong cấu hình máy chủ hoặc CDN cũ.
• Ở phía bạn: phần mềm diệt virus hoặc tường lửa kiểm tra HTTPS và viết lại lưu lượng, tiện ích mở rộng của trình duyệt sửa đổi yêu cầu hoặc phản hồi, một yêu cầu mà máy chủ xử lý sai (ví dụ cookie quá lớn), và đôi khi là phiên bản Chrome đã lỗi thời.

Cách 1: tải lại cứng và thử chế độ ẩn danh

Nhấn Ctrl + Shift + R (Mac: Cmd + Shift + R) để tải lại mà không dùng bộ nhớ đệm. Một phản hồi bị cắt một lần có thể đến bình thường trong lần thử tiếp theo.

Sau đó mở trang trong cửa sổ Ẩn danh (Ctrl + Shift + N, Mac Cmd + Shift + N). Chế độ Ẩn danh không có cookie, không có bộ nhớ đệm từ hồ sơ thông thường của bạn, và tiện ích mở rộng mặc định bị tắt. Nếu trang tải được ở đó, Cách 2 hoặc Cách 3 sẽ giải quyết vấn đề trong cửa sổ thông thường.

Cách 2: xóa cookie và tệp đã lưu của trang web đó

Xóa cookie và tệp đã lưu của trang sẽ thay đổi yêu cầu mà Chrome gửi đi (ít cookie hơn, không có bản sao trong bộ nhớ đệm để xác thực lại), và có thể né được lỗi của máy chủ. Nhấp vào biểu tượng Xem thông tin trang web ở bên trái thanh địa chỉ → Cookie và dữ liệu trang web → Quản lý dữ liệu trang web trên thiết bị → xóa dữ liệu, rồi tải lại. Để dọn dẹp rộng hơn, nhấn Ctrl + Shift + Delete và xóa Tệp và hình ảnh được lưu trong bộ nhớ đệm trong khoảng 7 ngày qua.

Cách 3: tạm dừng quét HTTPS của phần mềm diệt virus và tiện ích mở rộng

Phần mềm bảo mật giải mã và kiểm tra HTTPS nằm ở giữa mọi kết nối HTTP/2. Nếu cách nó xử lý HTTP/2 bị lỗi hoặc đã lỗi thời, nó có thể làm hỏng luồng hoặc chuyển tiếp những header mà Chrome từ chối. Chỉ tắt tính năng quét HTTPS (Avast/AVG: Web Shield → "Enable HTTPS scanning"; ESET: "SSL/TLS protocol filtering"; Kaspersky: "Scan encrypted connections") rồi tải lại. Nếu cách đó khắc phục được, hãy cập nhật phần mềm diệt virus và thêm ngoại lệ cho trang web.

Tiếp theo, tắt tất cả tiện ích mở rộng tại chrome://extensions, tải lại, rồi bật lại từng cái một. Trình chặn quảng cáo, công cụ bảo vệ quyền riêng tư và bất cứ thứ gì chỉnh sửa header là những nghi phạm thường gặp.

Cách 4: cập nhật Chrome và kiểm tra trên trình duyệt khác

Mở chrome://settings/help để cài đặt bản cập nhật đang chờ, sau đó khởi động lại trình duyệt. Rồi mở cùng trang đó trên Firefox hoặc Safari, cũng như trên một thiết bị hoặc mạng khác. Nếu trang lỗi ở mọi nơi, trang web đang bị hỏng và chỉ chủ trang mới khắc phục được (quét HTTPS của phần mềm diệt virus ảnh hưởng đến mọi trình duyệt trên cùng một máy, nên phép thử thực sự là thiết bị thứ hai). Nếu chỉ Chrome hoặc Edge bị lỗi, nhiều khả năng trang web đang gửi một header mà Chrome từ chối; Cách 2 và Cách 3 vẫn đáng để thử lại.

Cách 5: kiểm tra trang khi không dùng HTTP/2

Chrome có thể được khởi động với HTTP/2 (và HTTP/3) bị tắt, giúp bạn biết HTTP/2 có liên quan hay không. Hãy khởi động một Chrome thứ hai, riêng biệt từ terminal; thư mục hồ sơ bổ sung khiến nó trở thành một phiên bản mới ngay cả khi Chrome thông thường của bạn đang mở:

# Windows (Command Prompt)
"C:\Program Files\Google\Chrome\Application\chrome.exe" --user-data-dir="%TEMP%\h2test" --disable-http2 --disable-quic

# macOS (Terminal)
open -na "Google Chrome" --args --user-data-dir=/tmp/h2test --disable-http2 --disable-quic

Nếu trang tải được trong cửa sổ đó, phản hồi HTTP/2 của trang web đang có vấn đề và chủ trang cần khắc phục. Nếu giờ nó lỗi với ERR_CONTENT_LENGTH_MISMATCH hoặc ERR_INCOMPLETE_CHUNKED_ENCODING, máy chủ đang cắt cụt phản hồi bất kể giao thức nào. Hãy đóng cửa sổ đó khi xong việc; Chrome thông thường của bạn không bị ảnh hưởng.

Dành cho chủ website: khắc phục lỗi giao thức HTTP/2

Nếu khách truy cập trên nhiều mạng và trình duyệt khác nhau đều báo lỗi, vấn đề nằm trong hệ thống của bạn. Ba bước kiểm tra sau tìm ra gần như tất cả nguyên nhân.

1. Tái hiện lỗi bằng curl

# HTTP/2: watch the end of the output
curl -sv --http2 https://example.com/broken-page -o /dev/null
# A stream the server gave up on ends with something like:
# HTTP/2 stream 1 was not closed cleanly: INTERNAL_ERROR (err 2)
# (curl 8.19+: HTTP/2 stream 1 reset by server (error 0x2 INTERNAL_ERROR);
#  "reset by curl" means curl rejected the response itself)

# Same URL over HTTP/1.1 for comparison
curl -sv --http1.1 https://example.com/broken-page -o /dev/null

Nếu HTTP/1.1 hoạt động còn HTTP/2 thất bại, HTTP/2 có liên quan. "Reset by server" cho thấy máy chủ hoặc một proxy đã bỏ cuộc giữa chừng phản hồi. curl không kiểm tra chính xác những gì Chrome kiểm tra (nó từ chối Content-Length không khớp và các header kết nối mà Chrome cho qua), nên hãy coi đây là gợi ý mạnh chứ không phải bằng chứng. Công cụ Kiểm tra HTTP Header liệt kê các header mà ứng dụng của bạn đặt, khi nhìn từ bên ngoài mạng của bạn.

2. Kiểm tra phản hồi bị cắt giữa chừng

Nguyên nhân phổ biến nhất ở phía máy chủ là phản hồi đã bắt đầu (trạng thái 200, header đã gửi) rồi không thể hoàn tất. nginx lưu tạm các phản hồi lớn từ ứng dụng của bạn vào tệp tạm, và nếu ổ đĩa đầy hoặc nginx không ghi được vào thư mục tạm, nó sẽ reset luồng và trình duyệt báo lỗi giao thức. Hãy kiểm tra:

df -h                                   # is any disk full?
sudo grep -E "No space left|Permission denied" /var/log/nginx/error.log | tail
ls -ld /var/lib/nginx/proxy /var/lib/nginx/fastcgi   # Debian/Ubuntu packages
ls -ld /var/cache/nginx/proxy_temp /var/cache/nginx/fastcgi_temp   # nginx.org packages
# the temp folders must be writable by the nginx worker user

Hãy kiểm tra cả bản thân ứng dụng: một tiến trình PHP hoặc Node bị crash, hết thời gian chờ hoặc chạm giới hạn bộ nhớ trong khi truyền một trang hay tệp tải xuống lớn cũng tạo ra kết quả tương tự. Log của ứng dụng quanh thời điểm xảy ra lỗi thường cho thấy điều đó.

3. Sửa Content-Length và các header bị cấm

• Content-Length: hãy để máy chủ tự tính. Đừng tự đặt giá trị này trong mã ứng dụng nếu một plugin, middleware hoặc máy chủ web cũng nén hoặc sửa đổi đầu ra, vì khi đó độ dài khai báo sẽ không còn khớp với số byte được gửi. Độ dài được đặt trong mã PHP trong khi một plugin hoặc thiết lập PHP cũng nén đầu ra là một cách điều này xảy ra trên các trang WordPress.
• Transfer-Encoding: đừng bao giờ gửi nó trong phản hồi HTTP/2; Chrome reset luồng khi thấy header này. RFC 9113 cũng cấm Connection, Keep-Alive, Proxy-Connection và Upgrade. Chrome bỏ qua chúng, nhưng curl và các client nghiêm ngặt khác từ chối, và nginx tự loại bỏ phần lớn chúng khỏi các phản hồi được proxy.
• Giá trị header: đảm bảo không header nào chứa ký tự xuống dòng hoặc ký tự điều khiển. Điều này thường đến từ dữ liệu người dùng nhập được đặt vào header, chẳng hạn tên tệp trong Content-Disposition.
• CDN phía trước: nếu bạn dùng Cloudflare hoặc CDN khác, hãy kiểm tra trực tiếp máy chủ gốc (bằng curl --resolve hoặc một mục trong tệp hosts) để biết lỗi đến từ máy chủ gốc hay từ CDN.

ERR_HTTP2_PROTOCOL_ERROR khác gì các lỗi tương tự

Hướng dẫn chi tiết: ERR_QUIC_PROTOCOL_ERROR, ERR_SSL_PROTOCOL_ERROR, ERR_CONNECTION_CLOSED và ERR_EMPTY_RESPONSE. Để kiểm tra chứng chỉ và thiết lập HTTPS của một trang web từ bên ngoài, hãy dùng Kiểm tra chứng chỉ SSL.