GraphQL语法错误求助：Expected Name, found ')' 问题排查

DevOps 小满

2026-8-2

解决GraphQL语法错误：Expected Name, found ")"

1. 语法错误的直接原因及修复

你的typeDefs中存在一个未被使用的冗余CustomerService类型，其中的findAll()字段写法违反了GraphQL SDL语法规则：

在GraphQL对象类型的字段定义中，无参数的字段不能加括号，括号仅用于包裹参数定义。
更关键的是，这个CustomerService类型在Resolver、Query和Mutation逻辑中完全没有被引用，属于无效定义。

修复方案：删除冗余的`CustomerService`类型

修改后的typeDefs如下：

import gql from 'graphql-tag';

const typeDefs = gql`
  type Query {
    customers: [CustomerEntity]
    customer(id: String!): CustomerEntity
  }

  type Mutation {
    createCustomer(input: CreateCustomerInput!): CustomerEntity
    updateCustomer(id: String!, input: UpdateCustomerInput!): CustomerEntity
    deleteCustomer(id: String!): Boolean
  }

  type CustomerEntity {
    id: String
    firstName: String
    lastName: String
    email: String
    # 若需暴露password和sales字段，可在此补充定义
    # password: String
    # sales: [Sales]
  }

  input CreateCustomerInput {
    firstName: String!
    lastName: String!
    email: String!
    password: String!
  }

  input UpdateCustomerInput {
    firstName: String
    lastName: String
    email: String
    password: String
  }
`;

export default typeDefs;

2. 同步修复类型不匹配问题

除语法错误外，代码中存在类型定义与服务实现不匹配的问题，会导致后续运行时错误：

服务层CustomerEntity包含firstName、lastName、password字段，但原typeDefs仅定义了name，需同步更新CustomerEntity的字段定义。
原输入类型CreateCustomerInput、UpdateCustomerInput使用name字段，但服务实际接收firstName、lastName、password，需同步修改输入类型的字段定义。