Danh mục lỗi thời gian chạy

Bạn đang xem tài liệu về Apigee Edge.
Truy cập vào tài liệu về Apigee X. thông tin

Lỗi trong ứng dụng Apigee Edge

Khi các yêu cầu API được gửi qua Apigee Edge, các thành phần của Bộ định tuyến và Bộ xử lý tin nhắn Apigee Edge hoặc các máy chủ phụ trợ có thể trả về lỗi cho các ứng dụng khách.

Lỗi từ Trình xử lý thông báo

Trình xử lý thông báo là thành phần cốt lõi của Apigee Edge, xử lý các chính sách và tương tác với máy chủ phụ trợ. Phương thức này có thể trả về lỗi nếu phát hiện thấy bất kỳ vấn đề nào, chẳng hạn như:

  • Vấn đề về khả năng kết nối mạng, không bắt tay được TLS, không có máy chủ phụ trợ, không có phản hồi trong quá trình giao tiếp với máy chủ phụ trợ
  • Lỗi trong quá trình thực thi chính sách
  • Tiêu đề HTTP, phương thức mã hoá, đường dẫn không hợp lệ, không tuân thủ thông số kỹ thuật HTTP, vượt quá giới hạn về sản phẩm, v.v.:
    • Với yêu cầu HTTP do ứng dụng khách gửi

      • HOẶC

    • Có phản hồi HTTP do máy chủ phụ trợ gửi
  • Và nhiều nội dung khác nữa

Lỗi mẫu từ Trình xử lý thông báo

Trình xử lý thông báo luôn trả về mã trạng thái HTTP, theo sau là thông báo lỗi cùng với mã lỗi ở định dạng JSON như dưới đây:

Ứng dụng khách sẽ nhận được mã phản hồi như ví dụ sau: 

HTTP/1.1 414 Request-URI Too Long

Phản hồi lỗi từ Trình xử lý thông báo sẽ xuất hiện ở định dạng sau: 

{
   "fault":{
      "faultstring":"request line size exceeding 7,168",
      "detail":{
         "errorcode":"protocol.http.TooBigLine"
      }
   }
}

Mô tả các trường trong phản hồi lỗi:

Trường Mô tả
faultstring Chứa thông báo lỗi mô tả nguyên nhân có thể gây ra lỗi
errorcode Mã lỗi (còn gọi là mã lỗi) liên kết với lỗi

Danh mục lỗi thời gian chạy

Danh mục lỗi này cung cấp tất cả thông tin bạn cần biết về mã lỗi thời gian chạy (đối với lỗi không phải lỗi chính sách) do thành phần Bộ xử lý thông báo Apigee Edge trả về. Trong đó có các thông tin sau cho từng mã lỗi:

  • Mã trạng thái HTTP
  • Thông báo lỗi
  • Nguyên nhân có thể gây ra lỗi
  • Mọi thông số kỹ thuật HTTP và/hoặc giới hạn sản phẩm có liên quan
  • Sách hướng dẫn và video chứa hướng dẫn chẩn đoán nguyên nhân gây ra lỗi và các giải pháp hiệu quả mà bạn có thể áp dụng để tự khắc phục lỗi (nếu có)
  • Cách khắc phục mà bạn có thể áp dụng để tự khắc phục lỗi

Bài viết này đề cập đến các danh mục mã lỗi sau:

Sử dụng hộp Tìm kiếm ở bên dưới để lọc bảng nhằm hiển thị thông tin ở trên cho một mã lỗi cụ thể. Bạn có thể tìm kiếm mã trạng thái hoặc bất kỳ nội dung nào trong bất kỳ trường nào trong bảng.

Mã lỗi Mô tả Cách khắc phục

flow.*

flow.APITimedOut
  • Mã trạng thái HTTP:
 504 Gateway Timeout
  • Thông báo lỗi:
 API timed out
  • Nguyên nhân có thể xảy ra:

Lỗi này xảy ra nếu:

  • Máy chủ phụ trợ không phản hồi lại trong khoảng thời gian chờ do thuộc tính api.timeout định cấu hình cho Proxy API cụ thể.
  • Chính sách mất nhiều thời gian do các hoạt động tính toán chuyên sâu, tải cao hoặc hiệu suất kém.

Lưu ý: Cẩm nang này cung cấp hướng dẫn khắc phục sự cố mã lỗi messaging.adaptors.http.flow.GatewayTimeout; tuy nhiên, bạn có thể sử dụng cùng một cẩm nang để khắc phục sự cố mã lỗi flow.APITimedOut.

CẨM NANG

flow.SharedFlowNotFound
  • Mã trạng thái HTTP:
 500 Internal Server Error
  • Thông báo lỗi:
 Shared Flow {shared_flow_name} Not Found
  • Nguyên nhân có thể xảy ra:

