Résoudre des problèmes concernant les erreurs de réponse
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Si vous n'obtenez pas de réponse satisfaisante à une requête adressée à votre API Cloud Endpoints Frameworks, vous pouvez utiliser Cloud Logging dans la consoleGoogle Cloud pour résoudre le problème.
Afficher les journaux
Dans la console Google Cloud , accédez à la page Journaux > Explorateur de journaux.
Dans la liste déroulante des projets en haut de la page, sélectionnez le projetGoogle Cloud dans lequel vous avez créé votre API.
Sélectionnez Application GAE et Tous les journaux.
Ajustez la période jusqu'à voir une ligne indiquant une erreur.
Cliquez sur Tout développer pour afficher l'intégralité du journal correspondant à l'erreur.
La section suivante fournit des informations de dépannage pour des messages d'erreur spécifiques. Si vous ne parvenez pas à résoudre le problème, copiez l'une des entrées du journal indiquant l'erreur et collez-la dans un fichier texte. Joignez le journal à toute communication que vous avez avec Google.
503 Service Unavailable
App Engine peut prendre quelques minutes pour répondre favorablement aux requêtes. Si vous envoyez une requête et que vous obtenez une erreur 503, attendez quelques minutes et relancez la requête. Si vous n'obtenez toujours pas de réponse satisfaisante, consultez les journaux Cloud Logging. Voici quelques messages d'erreur susceptibles de s'afficher dans les journaux Cloud Logging.
Message d'erreur
Dépannage
Aucun service YOUR_PROJECT_ID.appspot.com trouvé ou autorisation refusée. S'il s'agit d'un nouveau service Endpoints, assurez-vous que vous avez déployé la configuration du service à l'aide de gcloud.
Endpoints Frameworks pour Python consigne cette erreur lorsqu'il ne parvient pas à charger la configuration du service que vous avez spécifié dans le fichier app.yaml. Cette erreur peut survenir si vous n'avez pas déployé le document OpenAPI pour votre API à l'aide de gcloud endpoints services
deploy ou si l'API Service Management n'est pas activée. Lorsque vous déployez le document OpenAPI pour votre API, la commande gcloud active automatiquement les éléments suivants :
API Service Management (servicemanagement.googleapis.com)
API Cloud (cloudapis.googleapis.com)
Si vous avez désactivé l'un de ces services, vous devez le réactiver. Consultez la page Activer et désactiver des API pour en savoir plus.
Le service YOUR_PROJECT_ID.appspot.com a été trouvé, mais aucune configuration de service n'a été trouvée pour la version SERVICE_CONFIG_ID.
Endpoints Frameworks pour Python consigne cette erreur lorsqu'il ne parvient pas à trouver l'ID de configuration de service que vous avez spécifié pour ENDPOINTS_SERVICE_VERSION dans le fichier app.yaml.
Solution :
Modifiez votre fichier app.yaml et définissez ENDPOINTS_SERVICE_VERSION sur l'ID de configuration du service.
Redéployez votre application :
gcloudappdeploy
404 Not Found
Si vous avez récemment migré vers la version 2 de Endpoints Frameworks et que vous obtenez le message d'erreur 404 Not Found, consultez les sections suivantes pour résoudre le problème :
Dans certaines versions de Windows PowerShell, l'exemple Invoke-WebRequest utilisé dans les tutoriels échoue. Nous avons également reçu un rapport indiquant que la réponse contenait une liste d'octets non signés devant être convertis en caractères. Si l'exemple Invoke-WebRequest n'a pas renvoyé le résultat attendu, essayez d'envoyer la requête à l'aide d'une autre application. Voici quelques suggestions :
Démarrez Cloud Shell et suivez les instructions Linux du tutoriel que vous avez utilisé pour envoyer la requête.
Utilisez une application tierce telle que l'extension Postman du navigateur Chrome (disponible sur www.getpostman.com). Lors de la création de la requête dans Postman :
Sélectionnez POST comme verbe HTTP.
Pour l'en-tête, sélectionnez la clé content-type et la valeur application/json.
Pour le corps de la requête, saisissez : {"message":"hello world"}
Entrez l'URL de l'exemple d'application. Exemple :
Téléchargez et installez curl, que vous exécutez dans l'invite de commande. Comme Windows ne gère pas les guillemets doubles imbriqués dans les guillemets simples, vous devez modifier l'option --data dans l'exemple, comme suit : --data "{\"message\":\"hello world\"}"
Utilisez des filtres pour le filtrage avancé, par exemple pour obtenir toutes les requêtes dont la latence dépasse 300 millisecondes.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/09/04 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/09/04 (UTC)."],[[["\u003cp\u003eCloud Logging helps troubleshoot unsuccessful responses from Cloud Endpoints Frameworks APIs, accessible via the Logs Explorer in the Google Cloud console.\u003c/p\u003e\n"],["\u003cp\u003eA \u003ccode\u003e503 Service Unavailable\u003c/code\u003e error may occur initially with App Engine; waiting a few minutes and retrying the request is recommended before checking logs.\u003c/p\u003e\n"],["\u003cp\u003eErrors like "No service found" or "permission denied" often indicate a missing service configuration or disabled APIs, which can be resolved by deploying the OpenAPI document and ensuring necessary APIs are enabled.\u003c/p\u003e\n"],["\u003cp\u003eA \u003ccode\u003e404 Not Found\u003c/code\u003e error after migrating to Endpoints Frameworks version 2 requires specific troubleshooting steps detailed in Java and Python migration guides.\u003c/p\u003e\n"],["\u003cp\u003eIf \u003ccode\u003eInvoke-WebRequest\u003c/code\u003e fails in Windows PowerShell, try using Cloud Shell, Postman, or \u003ccode\u003ecurl\u003c/code\u003e with specific formatting for nested quotation marks.\u003c/p\u003e\n"]]],[],null,["# Troubleshooting response errors\n\nIf you don't get a successful response from a request to your\nCloud Endpoints Frameworks API, you can use Cloud Logging in the\nGoogle Cloud console to help troubleshoot.\n\nViewing logs\n------------\n\n1. In the Google Cloud console, go to the **Logging** \\\u003e\n **Logs Explorer** page.\n\n\n [Go to the Logs Explorer page](https://console.cloud.google.com/logs/query)\n\n \u003cbr /\u003e\n\n2. From the project drop-down list at the top of the page, select the\n Google Cloud project in which you created your API.\n\n3. Select **GAE Application** and **All logs**.\n\n4. Adjust the time range until you see a row that shows an error.\n\n5. Click **Expand All** to see the entire log for the error.\n\nThe following section provides troubleshooting information for specific error\nmessages. If you are unable to fix the issue, copy one of the log entries that\nshows the error and paste it in a text file. Include the log in any\ncommunication that you have with Google.\n\n### `503 Service Unavailable`\n\nApp Engine might take a few minutes to respond successfully to requests. If you\nsend a request and get a `503` error, wait a few minutes and try the\nrequest again. If you still don't get a successful response, check the\nCloud Logging logs. The following are some error messages that you might\nsee in the Cloud Logging logs.\n\n### `404 Not Found`\n\nIf you recently migrated to Endpoints Frameworks version 2, and you\nget the `404 Not Found` error message, see the following sections to\ntroubleshoot the issue:\n\n- [Java: Troubleshooting](/endpoints/docs/frameworks/java/migrating#api_returns_404_errors_but_api_explorer_still_lists_apis_correctly)\n- [Python: Troubleshooting](/endpoints/docs/frameworks/python/migrating#api_returns_404_errors_but_api_explorer_still_lists_apis_correctly)\n\nIssues with the example `Invoke-WebRequest`\n-------------------------------------------\n\nIn some versions of Windows PowerShell, the example `Invoke-WebRequest` in the\n[tutorials](/endpoints/docs/frameworks/tutorials) fails. We have also received a\nreport that the response contained a list of unsigned bytes that had to be\nconverted to characters. If the example `Invoke-WebRequest` didn't return the\nexpected result, try sending the request using another application. Following\nare a few suggestions:\n\n- [Start Cloud Shell](/shell/docs/starting-cloud-shell), and follow the Linux steps in the tutorial that you were using to send the request.\n- Use a third-party application such as the Chrome browser extension Postman\n (offered by `www.getpostman.com`). When creating the request in Postman:\n\n - Select `POST` as the HTTP verb.\n - For the header, select the key `content-type` and the value `application/json`.\n - For the body, enter: `{\"message\":\"hello world\"}`\n - Enter the URL for the sample application. For example:\n\n https://example-project-12345.appspot.com/_ah/api/echo/v1/echo\n\n- Download and install [`curl`](https://curl.haxx.se/download.html), which you\n run in the Command prompt. Because Windows doesn't handle double quotation\n marks nested inside single quotation marks, you have to change the `--data`\n option in the example, as follows: `--data \"{\\\"message\\\":\\\"hello world\\\"}\"`\n\nWhat's next\n\n- Get started using the [Logs Explorer](/logging/docs/view/logs-explorer-interface).\n\n- Learn how to [route logs](/logging/docs/export/configure_export_v2).\n\n- Use [filters](/logging/docs/view/advanced_filters)\n for advanced filtering, such as getting all requests with a latency greater\n than 300 milliseconds."]]
