Contentful GraphQL查询复杂度超限的原因及解决办法

错误信息 #

Query cannot be executed. The maximum allowed complexity for a query is 11000 but it was 12100. Simplify the query e.g. by setting lower limits for collections.

涉及的查询语句 #

query ClassCollection(
  $slug: String
  $limit: Int
) {
  classCollection(
    where: { slug: $slug }
    limit: $limit
  ) {
    items {
      slug
      title
      linkedFrom {
        courseCollection {
          items {
            slug
          }
        }
      }
      filesCollection {
        items {
          title
          asset {
            title
            fileName
            url
            width
            height
            contentType
          }
        }
      }
    }
  }
}

内容模型 #

• Course：包含指向1-10个Class的引用字段
• Class：包含指向1-10个File的引用字段

问题原因 #

Contentful的GraphQL查询复杂度是按理论最大可能返回的条目数计算的，和实际数据量无关：

1. classCollection默认最大返回100条Class（复杂度计算取配置最大值或你设置的limit的较大值）
2. linkedFrom.courseCollection默认最大返回100条Course，计算时按「每个Class对应100条Course」核算，即100*100=10000
3. 加上filesCollection的100*10=1000，再加上基础查询的100，总复杂度12100，刚好超过11000的限制

解决方法 #

方案1：给反向查询的courseCollection设置明确小limit #

因为你的Course最多关联10个Class，所以一个Class最多只会被10个Course引用，直接给courseCollection加limit:10，把这部分复杂度从10000降到100*10=1000，总复杂度降至2100左右，完全符合限制。

修改后的查询：

query ClassCollection(
  $slug: String
  $limit: Int
) {
  classCollection(
    where: { slug: $slug }
    limit: $limit
  ) {
    items {
      slug
      title
      linkedFrom {
        courseCollection(limit:10) { # 新增limit限制
          items {
            slug
          }
        }
      }
      filesCollection {
        items {
          title
          asset {
            title
            fileName
            url
            width
            height
            contentType
          }
        }
      }
    }
  }
}

方案2：缩小classCollection的查询上限 #

如果业务不需要一次性查询大量Class，把$limit设为更小的值（比如20），反向查询复杂度变为20*100=2000，加上files的200，总复杂度2300，也能解决问题。但该方案局限性强，后续若需查询更多Class仍会触发超限。

方案3：前端手动关联数据 #

先单独查询classCollection获取所有Class数据，再查询courseCollection获取所有Course数据，最后在JavaScript里通过Class的slug字段，匹配Course中关联的Class完成关联。这种方式完全避开反向查询的高复杂度，但需要额外编写前端关联逻辑。

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