Lỗi này xảy ra nếu quy trình dùng chung cụ thể:

  • Không tồn tại

    • HOẶC

  • Có nhưng chưa được triển khai
CẨM NANG

messaging.adaptors.http.flow

messaging.adaptors.http.flow.ApplicationNotFound
  • Mã trạng thái HTTP:
 404 Not Found
  • Thông báo lỗi:
 Unable to identify proxy for host: {virtual_host} and url: {pathsuffix}
  • Nguyên nhân có thể xảy ra:

Lỗi này xảy ra trong một trong các trường hợp sau:

  1. Proxy API cụ thể là:
    1. CHƯA được định cấu hình để chấp nhận các yêu cầu trên máy chủ ảo cụ thể
    2. KHÔNG được định cấu hình để chấp nhận các yêu cầu trên đường dẫn cụ thể được dùng trong yêu cầu
    3. KHÔNG được triển khai trong môi trường cụ thể mà bạn đang cố gắng thực hiện yêu cầu API
    4. KHÔNG được triển khai trên một hoặc nhiều Trình xử lý thông báo
  2. Môi trường cụ thể mà bạn đang cố gắng tạo yêu cầu API không được tải trên một hoặc nhiều Trình xử lý thông báo
 CẨM NANG
Lỗi này cũng có thể xảy ra nếu nhiều máy chủ ảo có cùng bí danh máy chủ và số cổng. CẨM NANG

messaging.adaptors.http.flow.DecompressionFailureAtRequest
  • Mã trạng thái HTTP:
 400 Bad Request
  • Thông báo lỗi:
 Decompression failure at request
  • Nguyên nhân có thể xảy ra:

Lỗi này chỉ xảy ra nếu:

  • Mã hoá được chỉ định trong tiêu đề yêu cầu HTTP Content-Encoding là hợp lệ và được Apigee Edge hỗ trợ,

    • NHƯNG

  • Định dạng tải trọng do ứng dụng gửi trong yêu cầu HTTP không khớp với định dạng mã hoá được chỉ định trong tiêu đề Content-Encoding
CẨM NANG

messaging.adaptors.http.flow.DecompressionFailureAtResponse
  • Mã trạng thái HTTP:
 502 Bad Gateway
  • Thông báo lỗi:
 Decompression failure at response
  • Nguyên nhân có thể xảy ra:

Lỗi này chỉ xảy ra nếu:

  • Mã hoá được chỉ định trong tiêu đề phản hồi HTTP Content-Encoding của máy chủ phụ trợ/máy chủ mục tiêu là hợp lệ và được Apigee Edge hỗ trợ,

    • NHƯNG

  • Định dạng tải trọng do phần phụ trợ/máy chủ mục tiêu gửi trong phản hồi HTTP không khớp với định dạng mã hoá được chỉ định trong tiêu đề Content-Encoding
CẨM NANG

messaging.adaptors.http.flow.ErrorResponseCode
  • Mã trạng thái HTTP:
 500

CẨM NANG

VIDEO

  • Thông báo lỗi:
 Thông báo lỗi và định dạng có thể khác nhau tuỳ thuộc vào cách triển khai máy chủ phụ trợ.
  • Nguyên nhân có thể xảy ra:
 Lỗi này xảy ra nếu máy chủ phụ trợ phản hồi bằng mã trạng thái 500 cho Apigee Edge.
  • Mã trạng thái HTTP:
 503

CẨM NANG

VIDEO

  • Thông báo lỗi:
 Thông báo lỗi và định dạng có thể khác nhau tuỳ thuộc vào cách triển khai máy chủ phụ trợ.
  • Nguyên nhân có thể xảy ra:
 Lỗi này xảy ra nếu máy chủ phụ trợ phản hồi bằng mã trạng thái 503 cho Apigee Edge.
  • Mã trạng thái HTTP:
 504 CẨM NANG
  • Thông báo lỗi:
 Thông báo lỗi và định dạng có thể khác nhau tuỳ thuộc vào cách triển khai máy chủ phụ trợ.
  • Nguyên nhân có thể xảy ra:
 Lỗi này xảy ra nếu máy chủ phụ trợ phản hồi bằng mã trạng thái 504 cho Apigee Edge.

Lưu ý: Mã lỗi messaging.adaptors.http.flow.ErrorResponseCode không được trả về trong thông báo lỗi gửi đến các ứng dụng khách. Nguyên nhân là do mã lỗi này do Apigee Edge đặt bất cứ khi nào máy chủ phụ trợ phản hồi báo lỗi và bất kỳ mã trạng thái 4XX hoặc 5XX nào. Bạn có thể xem mã lỗi này trong phần Giám sát API, nhật ký truy cập NGINX hoặc cơ sở dữ liệu phân tích.

