Masalah umum

Halaman ini berisi masalah umum di Cloud Endpoints Frameworks.

Java dan Python

Bagian ini menjelaskan masalah umum yang memengaruhi versi Java dan Python dari Endpoints Frameworks.

Waktu tunggu permintaan maksimum

Untuk API yang menggunakan Endpoints Frameworks versi 2, waktu tunggu permintaan maksimum adalah 60 detik.

Migrasi Endpoints Frameworks

Saat memigrasikan API ke Endpoints Frameworks versi 2, Anda harus men-deploy API ke aplikasi App Engine baru. Jika Anda menggunakan kembali aplikasi App Engine lama, permintaan yang dimulai dengan jalur versi 1, /_ah/spi, mungkin akan dirutekan ke backend Endpoints Frameworks versi 2, yang mengharapkan jalur dimulai dengan /_ah/api.

Performa buruk pada instance penskalaan otomatis

App Engine menawarkan tiga jenis penskalaan: dasar, manual, dan otomatis. Endpoints Frameworks menggunakan thread latar belakang, yang tidak didukung oleh instance penskalaan otomatis. Endpoints Frameworks harus berkomunikasi dengan layanan Google untuk memeriksa kuota dan melaporkan aktivitas API, serta hal lainnya. Untuk instance penskalaan dasar dan manual, thread latar belakang melakukan komunikasi ini untuk menghindari pelambatan permintaan. Namun, instance penskalaan otomatis tidak mendukung thread latar belakang. Sebagai gantinya, komunikasi dengan layanan Google terjadi selama permintaan. Endpoints Frameworks masih berfungsi, tetapi dengan potensi penurunan performa.

Karena masalah ini, Anda mungkin ingin mengonfigurasi jenis penskalaan lain. Lihat bagian berikut dalam dokumentasi App Engine:

Jalur dengan garis miring di akhir tidak didukung

Saat Anda men-deploy dokumen OpenAPI menggunakan gcloud endpoints services deploy, Cloud Endpoints akan menolak dokumen OpenAPI yang menyertakan jalur dengan garis miring di akhir, misalnya: 

paths:
  "/echo/":
    post:
      description: "Echo back a given message."

Di Endpoints Frameworks, Anda harus menghapus garis miring di akhir dalam dekorator metode Python atau anotasi metode Java.

Java

Bagian ini menjelaskan masalah umum di Endpoints Frameworks untuk Java.

Cloud Endpoints Frameworks untuk Java - versi 1.0.14 atau yang lebih lama

Menyertakan masalah saat kolom baru dalam Konfigurasi Layanan Google menyebabkan library Java Cloud Endpoints Frameworks gagal saat mengurai Konfigurasi Layanan. Error akan mirip dengan berikut saat menggunakan konfigurasi layanan yang dibuat setelah 5 Desember 2024:

Failed to parse the HTTP response as service configuration
com.google.api.config.ServiceConfigException: Failed to parse the HTTP response as service configuration

Lihat catatan rilis untuk mengetahui informasi selengkapnya tentang cara mengupgrade ke versi 1.0.15 atau yang lebih baru.

Endpoints Frameworks Java Lama (v1)

Endpoints Frameworks versi 1 untuk Java memiliki bug yang menampilkan pengecualian saat enum diberi anotasi. Masalah ini disebabkan oleh a dependensi pada Jackson versi lama . Untuk mengatasi masalah ini, Anda harus bermigrasi ke Endpoints Frameworks versi 2.

Python

Bagian ini menjelaskan masalah umum di Endpoints Frameworks untuk Python.

Pesan error: ImportError: cannot import name locked_file

Saat menjalankan pip install dengan file requirements.txt, Anda mungkin mendapatkan pesan error ImportError: cannot import name locked_file. Masalah ini terjadi saat pip menginstal versi paket oauth2client yang tidak kompatibel dengan google-endpoints-api-management. Untuk mengatasi masalah ini, pastikan baris google-endpoints dan google-endpoints-api-management muncul terlebih dahulu dalam file requirements.txt, misalnya:

google-endpoints==4.8.0
google-endpoints-api-management==1.11.1
# Newer versions of rsa module are incompatible with Python 2.7
rsa==4.5; python_version < '3'

Tambahkan persyaratan lain setelah baris ini.

API menampilkan error 404 saat diuji secara lokal

Gejala: Semua endpoint menampilkan 404 saat Anda menggunakan dev_appserver.py untuk menguji API secara lokal, tetapi saat Anda men-deploy API ke App Engine, endpoint akan merespons seperti yang diharapkan. Masalah ini telah diamati dalam aplikasi yang menggunakan library Django-six.

Masalah ini disebabkan oleh konflik versi antara library python-future, yang disertakan dalam library Endpoints Frameworks untuk Python dan library Django-six. Versi pasti library Django-six yang menyebabkan konflik tidak diketahui saat ini.