Apollo iOS 项目中合并源重复问题的技术分析

问题背景

在 Apollo iOS 项目中，开发者发现了一个长期存在的 bug：在生成的代码中，__mergedSources 数组偶尔会出现重复条目。这个问题最早可以追溯到 1.2.0 版本，而在 1.7.1 版本中变得尤为明显。

问题表现

生成的 Swift 代码中，__mergedSources 数组会出现完全相同的类型重复出现，例如：

public static var __mergedSources: [any ApolloAPI.SelectionSet.Type] { [
  UserListItemFragment.self,
  AvatarFragment.self,
  FeedItemFragment.AsFollowRecommendationFeedItem.Followee.AsUser.self,
  FeedItemFragment.AsFollowRecommendationFeedItem.Followee.AsUser.self
] }

问题复现条件

通过开发者社区的协作研究，发现这个问题在特定条件下可以稳定复现：

1. 查询响应选择集中同时包含联合类型的行内片段和命名片段
2. 这些片段都依赖于相同的底层类型

典型的问题查询结构如下：

... on MyUnionType {
  ... on User { 
    # 选择集内容
  }
  ... UserListItemFragment
}

其中 MyUnionType 是一个包含 User 类型的联合类型，而 UserListItemFragment 是一个在 User 类型上定义的命名片段。

技术分析

经过深入调试和分析，开发团队发现：

1. mergedSources 是一个 OrderedSet<IR.MergedSelections.MergedSource> 类型
2. 问题根源可能在于类型信息或片段来源虽然不同，但最终解析为相同的选择集名称
3. 这表明选择集名称的解析过程可能存在缺陷

调试日志显示，相同的合并源会被多次添加到集合中：

Sources: OrderedSet<MergedSource>([
    [[Object - User]], fragment: UserListItemFragment on Object - User, 
    [[Interface - Actor]], fragment: AvatarFragment on Interface - Actor, 
    [[Union - FeedItem -> Object - FollowRecommendationFeedItem] -> [Union - Followable -> Object - User]], fragment: FeedItemFragment on Union - FeedItem, 
    [[Union - FeedItem -> Object - FollowRecommendationFeedItem] -> [Union - Followable -> Object - User]], fragment: FeedItemFragment on Union - FeedItem
])

临时解决方案

开发者发现可以通过重构查询结构来避免这个问题：

...on MyUnionType {
  ... on User {
    ...UserListItemFragment
  }
}

这种结构将命名片段嵌套在类型条件片段内部，避免了重复合并源的问题。

问题状态

虽然问题的根本原因尚未完全确定，但开发团队推测近期关于字段合并的工作可能间接修复了这个问题。目前该问题已被关闭，团队将持续关注是否会在新版本中再次出现。

对于遇到类似问题的开发者，建议：

1. 尝试使用上述的查询结构重构方案
2. 升级到最新版本观察问题是否已解决
3. 如果问题仍然存在，可以提供详细的复现案例帮助开发团队进一步调查