messaging.adaptors.http.flow.GatewayTimeout
  • Mã trạng thái HTTP:
 504 Gateway Timeout
  • Thông báo lỗi:
 Gateway Timeout
  • Nguyên nhân có thể xảy ra:
 Lỗi này xảy ra nếu máy chủ phụ trợ không phản hồi lại Trình xử lý thông báo Apigee Edge trong khoảng thời gian chờ I/O được định cấu hình trên Trình xử lý thông báo.
CẨM NANG

messaging.adaptors.http.flow.LengthRequired
  • Mã trạng thái HTTP:
 411 Length Required
  • Thông báo lỗi:
 'Content-Length' is missing
  • Nguyên nhân có thể xảy ra:

Lỗi này xảy ra nếu ứng dụng khách không chuyển tiêu đề Content-Length trong các yêu cầu HTTP POST và PUT gửi đến Apigee Edge.

Lưu ý: Bạn không thể ghi lại các yêu cầu không thành công với lỗi này trong công cụ Theo dõi, vì Trình xử lý thông báo thực hiện quy trình xác thực này ở giai đoạn rất sớm, trước khi xử lý yêu cầu và thực thi bất kỳ chính sách nào trong Proxy API.
  • Quy cách HTTP:
 RFC Phần 3.3.2: Content-Length

Cách khắc phục

Để khắc phục lỗi này, hãy thực hiện các bước sau:

  1. Đảm bảo rằng ứng dụng khách luôn truyền tiêu đề Content-Length trong các yêu cầu HTTP POST và PUT được gửi đến Apigee Edge. Ví dụ:

    curl -X POST https://HOSTALIAS/PATH -d '{"name": "abc"}' -H "Content-Length: 15"

  2. Ngay cả khi bạn đang truyền một tải trọng trống cùng với các yêu cầu POST và PUT, hãy đảm bảo rằng tiêu đề Content-Length: 0 được truyền. Ví dụ:

    curl -X POST https://HOSTALIAS/PATH -H "Content-Length: 0"

messaging.adaptors.http.flow.NoActiveTargets
  • Mã trạng thái HTTP:
 503 Service Unavailable
  • Thông báo lỗi:
 The Service is temporarily unavailable
  • Nguyên nhân có thể xảy ra:

Lỗi này xảy ra trong một trong các trường hợp sau, nếu bạn đang sử dụng TargetServer trong Apigee Edge:

  1. Việc phân giải DNS không chính xác của máy chủ phụ trợ của máy chủ uỷ quyền tuỳ chỉnh dẫn đến địa chỉ IP không hợp lệ, gây ra lỗi kết nối.
  2. Lỗi hết thời gian chờ kết nối do:
    1. Quy định hạn chế của tường lửa trên máy chủ phụ trợ ngăn Apigee Edge kết nối với máy chủ phụ trợ.
    2. Vấn đề về khả năng kết nối mạng giữa Apigee Edge và máy chủ phụ trợ.
  3. Máy chủ lưu trữ được chỉ định trong TargetServer không chính xác hoặc có các ký tự không mong muốn (chẳng hạn như khoảng trắng).

CẨM NANG

VIDEO
Lỗi này cũng có thể xảy ra nếu các lần kiểm tra tình trạng được định cấu hình để theo dõi quá trình kiểm tra tình trạng của máy chủ mục tiêu không thành công.

CẨM NANG

VIDEO

messaging.adaptors.http.flow.RequestTimeOut
  • Mã trạng thái HTTP:
 408 Request Timeout
  • Thông báo lỗi:
 Request timed out
  • Nguyên nhân có thể xảy ra:
 Lỗi này xảy ra nếu Trình xử lý thông báo Apigee Edge không nhận được tải trọng yêu cầu từ ứng dụng khách cho thời gian chờ I/O được định cấu hình trên thành phần Trình xử lý thông báo.

Cách khắc phục

Đảm bảo rằng ứng dụng khách gửi tải trọng yêu cầu trong thời gian chờ I/O được định cấu hình trên thành phần Trình xử lý thông báo của Apigee Edge.

messaging.adaptors.http.flow.ServiceUnavailable
  • Mã trạng thái HTTP:
 503 Service Unavailable
  • Thông báo lỗi:
 The Service is temporarily unavailable
  • Nguyên nhân có thể xảy ra:

