Bạn đang xem tài liệu về Apigee Edge.
Chuyển đến
Tài liệu về Apigee X. thông tin
Triệu chứng
Đã xảy ra lỗi khi thực hiện yêu cầu API trực tiếp bằng SmartDocs từ nhà phát triển cổng thông tin.
Thông báo lỗi
Lỗi phổ biến có trên Cổng thông tin dành cho nhà phát triển là “Đã xảy ra lỗi nội bộ. Vui lòng thử lại yêu cầu của bạn".
Nguyên nhân có thể xảy ra
Lỗi này có thể xảy ra khi Cổng thông tin dành cho nhà phát triển không nhận được phản hồi từ phần phụ trợ (Smartdocs proxy hoặc điểm cuối thực tế).
Chẩn đoán
Bật “Công cụ cho nhà phát triển” trong trình duyệt của bạn và kiểm tra thẻ mạng để xác định lỗi thực tế.
Các lỗi phổ biến và nguyên nhân điển hình được liệt kê trong bảng sau:
|
Lỗi |
(Các) Nguyên nhân điển hình |
|
ERR_NAME_NOT_RESOLVED |
Cấu hình sai proxy SmartDocuments hoặc tường lửa mạng hạn chế |
|
Nội dung hỗn hợp |
Cổng thông tin được định cấu hình qua HTTP, SmartDocs yêu cầu qua HTTP |
|
500 – Lỗi máy chủ nội bộ |
Hãy cùng tìm hiểu từng nguyên nhân trong số này và các bước để giải quyết vấn đề.
Cấu hình sai proxy Smart Docs hoặc tường lửa mạng hạn chế
Thông báo “ERR_NAME_NOT_RESOLVED” cho biết rằng url proxy của Smartdocs bị định cấu hình sai hoặc mạng mà từ đó cổng thông tin đang được truy cập bị không thể gọi đến URL proxy của Smartdocs do các hạn chế về tường lửa. Tài liệu thông minh proxy phải truy cập được từ Internet hoặc từ mạng nội bộ (đối với API nội bộ).
Độ phân giải
Đảm bảo rằng có thể truy cập proxy Smartdocs từ tất cả các mạng yêu cầu bằng cách triển khai Smartdocs proxy đến một máy chủ ảo trên Edge bằng một tên máy chủ có thể truy cập từ Internet.
Cổng thông tin được định cấu hình qua HTTPS, yêu cầu SmartDocs qua HTTP
Lỗi "Nội dung hỗn hợp" cho biết rằng proxy của Smartdocs là được gọi qua HTTP từ một trang được tải qua HTTPS.
Độ phân giải
Hiển thị proxy của Smartdocs qua https để giải quyết vấn đề này. Bạn có thể làm như vậy bằng cách triển khai proxy Smartdocs để bao gồm một máy chủ ảo được định cấu hình để sử dụng TLS/SSL (thường là máy chủ ảo "bảo mật").
Proxy Smart Tài liệu trả về một trường hợp ngoại lệ
Thông báo 500 - Lỗi máy chủ nội bộ có thể do vấn đề với proxy "smartdocs". Trong trường hợp này, bạn nhận thấy rằng proxy Smartdocs trả về giá trị này .
Chẩn đoán
Sử dụng công cụ Theo dõi để chẩn đoán lỗi bằng proxy "smartdocs" như mô tả bên dưới. Để biết thêm thông tin, hãy xem phần Sử dụng công cụ Theo dõi.
- Bật tính năng theo dõi cho Proxy "smartdocs" trong tổ chức “XÁC THỰC” để xác định chính sách cụ thể trả về Lỗi máy chủ nội bộ 500.
- Chọn chính sách cụ thể trong dấu vết để xác định nguyên nhân gây ra lỗi.
Độ phân giải
Khắc phục lỗi được xác định. Nếu bạn cần được hỗ trợ, hãy liên hệ với Bộ phận hỗ trợ Apigee Edge.
Trình xử lý thông báo Edge không thể gọi điểm cuối API đã phát hành
500 - Lỗi máy chủ nội bộ cũng có thể xảy ra khi Bộ xử lý thư thuộc về tổ chức lưu trữ proxy Smartdocs không thể gọi điểm cuối của API.
Chẩn đoán
Sử dụng công cụ Theo dõi để chẩn đoán lỗi bằng proxy "smartdocs" như mô tả bên dưới. Để biết thêm thông tin, hãy xem phần Sử dụng công cụ Theo dõi.
- Bật tính năng theo dõi cho "thông minh tài liệu" proxy trong tổ chức “XÁC THỰC” để xác định chính sách cụ thể trả về Lỗi máy chủ nội bộ 500.
- Trong dấu vết giao diện người dùng mẫu nêu trên, chính sách JavaScript "BuildTargetAPIRequest" không thực thi được URL mục tiêu.
- Lấy URL mục tiêu từ chính sách JavaScript "BuildTargetAPIRequest".
- Gọi trực tiếp đến URL từ các nút Trình xử lý thư được liên kết với
"XÁC THỰC" tổ chức như sau:
curl -v <target URL>
- Sửa mọi lỗi phát hiện được.
Độ phân giải
- Đảm bảo rằng các API xuất bản trên Cổng thông tin dành cho nhà phát triển có thể được gọi từ Bộ xử lý tin nhắn liên kết với tổ chức “VALIDATE” và sửa bất kỳ lỗi nào gặp phải.
- Nếu bạn có thể thực thi lệnh gọi API trực tiếp từ Trình xử lý thông báo, đó là thì bạn cũng có thể thực thi API thông qua SmartDocs.
- Thực thi lệnh gọi API thông qua SmartDocs và kiểm tra xem vấn đề đã được khắc phục hay chưa.