GraphQL含空格字段查询报错，求支持方案与解决办法

这个问题的核心是GraphQL的字段命名规范不允许使用空格，所以你直接在查询里写Poke ball会被解析器拆成两个独立字段（Poke和ball），这就是为啥报错说"Cannot query field 'Poke' on type 'UserItems'"。直接加引号也没用——GraphQL里引号是用来定义字符串值的，不是字段名的合法包裹符。

不过完全有可行的解决办法，核心思路是用合法的GraphQL字段名做中转，在数据访问层把它映射到带空格的数据库列。下面分几种常见场景给出具体方案：

1. 手动编写Resolver的场景 #

如果是自己手写GraphQL解析器，你可以先在Schema里定义一个符合规范的字段名（比如小驼峰pokeBall或下划线poke_ball），再在Resolver里完成字段到数据库列的映射：

示例（JavaScript）： #

首先定义GraphQL Schema：

type UserItems {
  pokeBall: String # 符合规范的字段名
  # 其他字段...
}

type Query {
  userItems: [UserItems]
}

然后编写Resolver逻辑：

const resolvers = {
  Query: {
    userItems: async () => {
      // 从数据库查询时直接获取带空格的列
      const dbResult = await db.query('SELECT "Poke ball" FROM user_items');
      return dbResult.rows;
    }
  },
  UserItems: {
    // 把数据库返回的带空格属性映射到GraphQL字段
    pokeBall: (parent) => parent["Poke ball"]
  }
};

之后你就可以用合法字段名执行查询了：

query {
  userItems {
    pokeBall
  }
}

2. 使用ORM/自动Schema生成工具的场景 #

如果用的是Prisma、Hasura这类工具，可以直接通过配置实现字段映射，不用手动写Resolver：

示例（Prisma）： #

在Prisma Schema里用@map指令指定数据库列名：

model UserItems {
  id        Int     @id @default(autoincrement())
  pokeBall  String  @map("Poke ball") # 直接映射到带空格的数据库列
}

生成的GraphQL Schema会自动用pokeBall作为字段名，查询时直接使用这个字段即可，Prisma会自动处理和数据库列的映射逻辑。

示例（Hasura）： #

在Hasura控制台的表配置页面，找到"Poke ball"列，修改它的GraphQL字段名为poke_ball或pokeBall，保存后就能用新字段正常查询了。

3. SQL查询层面的处理 #

如果是直接编写SQL语句，可以给带空格的列名加数据库支持的引号（不同数据库语法略有区别），并通过AS别名转换成合法名称：

-- PostgreSQL使用双引号
SELECT "Poke ball" AS poke_ball FROM user_items;

-- MySQL使用反引号
SELECT `Poke ball` AS poke_ball FROM user_items;

这样返回的结果里字段名就是poke_ball，可以直接对应到GraphQL的合法字段。

总结 #

GraphQL本身不支持带空格的字段名，但通过字段映射的方式完全可以兼容带空格的数据库列。关键是在Schema层用符合规范的命名，在数据访问层做转换映射，既遵守GraphQL的语法规则，又能对接老旧数据库的结构。

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