Lỗi này xảy ra trong một trong các trường hợp sau:

  1. Việc phân giải DNS không chính xác của máy chủ phụ trợ do máy chủ uỷ quyền tuỳ chỉnh lưu trữ dẫn đến địa chỉ IP không hợp lệ, gây ra lỗi kết nối.
  2. Lỗi hết thời gian chờ kết nối do:
    1. Quy định hạn chế của tường lửa trên máy chủ phụ trợ ngăn Apigee Edge kết nối với máy chủ phụ trợ.
    2. Vấn đề về khả năng kết nối mạng giữa Apigee Edge và máy chủ phụ trợ.
  3. Máy chủ lưu trữ của máy chủ mục tiêu được chỉ định trong Điểm cuối mục tiêu không chính xác hoặc có các ký tự không mong muốn (chẳng hạn như khoảng trắng).

CẨM NANG

Lỗi DNS:

VIDEO

Kết nối mạng:

VIDEO
Lỗi này cũng có thể xảy ra nếu máy chủ phụ trợ đóng kết nối sớm trong khi Trình xử lý thông báo vẫn đang gửi tải trọng yêu cầu đến máy chủ phụ trợ. CẨM NANG

messaging.adaptors.http.flow.SslHandshakeFailed
  • Mã trạng thái HTTP:
 503 Service Unavailable
  • Thông báo lỗi:
 SSL Handshake failed {error_message}
  • Nguyên nhân có thể xảy ra:

Lỗi này xảy ra trong quá trình bắt tay SSL giữa Trình xử lý thông báo của Apigee Edge và máy chủ phụ trợ nếu:

  1. Kho lưu trữ đáng tin cậy của Trình xử lý thông báo của Apigee Edge:
    • Chứa một chuỗi chứng chỉ không khớp với chuỗi chứng chỉ đầy đủ của máy chủ phụ trợ

      • HOẶC

    • Không chứa chuỗi chứng chỉ đầy đủ của máy chủ phụ trợ
  2. Chuỗi chứng chỉ do máy chủ phụ trợ cung cấp:
    • Chứa Tên miền đủ điều kiện (FQDN) không khớp với tên máy chủ được chỉ định trong điểm cuối mục tiêu

      • HOẶC

    • Chứa chuỗi chứng chỉ không chính xác/chưa hoàn chỉnh

CẨM NANG

VIDEO

messaging.adaptors.http.flow.UnexpectedEOFAtTarget
  • Mã trạng thái HTTP:
 502 Bad Gateway
  • Thông báo lỗi:
 Unexpected EOF at target
  • Nguyên nhân có thể xảy ra:

Lỗi này xảy ra trong một trong các trường hợp sau:

  1. TargetServer không được định cấu hình đúng cách để hỗ trợ kết nối TLS/SSL trong Apigee Edge.
  2. Máy chủ phụ trợ có thể đóng kết nối đột ngột, trong khi Apigee Edge đang chờ phản hồi từ máy chủ phụ trợ.
  3. Thời gian chờ duy trì kết nối được định cấu hình không chính xác trên Apigee và máy chủ phụ trợ.
CẨM NANG

messaging.runtime.*

messaging.runtime.RouteFailed
  • Mã trạng thái HTTP:
 500 Internal Server Error
  • Thông báo lỗi:
 Unable to route the message to a TargetEndpoint
  • Nguyên nhân có thể xảy ra:

Lỗi này xảy ra nếu Apigee Edge không thể định tuyến yêu cầu đến bất kỳ TargetEndpoints nào vì:

  • Không có điều kiện quy tắc định tuyến (<RouteRule>) nào khớp với yêu cầu trong proxy

    • VÀ

  • Không có quy tắc định tuyến mặc định nào được xác định trong ProxyEndpoint (tức là <RouteRule> không có điều kiện nào)

Cách khắc phục

Để giải quyết lỗi này, hãy làm theo các hướng dẫn sau:

  1. Xem lại các quy tắc định tuyến được xác định trong ProxyEndpoint và sửa đổi để đảm bảo rằng có ít nhất một điều kiện quy tắc định tuyến khớp với yêu cầu của bạn.
  2. Bạn nên xác định quy tắc tuyến mặc định không có điều kiện khi có nhiều RouteRules.
  3. Đảm bảo rằng quy tắc tuyến mặc định luôn được xác định cuối cùng trong danh sách Route có điều kiện vì các quy tắc được đánh giá từ trên xuống trong ProxyEndpoint.

Để tìm hiểu thêm về cách xác định các điều kiện <RouteRule> trong ProxyEndpoint, hãy xem Mục tiêu có điều kiện.

messaging.runtime.SenseRaiseFault
  • Mã trạng thái HTTP:
 403 Forbidden
  • Thông báo lỗi:
 Sense Fault
  • Nguyên nhân có thể xảy ra:
 Lỗi này xảy ra nếu yêu cầu API được thực hiện từ một địa chỉ IP của ứng dụng cụ thể bị chặn theo quy tắc của Apigee Sense.

Cách khắc phục

