Strawberry GraphQL 中自定义指令导致扩展重复加载问题解析

在 GraphQL 开发中，Strawberry 是一个基于 Python 的类型安全 GraphQL 服务框架。最近发现了一个关于 Schema 扩展加载的重要问题：当 Schema 中包含自定义指令时，所有扩展会被重复加载两次，这可能导致性能问题和不可预期的行为。

问题本质

在 Strawberry 的 schema.py 文件中，get_extensions 方法负责加载所有 Schema 扩展。当存在自定义指令时，该方法会先将基础扩展和指令扩展合并，然后又错误地再次追加基础扩展，导致所有扩展被重复加载。

技术细节分析

原始代码逻辑存在一个明显的集合操作问题：

1. 首先通过解包操作 [*self.extensions, DirectivesExtension...] 创建新列表
2. 然后又通过 extend 方法再次追加相同的 self.extensions
3. 最终导致每个扩展在列表中出现了两次

这种重复加载不仅浪费资源，在某些情况下还可能导致扩展逻辑被重复执行，产生副作用。

解决方案

修复方案非常简单直接：移除多余的 extend 调用。这样就能确保：

• 基础扩展只加载一次
• 指令扩展被正确添加
• 整体逻辑保持清晰

影响范围

这个问题会影响所有使用以下特性的 Strawberry 项目：

• 自定义 GraphQL 指令
• Schema 扩展功能
• 需要精确控制扩展加载顺序的场景

最佳实践建议

开发者在使用 Strawberry 的自定义指令功能时，应当：

1. 检查扩展的加载次数是否符合预期
2. 确保扩展中的初始化逻辑能够处理可能的重复调用
3. 在升级到修复版本后验证相关功能

这个问题的修复体现了框架开发中对细节的关注，也提醒我们在集合操作时要特别注意避免重复元素的问题。