将 GraphQL 迁移到 WunderGraph

创建 WunderGraph 应用程序

# Init a new project
npx create-wundergraph-app my-project --example simple
# Move to the project directory
cd my-project
# Install dependencies
npm i

添加 npm 脚本

将以下脚本添加到 package.json中，以便运行 WunderGraph 服务器。

{
   "scripts": {
      "start": "wunderctl up --debug",
      "build": "wunderctl generate"
   }
}

启动 WunderGraph MongoDB Server

npm run start

启动服务器后，WunderGraph 会生成一些代码。 检查位于http://localhost:9991的服务器状态。

配置 MongoDB Atlas 数据源

您需要配置 MongoDB Atlas 数据源。 在wundergraph.config.ts文件中添加以下内容：

const Atlas = introspect.mongodb({
   apiNamespace: 'my_db',
   databaseURL: 'YourAtlasURL',
});
configureWunderGraphApplication({
   apis: [Atlas],
});

添加查询操作

要使用 Atlas 数据，您需要添加查询操作。 导航到operations文件夹，创建一个名为Users.graphql的新 GraphQL 文件，然后添加以下内容：

{
   Mongo_findFirstusers {
      id
      name
      email
   }
}

使用 GraphiQL 用户界面浏览数据

在 WunderGraph 服务器运行并添加查询操作后，您可以使用 GraphQL 用户界面通过 GraphQL API 探索 Atlas 数据。 当应用程序处于开发阶段时，这非常有用。 对于生产环境中的应用程序，我们建议使用 WunderGraph 的 JSON-RPC 接口（请参阅下一步）。

1. 在 WunderGraph 服务器运行时，导航到http://localhost:9991/graphql 。

2. 将这些查询添加到 GraphiQL 用户界面：

   query Users {
      db_findManyusers {
         id
         name
         email
      }
   }

3. 单击“播放”按钮。

使用 WunderGraph 的 JSON-RPC 接口进行生产

GraphiQL 有利于开发，但在生产中，您应该考虑使用 WunderGraph 的 JSON-RPC 接口与 Atlas 数据进行交互。

简而言之，WunderGraph 将您的 GraphQL 操作编译为您可以调用的 JSON-RPC 端点。

运行wunderctl up后，WunderGraph 会检查.wundergraph/operations目录中是否有*.graphql文件并进行处理。 为此，每个文件应包含一个 GraphQL 操作。

每个文件都将被编译到一个 JSON-RPC 端点中。 端点的名称由文件名确定。

以下是 JSON-RPC API 查询示例：

curl http://localhost:9991/operations/Users

更新客户端应用程序

更新与 GraphQL API 端点交互的任何客户端应用程序，使其指向新的 WunderGraph 端点 URL。

关闭 Atlas App Services 端点

验证GraphQL API端点已完全迁移并可在 WunderGraph 上运行后，您可以删除MongoDB Atlas App Services应用，以避免不必要的费用。 谨此提醒，从 9 月302025 开始，将不再支持Atlas GraphQL端点。