Để khắc phục lỗi này, hãy làm theo hướng dẫn sau:

  1. Xác minh rằng bạn đã chặn địa chỉ IP cụ thể của ứng dụng bằng cách kiểm tra các quy tắc được định cấu hình trong Apigee Sense. Nếu bị chặn, thì tức là tính năng này đang hoạt động như dự kiến.
  2. Nếu địa chỉ IP của ứng dụng cụ thể không bị chặn nhưng bạn vẫn gặp lỗi này, hãy liên hệ với Nhóm hỗ trợ Apigee Edge.

protocol.http.* - Caused due to bad request

protocol.http.BadFormData
  • Mã trạng thái HTTP:
 500 Internal Server Error
  • Thông báo lỗi:
 Bad Form Data
  • Nguyên nhân có thể xảy ra:

Lỗi này xảy ra nếu và chỉ khi đáp ứng tất cả các điều kiện sau:

  1. Yêu cầu HTTP do ứng dụng gửi đến Apigee Edge chứa:
    • Content-Type: application/x-www-form-urlencoded, và
    • Dữ liệu biểu mẫu có dấu phần trăm (%) hoặc dấu phần trăm (%) theo sau là các ký tự thập lục phân không hợp lệ không được phép theo Biểu mẫu – Mục 17.13.4.1.
  2. Proxy API trong Apigee Edge sẽ đọc các tham số biểu mẫu cụ thể có chứa bất kỳ ký tự nào không được phép sử dụng ExtractVariables hoặc chính sách AttributionMessage trong quy trình yêu cầu.
CẨM NANG

protocol.http.DuplicateHeader
  • Mã trạng thái HTTP:
 400 Bad Request
  • Thông báo lỗi:
 Duplicate Header "{header_name}"
  • Nguyên nhân có thể xảy ra:
 Lỗi này xảy ra nếu một tiêu đề HTTP cụ thể không được phép có nội dung trùng lặp trong Apigee Edge, xuất hiện nhiều lần với cùng một giá trị hoặc giá trị khác nhau trong yêu cầu HTTP do ứng dụng khách gửi đến Apigee Edge.
  • Quy cách HTTP:
 RFC 7230, phần 3.2.2: Trình tự trường
CẨM NANG

protocol.http.EmptyHeaderName
  • Mã trạng thái HTTP:
 400 Bad Request
  • Thông báo lỗi:
 Header name cannot be empty
  • Nguyên nhân có thể xảy ra:
 Lỗi này xảy ra nếu tên tiêu đề được gửi trong yêu cầu HTTP mà ứng dụng khách gửi đến Apigee Edge bị trống.
  • Quy cách HTTP:
 RFC 7230, mục 3.2: Trường tiêu đề

Cách khắc phục

Đảm bảo rằng yêu cầu HTTP do ứng dụng khách gửi đến Apigee Edge luôn chứa tên tiêu đề hợp lệ theo RFC 7230, mục 3.2: Các trường tiêu đề.

protocol.http.HeaderNameWithNonAsciiChar
  • Mã trạng thái HTTP:
 400 Bad Request
  • Thông báo lỗi:
 Header {header_name} contains non ascii character {character}
  • Nguyên nhân có thể xảy ra:
 Lỗi này xảy ra nếu tên tiêu đề được gửi trong yêu cầu HTTP mà ứng dụng khách gửi đến Apigee Edge chứa các ký tự không phải ASCII.
  • Quy cách HTTP:

RFC 7230, phần 3.2: Trường tiêu đề và RFC 7230, phần 3.2.6: Thành phần giá trị trường

Cách khắc phục

Đảm bảo rằng yêu cầu HTTP của ứng dụng gửi đến Apigee Edge không chứa các ký tự không phải ASCII trong tên tiêu đề theo RFC 7230, mục 3.2.6: Thành phần giá trị trường.

protocol.http.HeaderWithInvalidChar
  • Mã trạng thái HTTP:
 400 Bad Request
  • Thông báo lỗi:
 Header {header_name} contains invalid character {character}
  • Nguyên nhân có thể xảy ra:
 Lỗi này xảy ra nếu tên tiêu đề được gửi trong yêu cầu HTTP mà ứng dụng khách gửi đến Apigee Edge chứa các ký tự không hợp lệ như dấu bằng (=), dấu phẩy (,), dấu chấm phẩy (;), dấu tab, CRLF và ký tự dòng mới.
  • Quy cách HTTP:

RFC 7230, mục 3.2: Trường tiêu đề và RFC 7230, mục 3.2.6: Thành phần giá trị trường

Cách khắc phục

Đảm bảo rằng yêu cầu HTTP do ứng dụng khách gửi đến Apigee Edge không chứa bất kỳ ký tự không hợp lệ nào trong tên tiêu đề theo RFC 7230, mục 3.2.6: Thành phần giá trị trường

