Bạn đang xem tài liệu về Apigee Edge.
Truy cập vào
tài liệu Apigee X. thông tin
Dấu hiệu
Đã xảy ra lỗi khi đưa ra yêu cầu API trực tiếp bằng SmartDocs từ cổng thông tin dành cho nhà phát triển.
Thông báo lỗi
Lỗi thường gặp trên Cổng thông tin 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ể dẫn đến vấn đề này
Lỗi này có thể xảy ra khi Cổng thông tin nhà phát triển không nhận được phản hồi từ phần phụ trợ (proxy smartdocs 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 thường gặp và nguyên nhân điển hình của các lỗi đó được liệt kê trong bảng sau:
|
Lỗi |
(Các) Nguyên nhân thường gặp |
|
ERR_NAME_NOT_RESOLVED |
Proxy SmartDocs được định cấu hình sai hoặc các quy định hạn chế về tường lửa mạng |
|
Nội dung hỗn hợp |
Cổng thông tin được định cấu hình qua HTTP, yêu cầu SmartDocs qua HTTP |
|
500 – Lỗi máy chủ nội bộ |
Hãy cùng xem xét từng nguyên nhân và các bước giải quyết vấn đề.
Proxy SmartDocs được định cấu hình sai hoặc các quy định hạn chế về tường lửa mạng
Thông báo "ERR_NAME_NOT_RESOLVED" cho biết rằng URL proxy smartdocs được định cấu hình sai hoặc mạng mà cổng đang truy cập không thể gọi đến URL proxy smartdocs do các hạn chế của tường lửa. Bạn phải truy cập được vào proxy smartdocs từ Internet hoặc từ mạng nội bộ (đối với các API nội bộ).
Độ phân giải
Đảm bảo rằng bạn có thể truy cập vào proxy smartdocs từ tất cả các mạng cần thiết bằng cách triển khai proxy smartdocs đến một máy chủ ảo trên Edge có tên máy chủ có thể truy cập được 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 proxy smartdocs đang được gọi qua HTTP từ một trang được tải qua HTTPS.
Độ phân giải
Hiển thị proxy smartdocs qua https để giải quyết vấn đề. Bạn có thể làm như vậy bằng cách triển khai proxy smartdocs để thê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").
SmartDocs proxy 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ể là do sự cố với proxy "smartdocs". Trong trường hợp này, bạn nhận thấy rằng proxy smartdocs trả về lỗi này.
Chẩn đoán
Sử dụng công cụ Theo dõi để chẩn đoán lỗi với proxy "smartdocs", như mô tả bên dưới. Để biết thêm thông tin, hãy xem bài viết 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 "VALIDATE" để xác định chính sách cụ thể đang 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 đã xác định. Nếu bạn cần được trợ giúp, hãy liên hệ với Nhóm hỗ trợ Apigee Edge.
Bộ xử lý thông báo trên Edge không thể gọi điểm cuối API đã xuất bản
Lỗi 500 – Lỗi máy chủ nội bộ cũng có thể xảy ra khi Bộ xử lý thông báo thuộc tổ chức lưu trữ proxy Smartdocs không thể gọi điểm cuối API.
Chẩn đoán
Sử dụng công cụ Theo dõi để chẩn đoán lỗi với proxy "smartdocs", như mô tả bên dưới. Để biết thêm thông tin, hãy xem bài viết Sử dụng công cụ Theo dõi.
- Bật trace cho proxy "smartdocs" trong tổ chức "VALIDATE" để xác định chính sách cụ thể đang 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 xuất hiện ở trên, bạn có thể thấy 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 Message Processor được liên kết với tổ chức "VALIDATE" như minh hoạ dưới đây:
curl -v <target URL>
- Sửa mọi lỗi đã phát hiện.
Độ phân giải
- Đảm bảo rằng các API được 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ừ Trình xử lý thông báo được liên kết với tổ chức "VALIDATE" và sửa mọi lỗi gặp phải.
- Nếu có thể thực thi lệnh gọi API trực tiếp từ Trình xử lý thông báo, thì rất có 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.