使用Chillicream StrawberryShake编译两个GraphQL客户端失败求助

问题根源 #

两个GraphQL API生成的客户端代码中，筛选、排序相关的类型（如IntOperationFilterInput、IStringOperationFilterInputInfo）名称重复，加上.graphqlrc.json的命名空间配置未生效，导致编译时出现类型冲突、接口重复实现等错误。

解决方案 #

1. 确保命名空间配置正确生效

每个服务文件夹下的.graphqlrc.json必须明确指定唯一命名空间，且配置文件需与该文件夹内的.graphql文件同级：

// ServiceA文件夹下的.graphqlrc.json
{
  "schema": "schema.graphql",
  "documents": "*.graphql",
  "extensions": {
    "strawberryshake": {
      "name": "ServiceAClient",
      "namespace": "YourApp.Services.ServiceA",
      "url": "https://api-service-a.com/graphql",
      "dependencyInjection": true
    }
  }
}

// ServiceB文件夹下的.graphqlrc.json
{
  "schema": "schema.graphql",
  "documents": "*.graphql",
  "extensions": {
    "strawberryshake": {
      "name": "ServiceBClient",
      "namespace": "YourApp.Services.ServiceB",
      "url": "https://api-service-b.com/graphql",
      "dependencyInjection": true
    }
  }
}

• 删除已生成的ClientX.cs等文件，在每个文件夹下执行dotnet graphql generate重新生成代码，确保生成的类使用指定的命名空间。

2. 用前缀/后缀区分重复类型

若两个API的类型名称完全一致，可通过typePrefix或typeSuffix给生成的类型添加标识，彻底避免冲突：

// 在strawberryshake扩展中添加
"strawberryshake": {
  // ...其他配置
  "typePrefix": "ServiceA_"
}

生成的类型会变为ServiceA_IntOperationFilterInput，与另一个服务的类型完全区分。

3. 配置项目文件确保多文件夹代码生成隔离

在项目的.csproj文件中，明确指定每个文件夹的GraphQL文件及对应配置，避免编译时混用：

<ItemGroup>
  <GraphQLCodegen Include="ServiceA\*.graphql" Config="ServiceA\graphqlrc.json" />
  <GraphQLCodegen Include="ServiceB\*.graphql" Config="ServiceB\graphqlrc.json" />
</ItemGroup>

4. 清理缓存并重新编译

• 删除项目的obj和bin文件夹，清理编译缓存
• 执行dotnet restore恢复依赖
• 再次在每个文件夹下执行dotnet graphql generate，然后编译项目

5. 排查命名空间未生效的原因

• 确认.graphqlrc.json与目标.graphql文件在同一目录
• 检查dotnet graphql init命令是否使用了--namespace参数，该参数会覆盖配置文件中的设置，需确保每个服务执行命令时指定不同的命名空间，或完全依赖配置文件。

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