protocol.http.InvalidPath
  • Mã trạng thái HTTP:
 400 Bad Request
  • Thông báo lỗi:
 Invalid path {path}
  • Nguyên nhân có thể xảy ra:
 Lỗi này xảy ra nếu đường dẫn trong URL yêu cầu HTTP do ứng dụng khách gửi đến Apigee Edge chứa các ký tự không được phép theo quy cách RFC 3986, mục 3.3: Đường dẫn.
  • Quy cách HTTP:

RFC 3986, mục 3: Thành phần cú pháp và RFC 3986, mục 3.3: Đường dẫn

Cách khắc phục

Đảm bảo rằng đường dẫn trong URL yêu cầu HTTP do ứng dụng máy khách gửi đến Apigee Edge không chứa bất kỳ ký tự nào không được phép theo mục 3.3: Đường dẫn trong RFC 3986.

protocol.http.TooBigBody
  • Mã trạng thái HTTP:
 413 Request Entity Too Large
  • Thông báo lỗi:
 Body buffer overflow
  • Nguyên nhân có thể xảy ra:
 Lỗi này xảy ra nếu kích thước tải trọng do ứng dụng khách gửi trong yêu cầu HTTP đến Apigee Edge lớn hơn giới hạn cho phép trong Apigee Edge.
  • Giới hạn:
 Các giới hạn của Apigee Edge
CẨM NANG

protocol.http.TooBigHeaders
  • Mã trạng thái HTTP:
 431 Request Header Fields Too Large
  • Thông báo lỗi:
 request headers size exceeding {limit}
  • Nguyên nhân có thể xảy ra:
 Tổng kích thước của tất cả các tiêu đề yêu cầu mà ứng dụng gửi trong yêu cầu HTTP đến Apigee Edge lớn hơn giới hạn cho phép trong Apigee Edge.
  • Quy cách HTTP:
 RFC 6585, mục 5: 431 Trường tiêu đề của yêu cầu quá lớn
  • Giới hạn:
 Giới hạn của Apigee Edge
CẨM NANG

protocol.http.TooBigLine
  • Mã trạng thái HTTP:
 414 Request-URI Too Long
  • Thông báo lỗi:
 request line size exceeding {limit}
  • Nguyên nhân có thể xảy ra:
 Lỗi này xảy ra nếu kích thước của dòng yêu cầu do ứng dụng khách gửi trong yêu cầu HTTP đến Apigee Edge lớn hơn hạn mức cho phép trong Apigee Edge.
  • Giới hạn:
 Giới hạn của Apigee Edge
CẨM NANG

protocol.http.UnsupportedEncoding
  • Mã trạng thái HTTP:
 415 Unsupported Media
  • Thông báo lỗi:
 Unsupported Encoding "{encoding}"
  • Nguyên nhân có thể xảy ra:
 Lỗi này xảy ra nếu tiêu đề Content-Encoding do ứng dụng gửi trong phản hồi HTTP chứa định dạng mã hoá/trọng tải không được Apigee Edge hỗ trợ.
  • Quy cách HTTP:
 RFC 7231, phần 6.5.13: 415 Loại nội dung nghe nhìn không được hỗ trợ
CẨM NANG

protocol.http.* - Caused by target

protocol.http.BadPath
  • Mã trạng thái HTTP:
 500 Internal Server Error
  • Thông báo lỗi:
 Invalid request path
  • Nguyên nhân có thể xảy ra:
 Lỗi này xảy ra nếu URL yêu cầu của máy chủ phụ trợ, được biểu thị bằng biến luồng target.url, chứa một đường dẫn bắt đầu bằng dấu chấm hỏi (?) thay vì dấu gạch chéo lên (/), là không hợp lệ.
  • Quy cách HTTP:

RFC 3986, mục 3: Thành phần cú pháp và RFC 3986, mục 3.3: Đường dẫn
CẨM NANG

protocol.http.DuplicateHeader
  • Mã trạng thái HTTP:
 502 Bad Gateway
  • Thông báo lỗi:
 Duplicate Header "{header_name}"
  • Nguyên nhân có thể xảy ra:
 Lỗi này xảy ra nếu tiêu đề HTTP cụ thể không được phép trùng lặp trong Apigee Edge, xuất hiện nhiều lần với cùng một hoặc các giá trị khác nhau trong phản hồi HTTP do máy chủ phụ trợ gửi đến Apigee Edge.
  • Quy cách HTTP:
 RFC 7230, phần 3.2.2: Trình tự trường
CẨM NANG

protocol.http.EmptyHeaderName
  • Mã trạng thái HTTP:
 502 Bad Gateway
  • Thông báo lỗi:
 Header name cannot be empty
  • Nguyên nhân có thể xảy ra:
 Lỗi này xảy ra nếu tên tiêu đề do máy chủ phụ trợ gửi trong phản hồi HTTP cho Apigee Edge.
  • Quy cách HTTP:
 RFC 7230, mục 3.2: Trường tiêu đề

