SOQL-Lib项目中的集合迭代修改问题分析与解决方案

SOQL-Lib项目中的集合迭代修改问题分析与解决方案

soql-lib The SOQL Lib provides functional constructs for SOQL queries in Apex. 项目地址: https://gitcode.com/gh_mirrors/so/soql-lib

问题背景

在SOQL-Lib项目中，开发者在API版本62环境下运行时遇到了一个关键异常："System.FinalException: Cannot modify a collection while it is being iterated"。这个错误发生在尝试对正在迭代的集合进行修改时，是Salesforce平台从API版本61开始引入的一项安全限制。

技术原理

在Apex编程中，集合(Collection)的迭代和修改操作存在一个重要的并发控制问题。当使用for循环遍历一个集合时，如果同时在循环体内尝试修改这个集合(如添加、删除元素)，就会导致不可预期的行为。Salesforce从API版本61开始明确禁止这种操作，抛出FinalException异常来强制开发者遵循最佳实践。

问题表现

在SOQL-Lib项目中，这个问题具体表现在两个测试方法中：

1. countSObjectFieldWithDefaultFields方法
2. groupByWithDefaultFields方法

错误堆栈显示问题源于SoqlFields类的removeNotGroupedFields方法，该方法在集合迭代过程中尝试修改同一个集合。

解决方案

临时解决方案

最简单的临时解决方案是将项目的API版本降级到60或以下，因为这个问题只在API版本61及以上才会出现。但这只是一个权宜之计，不是长期解决方案。

永久解决方案

正确的做法是重构代码，避免在迭代过程中修改集合。通常有以下几种实现方式：

1. 创建副本法：先创建集合的副本，迭代副本而修改原集合
2. 标记删除法：先标记要删除的元素，迭代完成后再统一删除
3. 使用迭代器：利用迭代器的remove方法(如果可用)

在SOQL-Lib项目中，开发团队已经提交了修复代码，采用了更安全的集合操作方式，确保在API版本62及更高版本中也能正常运行。

最佳实践建议

1. 在迭代集合前，先确定是否需要修改集合
2. 如需修改，考虑使用上述解决方案中的一种
3. 在开发过程中使用最新API版本进行测试，尽早发现这类兼容性问题
4. 编写单元测试时，应覆盖各种API版本下的行为

总结

集合迭代时的修改问题是Apex开发中常见的陷阱之一。SOQL-Lib项目遇到的这个问题提醒我们，随着Salesforce平台的演进，API行为可能会发生变化，开发者需要及时调整代码以适应这些变化。通过采用正确的集合操作模式，不仅可以避免运行时异常，还能提高代码的健壮性和可维护性。

soql-lib The SOQL Lib provides functional constructs for SOQL queries in Apex. 项目地址: https://gitcode.com/gh_mirrors/so/soql-lib