GitHub GraphQL 如何固定指定仓库实现Issues搜索过滤条件变量化

你之前尝试的两种写法失效，本质上都踩到了GraphQL和GitHub API的固定规则：

• 在静态字符串字面量中嵌入变量的写法完全不符合GraphQL语法规范：GraphQL解析器只会识别参数值位置直接引用的变量，双引号包裹的字符串属于静态常量内容，字符串内部的$query会被当成普通文本直接传给接口，根本不会触发变量替换逻辑，所以"repo:spring-projects/spring-boot in:title $query"这种写法永远无法正常生效。
• GitHub GraphQL的search接口本身没有独立的repo参数：该接口的设计规则是所有搜索范围、过滤条件必须整合在query字符串字段中传入，schema层面不存在单独接收仓库标识的参数，所以你预想的search(repo: "xxx", query: $query)写法会直接触发参数不存在的报错。

你可以完全依托GraphQL原生的变量能力，实现固定仓库范围、动态传入过滤条件的目标，不需要零散的手动拼接逻辑，核心思路是利用GraphQL的变量默认值机制固化固定逻辑，把动态部分作为独立变量透传：

1. 在查询定义阶段，把固定的仓库范围、搜索类型、返回条数等不常变动的配置，设置为带默认值的GraphQL变量，不需要每次请求动态传入。
2. 仅把需要灵活调整的过滤条件作为必须传入的动态变量，和固定配置解耦。
3. 把固定配置和动态过滤条件的拼接逻辑收敛到GraphQL客户端的全局拦截层，不需要在业务代码中零散手动拼接。

可直接使用的查询写法如下：

query IssueRepoSearch(
  # 固定仓库片段设为变量默认值，无需动态修改
  $repoScope: String! = "repo:spring-projects/spring-boot",
  # 动态传入的过滤条件，可按实际搜索需求赋值
  $filterCondition: String!,
  # 固定搜索类型为Issue
  $searchType: SearchType! = ISSUE,
  # 固定返回结果数量
  $resultCount: Int! = 3
) {
  search(
    query: $fullSearchQuery,
    type: $searchType,
    first: $resultCount
  ) {
    edges {
      node {
        ... on Issue {
          number
          title
          repository {
            name
          }
        }
      }
    }
  }
}

对应的客户端拦截层只需要写一次通用拼接逻辑：自动把$repoScope和$filterCondition用空格连接，生成完整的$fullSearchQuery值传入接口。这个逻辑是全局复用的，你在实际业务调用时完全不需要感知拼接过程，只需要传入动态的过滤条件即可，示例传参：

{
  "filterCondition": "in:title fonts"
}

系统会自动拼接成接口可识别的完整搜索字符串repo:spring-projects/spring-boot in:title fonts，达到你预期的搜索效果。

• 这种方式完全复用了GitHub search接口的全部高级过滤能力，和你最初硬编码查询字符串的检索效果完全一致，不会因为参数解耦损失搜索灵活性。
• 对比直接调用repository接口拉取全量Issues的实现，该方案支持所有GitHub搜索规则的复杂过滤能力（比如标题匹配、标签筛选、作者过滤等），不需要客户端侧做二次数据筛选。
• 所有固定逻辑都收敛在查询定义和全局封装层，不需要每次写业务逻辑时手动拼接字符串，也避免了变量嵌入静态字符串不生效的常见问题。

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