Cách khắc phục

Đảm bảo rằng phản hồi HTTP do máy chủ phụ trợ gửi đến Apigee Edge luôn chứa tên tiêu đề hợp lệ theo RFC 7230, mục 3.2: Các trường tiêu đề.

protocol.http.EmptyPath
  • Mã trạng thái HTTP:
 500 Internal Server Error
  • Thông báo lỗi:
 Request path cannot be empty
  • Nguyên nhân có thể xảy ra:
 Lỗi này xảy ra nếu URL yêu cầu HTTP của máy chủ phụ trợ, được biểu thị bằng biến flow target.url, chứa một đường dẫn trống.
  • Quy cách HTTP:

RFC 3986, mục 3: Thành phần cú pháp và RFC 3986, mục 3.3: Đường dẫn
CẨM NANG

protocol.http.HeaderNameWithNonAsciiChar
  • Mã trạng thái HTTP:
 502 Bad Gateway
  • Thông báo lỗi:
 Header {header_name} contains non ascii character {character}
  • Nguyên nhân có thể xảy ra:
 Lỗi này xảy ra nếu tên tiêu đề do máy chủ phụ trợ gửi trong phản hồi HTTP đến Apigee Edge chứa các ký tự không phải ASCII.
  • Quy cách HTTP:

RFC 7230, mục 3.2: Trường tiêu đề và RFC 7230, mục 3.2.6: Thành phần giá trị trường

Cách khắc phục

Đảm bảo rằng phản hồi HTTP của máy chủ phụ trợ gửi đến Apigee Edge không chứa các ký tự không phải ASCII trong tên tiêu đề theo RFC 7230, mục 3.2.6: Thành phần giá trị trường.

protocol.http.HeaderWithInvalidChar
  • Mã trạng thái HTTP:
 502 Bad Gateway
  • Thông báo lỗi:
 Header {header_name} contains invalid character {character}
  • Nguyên nhân có thể xảy ra:
 Lỗi này xảy ra nếu tên tiêu đề do máy chủ phụ trợ gửi trong phản hồi HTTP, chứa các ký tự không hợp lệ như dấu bằng (=), dấu phẩy (,), dấu chấm phẩy (;), dấu tab, CRLF và ký tự Dòng mới.
  • Quy cách HTTP:

RFC 7230, mục 3.2: Trường tiêu đề và RFC 7230, mục 3.2.6: Thành phần giá trị trường

Cách khắc phục

Đảm bảo rằng phản hồi HTTP của máy chủ phụ trợ gửi đến Apigee Edge không chứa bất kỳ ký tự không hợp lệ nào trong tên tiêu đề theo RFC 7230, mục 3.2.6: Thành phần giá trị trường

protocol.http.ProxyTunnelCreationFailed
  • Mã trạng thái HTTP:
 503 Service Unavailable
  • Thông báo lỗi:
 Proxy refused to create tunnel with response status {status code}
  • Nguyên nhân có thể xảy ra:

Lỗi này xảy ra trong quá trình tạo đường hầm giữa Apigee Edge và máy chủ phụ trợ bằng máy chủ proxy do các vấn đề về tường lửa, ACL (Danh sách kiểm soát quyền truy cập), DNS, tình trạng sẵn có của máy chủ phụ trợ, v.v.

Lưu ý: Mã trạng thái trong thông báo lỗi (faultstring) cung cấp nguyên nhân cấp cao của vấn đề.
CẨM NANG

protocol.http.Response306Reserved
  • Mã trạng thái HTTP:
 502 Bad Gateway
  • Thông báo lỗi:
 Response Status code 306 is reserved, so can't be used.
  • Nguyên nhân có thể xảy ra:

Lỗi này xảy ra nếu máy chủ phụ trợ phản hồi bằng mã trạng thái 306 cho Apigee Edge.

Mã trạng thái 306 được xác định trong phiên bản trước của quy cách HTTP. Theo quy cách HTTP hiện tại, mã này là mã dành riêng và không được sử dụng.
  • Quy cách HTTP:
 RFC 7231, mục 6.3.5: 306 Đã đặt trước

Cách khắc phục

Vì mã trạng thái 306 được đặt trước, hãy đảm bảo rằng máy chủ phụ trợ của bạn không sử dụng mã trạng thái này trong khi gửi phản hồi tới Apigee Edge.

