페이지 상단의 프로젝트 드롭다운 목록에서 API를 만든Google Cloud 프로젝트를 선택합니다.
GAE 애플리케이션과 모든 로그를 선택합니다.
오류가 표시되는 행이 보일 때까지 시간 범위를 조정합니다.
전체 로그에서 오류를 찾아보려면 모두 펼치기를 클릭합니다.
다음 섹션에서는 특정 오류 메시지에 대한 문제해결 정보를 제공합니다. 문제를 해결할 수 없으면 오류가 표시된 로그 항목 중 하나를 복사하여 텍스트 파일에 붙여넣습니다. 그런 다음 Google에 문의할 때 해당 로그를 보냅니다.
503 Service Unavailable
App Engine이 요청에 성공적으로 응답하는 데 몇 분 정도 걸릴 수 있습니다. 요청을 보내고 나서 503 오류가 수신되면 몇 분 기다렸다가 다시 요청을 시도하세요. 그래도 응답이 없으면 Cloud Logging 로그를 확인합니다. Cloud Logging 로그에 다음과 같은 오류 메시지가 표시될 수 있습니다.
오류 메시지
문제 해결
서비스 YOUR_PROJECT_ID.appspot.com을 찾을 수 없거나 권한이 거부되었습니다. 새로운 Endpoints 서비스인 경우 gcloud를 사용하여 서비스 구성을 배포했는지 확인하세요.
Python용 Endpoints 프레임워크는 app.yaml 파일에서 지정한 서비스의 서비스 구성을 로드할 수 없을 때 이 오류를 로깅합니다. 이 오류는 gcloud endpoints services
deploy를 사용하여 API의 OpenAPI 문서를 배포하지 않았거나 Service Management API를 사용 설정하지 않은 경우에 발생할 수 있습니다. API의 OpenAPI 문서를 배포하면 gcloud 명령어가 자동으로 다음을 사용 설정합니다.
Service Management API(servicemanagement.googleapis.com)
Cloud API(cloudapis.googleapis.com)
이러한 서비스를 하나라도 중지한 경우 다시 사용 설정해야 합니다. 자세한 내용은 API 사용 설정 및 중지를 참조하세요.
서비스 YOUR_PROJECT_ID.appspot.com이 있지만 SERVICE_CONFIG_ID 버전에 대한 서비스 구성이 없습니다.
Python용 Endpoints 프레임워크는 app.yaml 파일에서 ENDPOINTS_SERVICE_VERSION에 지정된 서비스 구성 ID를 찾지 못할 때 이 오류를 로깅합니다.
이 오류를 수정하려면 다음 안내를 따르세요.
일부 버전의 Windows PowerShell에서는 가이드의 Invoke-WebRequest 예시가 실패합니다. 또한 응답에 문자로 변환해야 하는 부호 없는 바이트 목록이 포함되어 있음이 보고되었습니다. Invoke-WebRequest 예시가 예상된 결과를 반환하지 않으면 다른 애플리케이션을 사용하여 요청을 전송해 보세요. 다음은 이와 관련된 몇 가지 권장사항입니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 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."]]
