Strapi GraphQL自定义Schema报错：practice字段重复定义求助

看起来你遇到的问题是Strapi自动生成的默认GraphQL查询和你自定义的practice字段产生了命名冲突——哪怕你在生成的Schema里只看到一个practice，但在Schema合并过程中，Strapi的默认生成逻辑其实已经悄悄创建了一个同名的查询（对应自动生成的findOne操作），和你自定义的查询撞车了。

下面是具体的解决步骤：

1. 明确禁用默认的Practice查询并替换为自定义实现 #

修改你的Practice模型schema配置文件，确保同时禁用默认的practice（findOne）和practices（findMany）查询，并且注册你的自定义 resolver：

module.exports = {
  query: `
    practice: Practice
  `,
  resolver: {
    Query: {
      // 直接替换默认的practice查询为我们自定义的逻辑
      practice: {
        description: 'Return the practice of the authenticated user',
        resolver: 'Practice.findMine'
      },
      // 彻底禁用默认的批量查询
      practices: false
    }
  }
};

2. 在模型的schema.graphql中明确定义Query扩展 #

为了确保全局Schema合并时不会出现歧义，在./src/api/practice/schema.graphql中手动扩展Query类型，只保留你需要的practice字段：

extend type Query {
  practice: Practice
}

# 这里保留你的Practice模型字段定义
type Practice {
  id: ID!
  name: String
  # 其他模型字段...
}

3. 确保自定义Resolver正确实现 #

检查你的Practice.findMine服务是否正确处理了用户认证和数据查询，比如在./src/api/practice/services/Practice.js中：

module.exports = {
  async findMine(ctx) {
    // 校验用户是否已认证
    const authenticatedUser = ctx.state.user;
    if (!authenticatedUser) {
      throw new Error('请先登录后再操作');
    }

    // 根据当前用户关联的Practice ID查询数据
    return strapi.db.query('api::practice.practice').findOne({
      where: { id: authenticatedUser.practiceId }
    });
  }
};

4. 清理缓存并重启服务 #

Strapi的Schema缓存可能会导致旧的配置残留，所以完成修改后：

• 删除项目根目录下的.cache文件夹
• 完全重启Strapi服务

这样就能彻底解决字段重复定义的问题，让你的自定义practice查询正常工作。

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