protocol.http.Response405WithoutAllowHeader
  • Mã trạng thái HTTP:
 502 Bad Gateway
  • Thông báo lỗi:
 Received 405 Response without Allow Header
  • Nguyên nhân có thể xảy ra:
 Máy chủ phụ trợ phản hồi bằng mã trạng thái 405 Method Not Allowed mà không có tiêu đề "Allow" (Cho phép).
  • Quy cách HTTP:

RFC 7231, phần 6.5.5: Phương thức 405 không được phép và RFC 7231, phần 7.4.1: Cho phép
CẨM NANG

protocol.http.ResponseWithBody
  • Mã trạng thái HTTP:
 502 Bad Gateway
  • Thông báo lỗi:
 Received {status_code} Response with message body
  • Nguyên nhân có thể xảy ra:

Lỗi này xảy ra nếu phản hồi HTTP từ máy chủ phụ trợ đến Apigee Edge là 204 No Content hoặc 205 Reset Content nhưng chứa nội dung phản hồi và/hoặc một hoặc nhiều tiêu đề sau:

  • Content-Length
  • Content-Encoding
  • Transfer-Encoding
  • Quy cách HTTP:

RFC 7231, phần 6.3.5: 204 Không có nội dung và RFC 7231, phần 6.3.6: 205 Đặt lại nội dung
CẨM NANG

protocol.http.TooBigBody
  • Mã trạng thái HTTP:
 502 Bad Gateway
  • Thông báo lỗi:
 Body buffer overflow
  • Nguyên nhân có thể xảy ra:
 Lỗi này xảy ra nếu kích thước tải trọng do ứng dụng khách gửi trong yêu cầu HTTP đến Apigee Edge lớn hơn giới hạn cho phép trong Apigee Edge.
  • Giới hạn:
 Các giới hạn của Apigee Edge
CẨM NANG

protocol.http.TooBigHeaders
  • Mã trạng thái HTTP:
 502 Bad Gateway
  • Thông báo lỗi:
 response headers size exceeding {limit}
  • Nguyên nhân có thể xảy ra:
 Lỗi này xảy ra nếu tổng kích thước của tất cả các tiêu đề phản hồi do máy chủ phụ trợ gửi trong quá trình phản hồi HTTP cho Apigee Edge lớn hơn giới hạn cho phép trong Apigee Edge.
  • Giới hạn:
 Giới hạn cạnh của Apigee
CẨM NANG

protocol.http.TooBigLine
  • Mã trạng thái HTTP:
 502 Bad Gateway
  • Thông báo lỗi:
 response line size exceeding {limit}
  • Nguyên nhân có thể xảy ra:
 Lỗi này xảy ra nếu kích thước của dòng phản hồi do máy chủ phụ trợ gửi trong phản hồi HTTP đến Apigee Edge lớn hơn giới hạn cho phép trong Apigee Edge.
  • Giới hạn:
 Giới hạn của Apigee Edge
CẨM NANG

protocol.http.UnsupportedEncoding
  • Mã trạng thái HTTP:
 415 Unsupported Media
  • Thông báo lỗi:
 Unsupported Encoding "{encoding}"
  • Nguyên nhân có thể xảy ra:
 Lỗi này xảy ra nếu tiêu đề Content-Encoding do máy chủ phụ trợ gửi trong phản hồi HTTP chứa định dạng mã hoá/trọng tải không được Apigee Edge hỗ trợ.
  • Quy cách HTTP:
 RFC 7231, mục 6.5.13: 415 Loại nội dung nghe nhìn không được hỗ trợ
CẨM NANG

security.util.*

security.util.KeyAliasNotFound
  • Mã trạng thái HTTP:
 500 Internal Server Error
  • Thông báo lỗi:
 KeyAlias {KeyAlias_name} is not found in Keystore {Keystore_Name}
  • Nguyên nhân có thể xảy ra:

Lỗi này xảy ra nếu không tìm thấy KeyAlias cụ thể được tham chiếu trong TargetEndpoint hoặc TargetServer trong Kho khoá cụ thể.

Cách khắc phục

Đảm bảo rằng KeyAlias được chỉ định trong TargetEndpoint hoặc TargetServer tồn tại và là một phần của Kho khoá cụ thể.

security.util.TrustStoreWithNoCertificates
  • Mã trạng thái HTTP:
 500 Internal Server Error
  • Thông báo lỗi:
 TrustStore {truststore_name} has no certificates
  • Nguyên nhân có thể xảy ra:

Lỗi này xảy ra nếu Truststore cụ thể được tham chiếu trong TargetEndpoint hoặc TargetServer không chứa chứng chỉ nào.

Cách khắc phục

Nếu bạn muốn xác thực chứng chỉ của máy chủ phụ trợ và muốn sử dụng Truststore trong một TargetEndpoint hoặc TargetServer, hãy đảm bảo rằng Truststore đó chứa các chứng chỉ hợp lệ của máy chủ phụ trợ.