.NET Core 6.0中GraphQL调用REST GET端点及字段提取问题

核心思路 #

以GraphQL服务作为中间层，在Resolver中直接发起GET请求调用REST端点，利用GraphQL的字段按需返回特性，自动从REST响应中提取客户端请求的字段。

1. 定义GraphQL类型与查询 #

先编写SDL（Schema Definition Language），匹配REST响应的数据结构定义GraphQL类型，同时声明查询接口：

# 对应REST返回的用户数据结构
type User {
  id: ID!
  name: String!
  email: String
  age: Int
}

# 定义查询入口
type Query {
  # 根据ID获取单个用户
  getUser(id: ID!): User
  # 获取用户列表
  getUsers: [User]
}

2. 在Resolver中实现REST GET调用 #

在Resolver函数里，用原生fetch（浏览器环境）或node-fetch（Node.js服务端）发起GET请求，拿到完整REST响应后直接返回——GraphQL会自动根据客户端的查询字段过滤数据，无需手动处理。

Node.js环境示例：

const fetch = require('node-fetch');

const resolvers = {
  Query: {
    getUser: async (_, { id }) => {
      try {
        // 发起GET请求到REST端点
        const res = await fetch(`https://api.example.com/users/${id}`);
        if (!res.ok) throw new Error(`REST请求失败：${res.status}`);
        
        const userData = await res.json();
        return userData;
      } catch (err) {
        throw new Error(`获取用户失败：${err.message}`);
      }
    },
    getUsers: async () => {
      const res = await fetch('https://api.example.com/users');
      return res.json();
    }
  }
};

浏览器环境示例：

const resolvers = {
  Query: {
    getUser: async (_, { id }) => {
      const res = await fetch(`https://api.example.com/users/${id}`);
      return res.json();
    }
  }
};

3. 按需获取字段的实现 #

当客户端发起如下查询时：

query {
  getUser(id: "123") {
    id
    name
  }
}

即便REST端点返回了id、name、email、age的完整数据，GraphQL会自动只返回id和name字段，完全匹配客户端的查询需求。

如果REST响应的字段名与GraphQL类型字段名不一致，可在Resolver中手动映射：

getUser: async (_, { id }) => {
  const res = await fetch(`https://api.example.com/users/${id}`);
  const userData = await res.json();
  // 字段映射：REST返回user_name → GraphQL的name
  return {
    id: userData.user_id,
    name: userData.user_name,
    email: userData.user_email
  };
}

关键说明 #

• GraphQL客户端到服务端的请求默认是POST，但这和GraphQL服务调用REST的GET请求互不冲突——两者属于不同层级的请求。
• 无需额外工具，仅通过Resolver原生发起HTTP请求即可完成集成，完全满足无Apollo客户端的需求。

内容的提问来源于stack exchange，提问作者Ananya Sharma