SOQL-Lib 5.0.0版本中模拟查询非可写字段的问题解析

SOQL-Lib 5.0.0版本中模拟查询非可写字段的问题解析

问题背景

在SOQL-Lib 5.0.0版本中，开发者在使用模拟查询功能时遇到了一个关键问题：当尝试模拟查询包含非可写字段（如User对象的Name字段）时，系统会抛出System.SObjectException: Invalid field Name for User异常。这个问题主要出现在stripAdditionalPlainFields私有方法中，该方法试图通过var.put方法重新创建SObject。

问题分析

核心问题

问题的根源在于Salesforce平台对某些标准对象字段的写权限限制。特别是User对象的Name字段虽然是可查询的，但却是不可直接写入的。在SOQL-Lib的模拟查询实现中，原始代码尝试使用put方法设置这些字段值，导致了异常。

技术细节

原始实现中，stripAdditionalPlainFields方法的工作流程是：

1. 获取模拟记录的所有填充字段
2. 创建一个新的SObject实例
3. 使用put方法逐个设置请求的字段值

这种方法对于大多数标准对象和自定义对象有效，但对于User等特殊对象就会失败，因为它们的某些字段虽然是可查询的，但不可写。

解决方案探索

临时解决方案

一位开发者提出了使用JSON序列化/反序列化的替代方案：

1. 获取模拟记录的填充字段映射
2. 筛选出请求的字段
3. 通过JSON转换创建只包含请求字段的新记录

这种方法绕过了直接使用put方法，避免了写权限问题。

官方修复方案

项目维护者最终采用了更全面的修复方案，主要改进包括：

1. 识别并跳过不可写字段
2. 确保Id字段正确处理
3. 完善测试用例覆盖特殊场景

相关注意事项

1. Id字段处理：在模拟查询中，Id字段需要特殊处理，因为即使查询中不显式包含Id字段，它也可能被隐式包含。

2. 性能考量：JSON序列化/反序列化虽然解决了问题，但可能带来性能开销，需要权衡。

3. 测试覆盖：这个问题暴露了测试用例的不足，特别是对特殊对象字段权限的测试。

最佳实践建议

1. 在使用模拟查询时，明确指定所需字段，避免隐式依赖。

2. 对于User等特殊对象，特别注意字段的读写权限。

3. 在单元测试中，覆盖各种字段组合场景，包括只读字段的查询。

4. 升级到修复后的版本时，仔细检查现有测试用例，确保兼容性。

总结

SOQL-Lib 5.0.0版本中的这个bug提醒我们，在开发通用工具库时需要特别注意Salesforce平台的特殊性，特别是标准对象字段权限的差异。通过这个问题，我们也看到了开源社区协作解决问题的典型流程：问题报告、临时解决方案、官方修复和测试完善。