尝试生成发现文档时出现 503 Service Unavailable答案

【问题标题】：Getting 503 Service Unavailable when trying to generate discovery document尝试生成发现文档时出现 503 Service Unavailable
【发布时间】：2013-02-01 11:09:30
【问题描述】：

我正在使用 Google Cloud Endpoints，我正在尝试生成一个发现文档来创建一个 iOS 客户端库，以便我可以测试我的端点。如文档中所述，我尝试使用此命令执行此操作：

endpointscfg.py gen_discovery_doc -o . -f rpc appfile.ApiClass

将appfile和ApiClass改成实名。

当我运行它时，我得到：

urllib2.HTTPError: HTTP Error 503: Service Unavailable

为什么要生成访问互联网的发现文档？为什么我会收到这个错误？我能做些什么来解决它？

附：我已经检查了我的代码中的基本错误，例如消息类中的其他类型、错误的主机名等，但似乎没有任何问题。

【问题讨论】：

标签： python google-app-engine http-status-code-503 service-discovery google-cloud-endpoints

【解决方案1】：

在生成发现文档时遇到类似问题后，

当某些事情与我的情况不一样时，将发生 503 错误，这是一个无效的 API 类定义。

确保@Api() 定义以小写字符开头，否则将返回 503 错误。

例如

//@Api(name = "thisMustBeLowerCase") otherwise client libraries wont compile.

 @Api(name = "sampleEndpoint") 
public class SampleEndpoint {...}

希望对你有帮助

【讨论】：

这很有趣。我不再使用端点，但这可能是问题所在。谢谢。

【解决方案2】：

RE：“为什么要生成访问互联网的发现文档？”

您的 API 类被传递给 ApiConfigGenerator.pretty_print_config_to_json method 以创建定义裸 API 配置的描述符。该描述符被发送到与 Google 的 API 基础架构挂钩的 Web API，以从裸 API 配置创建发现文档。

RE：“我为什么会收到这个错误？”

您的 API 配置可能无效，这通常是由无效的 API 类定义引起的。当您尝试运行或部署应用程序时，是否有任何错误或堆栈跟踪？如果不是，则可能是运行 Web 服务以生成发现文档的代码中存在错误，我很乐意调查一下。

【讨论】：

我查看了我的代码和 tictactoe 示例之间的差异，确实找不到任何可能导致问题的内容。请你看看好吗？
我目前没有任何事情要调查。您介意在问题中发布您的更改吗？您使用的是哪个井字游戏示例？
我应该澄清一下——我没有直接更改示例，而是编写了一个 API。一切似乎都井然有序。当我在我的电脑上时，我会发布代码。