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 tạo yêu cầu API trực tiếp bằng SmartDocs trong cổng thông tin cho nhà phát triển.
Thông báo lỗi
Lỗi phổ biến trên Cổng thông tin 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 cho nhà phát triển không nhận được phản hồi từ phần phụ trợ (Proxy thông minh 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 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 |
|
|
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 tìm hiểu từng nguyên nhân dẫn đến vấn đề này và các bước để giải quyết vấn đề.
Định cấu hình proxy SmartDocs hoặc hạn chế về tường lửa mạng
Thông báo “ERR_NAME_NOT_RESOLVED” cho biết URL proxy của Smartdocs bị định cấu hình sai hoặc mạng mà cổng thông tin đang được truy cập không thể thực hiện lệnh gọi đến URL proxy của Smartdocs do các hạn chế của tường lửa. Proxy Smartdocs 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 proxy Smartdocs có thể truy cập được từ tất cả các mạng bắt buộc bằng cách triển khai proxy Smartdocs cho một máy chủ ảo trên Edge bằng một tên máy chủ có thể truy cập qua 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 đề này. Bạn có thể thực hiện việc nà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 SmartDocs trả về một ngoại lệ
Thông báo 500 – Lỗi máy chủ nội bộ có thể do sự cố với proxy “smartdocs”. Trong trường hợp này, bạn nhận thấy proxy Smartdocs sẽ 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 bằng proxy "smartdocs" như mô tả dưới đây. Để 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 lỗi.
Độ phân giải
Khắc phục lỗi đã xác định. Nếu bạn cần hỗ trợ, hãy liên hệ với Nhóm hỗ trợ Apigee.
Trình xử lý thông báo Edge không thể gọi điểm cuối API đã xuất bản
500 – Lỗi máy chủ nội bộ cũng có thể xảy ra khi Bộ xử lý thư 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 bằng proxy "smartdocs" như mô tả dưới đây. Để 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 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 ở trên, có thể thấy rằng 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".
- Thực hiện lệnh gọi trực tiếp đến URL qua các nút Trình xử lý thông báo liên kết với tổ chức "VALIDATE" như sau:
curl -v <target URL>
- Sửa mọi lỗi quan sát được.
Độ phân giải
- Đảm bảo rằng bạn có thể gọi các API được phát hành trên Cổng thông tin cho nhà phát triển từ Bộ xử lý thông báo được liên kết với tổ chức “VALIDATE” và khắc phục mọi lỗi 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ư, thì rất có khả năng bạn cũng có thể thực thi API thông qua SmartDocs.
- Thực hiện lệnh gọi API thông qua SmartDocs và kiểm tra xem sự cố đã được khắc phục hay chưa.