Salesforce Future 方法详解：Apex 异步编程开发者指南

背景与应用场景

作为一名 Salesforce 开发人员，我们在日常工作中不可避免地会遇到 Salesforce 平台的 Governor Limits (调控器限制)。这些限制是为了保证多租户环境的稳定性和公平性而设定的，涵盖了从 DML 操作次数到 CPU 执行时间等方方面面。在同步执行的 Apex 事务中，一旦代码逻辑变得复杂或数据量增大，就很容易触及这些天花板，导致事务失败并给用户带来糟糕的体验。

为了解决这个问题，Salesforce 提供了 Asynchronous Apex (异步 Apex) 框架。它允许我们将某些耗时或资源密集型的操作放到后台执行，从而将它们从即时的用户事务中分离出来。Future Methods (异步方法) 是 Asynchronous Apex 中最基础、最直接的一种实现方式。它为我们提供了一种简单有效的方法来应对以下常见场景：

1. 从触发器 (Trigger) 中进行外部服务调用 (Callout)

这是一个经典的场景。Salesforce 严格禁止在同一个事务中先执行 DML 操作（如 insert, update），然后再进行外部服务调用 (Callout)。如果你尝试这样做，系统会抛出 System.CalloutException: You have uncommitted work pending. Please commit or rollback before calling out. 的错误。这是因为 Salesforce 无法保证在外部服务响应之前，DML 操作能否成功提交，也无法在外部服务调用失败时回滚数据库更改。使用 @future(callout=true) 注解的 future method 可以完美解决这个问题，它将 callout 操作放入一个独立的、新的事务中执行，从而绕开了“混合 DML”限制。

2. 隔离资源密集型操作

当用户保存一条记录时，有时需要触发一系列复杂的计算、数据处理或级联更新。如果这些操作都在同步事务中完成，用户可能需要等待很长时间才能看到页面的响应，甚至可能因为超出 CPU 时间限制而导致整个操作失败。通过将这些重量级任务封装在 future method 中，我们可以立即完成记录的保存并向用户返回成功信息，而复杂的后台处理则在稍后由系统异步完成，极大地提升了用户体验。

3. 防止事务锁定和提高并发性

在处理具有复杂父子关系或共享关系的对象时，长时间运行的同步事务可能会锁定大量记录，从而阻塞其他用户或自动化流程对这些记录的访问。将部分非核心的、可以延迟处理的逻辑移入 future method，可以缩短主事务的执行时间，更快地释放记录锁，从而提高系统的整体并发处理能力。

原理说明

Future method 的核心在于其声明和执行机制。从本质上讲，它就是一个被特殊注解标记的 Apex 静态方法，Salesforce 平台会以特殊的方式处理对它的调用。

核心注解：`@future`

要将一个方法定义为 future method，你必须在方法签名前加上 @future 注解。这个注解告诉 Apex 编译器和运行时环境：当这个方法被调用时，不要立即执行它，而是将这个方法调用请求序列化并放入一个异步处理队列中。Salesforce 系统会根据服务器资源的可用性，在稍后的某个时间点从队列中取出该请求，并在一个全新的、独立的事务中执行它。

方法签名要求

一个合格的 future method 必须遵循以下严格的规则：

必须是静态 (static) 方法：因为方法是在没有原始对象实例上下文的情况下被系统异步调用的，所以它必须是静态的。
必须返回 void 类型：异步操作的本质决定了调用者无法立即获得返回值。当你调用一个 future method 时，代码会立即继续执行下一行，而不会等待 future method 完成。因此，它不能有返回值。
参数类型限制：这是 future method 最重要的一个限制。它的参数只能是原始数据类型 (Primitive Data Types)，如 Integer, String, Boolean, ID 等，或者是这些原始数据类型的数组 (arrays) 或集合 (collections)，如 List 或 Set。

为什么不能传递 sObject？ 你不能直接将一个 sObject (标准或自定义对象) 实例（如 Account 或 Contact）作为参数传递给 future method。原因是，在你调用 future method 和它实际执行之间可能存在延迟。在这段延迟期间，你传递的 sObject 记录在数据库中的状态可能已经被其他用户或流程修改了。如果 future method 使用的是调用时那个“过时”的 sObject 状态，就会导致数据不一致甚至逻辑错误。因此，最佳实践是只传递记录的 ID，然后在 future method 内部根据这个 ID 重新查询最新的记录数据，以确保处理的是当前最新的信息。

`(callout=true)` 参数

如果你的 future method 需要执行对外部 Web 服务的调用，你必须在注解中明确指出这一点，即使用 @future(callout=true)。这会告知 Salesforce 将此任务分配给能够执行外部调用的资源池。如果一个 future method 尝试进行 callout 但没有此注解，调用将会失败。

示例代码

下面是一个来自 Salesforce 官方文档的典型示例，演示了如何在一个客户 (Account) 记录被更新时，通过 future method 异步调用一个外部服务来更新所有关联联系人 (Contact) 的信息。

步骤 1: 创建包含 Future Method 的 Apex 类

这个类包含一个静态的、使用 @future(callout=true) 注解的方法。它接收一组客户 ID，然后查询这些客户关联的联系人，并模拟调用外部服务。

public class AccountProcessor {
    // 使用 @future(callout=true) 注解，表示这是一个可以进行外部调用的异步方法
    @future(callout=true)
    public static void processAccounts(Set<Id> accountIds) {
        // 根据传入的 ID 集合，查询需要处理的客户及其关联的联系人
        // 这是一个非常好的 bulkification (批量化) 实践
        List<Account> accounts = [SELECT Id, Name, (SELECT Id, Name, Email FROM Contacts) 
                                  FROM Account WHERE Id IN :accountIds];

        // 准备一个虚拟的外部服务请求
        HttpRequest request = new HttpRequest();
        request.setEndpoint('https://api.example.com/update_contacts');
        request.setMethod('POST');
        // 在真实场景中，你会在这里构建一个包含联系人信息的 JSON body
        // request.setBody(...);
        request.setHeader('Content-Type', 'application/json;charset=UTF-8');

        // 发送请求
        Http http = new Http();
        try {
            // 在 future method 中执行 callout
            HttpResponse response = http.send(request);
            if (response.getStatusCode() == 200) {
                // 处理成功的响应
                System.debug('Callout successful for accounts: ' + accountIds);
            } else {
                // 处理错误的响应
                System.debug('Callout failed with status code: ' + response.getStatusCode());
            }
        } catch (System.CalloutException e) {
            // 捕获和处理 callout 异常
            System.debug('Callout error: ' + e.getMessage());
        }
    }
}

步骤 2: 创建一个触发器来调用 Future Method

这个触发器在客户记录更新后启动。它收集所有被更新的客户的 ID，然后调用我们上面创建的 future method。

trigger AccountTrigger on Account (after update) {
    // 创建一个 Set 来收集所有被更新的客户记录的 ID
    // 使用 Set 可以自动去重，这是一个好习惯
    Set<Id> accountIds = new Set<Id>();

    // 遍历触发器上下文中的所有新记录
    for (Account acc : Trigger.new) {
        // 这里可以添加一些逻辑判断，例如仅当特定字段变更时才调用
        // if (acc.Some_Field__c != Trigger.oldMap.get(acc.Id).Some_Field__c) {
        //     accountIds.add(acc.Id);
        // }
        accountIds.add(acc.Id);
    }

    // 确保 Set 不为空，避免不必要的 future method 调用
    if (!accountIds.isEmpty()) {
        // 调用 future method，将 DML 事务和 callout 事务分离
        // 调用本身是同步的，但方法的执行是异步的
        AccountProcessor.processAccounts(accountIds);
    }
}

注意事项

1. 调控器限制 (Governor Limits)

Future method 在一个独立的事务中运行，它拥有自己的一套、通常比同步事务更高的调控器限制。例如，它可以执行更多的 SOQL 查询和 DML 语句。然而，调用 future method 本身也受到限制。在一个同步事务中（例如，一个触发器的执行上下文），你最多只能调用 50 个 future method。此外，整个组织在 24 小时内可以执行的 future method 数量也是有限的，具体取决于你的 Salesforce 版本。

2. 不保证执行顺序

如果你在同一个事务中调用了多个 future method，Salesforce 不保证它们会按照你调用的顺序执行。它们的执行时间取决于系统资源的调度。如果你的业务逻辑要求任务必须按顺序执行，那么 future method 不是一个好的选择。在这种情况下，你应该考虑使用 Queueable Apex，因为它支持任务链（chaining）。

3. 不能调用另一个 Future Method

你不能从一个 future method 内部直接或间接地调用另一个 future method。这样做会导致运行时错误。这个限制是为了防止出现无限递归的调用链，从而耗尽系统资源。同样，如果需要链式处理，请使用 Queueable Apex。

4. 测试 Future Methods

测试异步代码需要一种特殊的方式。你必须将调用 future method 的代码包含在 Test.startTest() 和 Test.stopTest() 代码块之间。Test.startTest() 为你的测试代码提供了一组新的调控器限制，而 Test.stopTest() 会强制所有在 startTest() 之后被调用的异步作业（包括 future methods）立即同步执行。这使得你可以在测试方法的后续部分对异步操作的结果进行断言 (assert)。

示例测试代码：

@isTest
private class AccountProcessorTest {
    @isTest
    static void testProcessAccountsCallout() {
        // 准备测试数据
        Set<Id> accountIds = new Set<Id>();
        List<Account> testAccounts = new List<Account>();
        for(Integer i=0; i<5; i++) {
            testAccounts.add(new Account(Name='Test Account ' + i));
        }
        insert testAccounts;

        for(Account acc : testAccounts) {
            accountIds.add(acc.Id);
        }

        // 设置一个模拟的 Callout 响应
        Test.setMock(HttpCalloutMock.class, new MockHttpResponseGenerator());
        
        // 开始测试异步执行
        Test.startTest();
        
        // 调用 future method
        AccountProcessor.processAccounts(accountIds);
        
        // 停止测试，这会强制 future method 立即执行
        Test.stopTest();
        
        // 在这里，你可以添加断言来验证 future method 的结果
        // 例如，查询数据库中的记录状态，或者验证 callout 是否被调用
        // System.assertEquals(...);
    }
}

总结与最佳实践

Future method 是 Salesforce 异步 Apex 工具箱中一个简单而强大的工具。它非常适合用于将耗时的操作、尤其是外部服务调用，从同步事务中解耦出来，以优化性能和用户体验。

最佳实践总结：

批量化 (Bulkify) 你的方法：始终设计你的 future method 来处理记录集合（如 List 或 Set），而不是单个记录。这可以让你在一次执行中处理多达 200 条记录（触发器的批次大小），从而大大减少 future method 的调用次数，避免触及调用限制。
传递 ID，而不是 sObject：如前所述，始终只传递记录的 ID，并在 future method 内部重新查询记录，以获取最新数据并避免数据不一致的问题。
保持幂等性 (Idempotent)：在可能的情况下，将你的 future method 设计为幂等的。幂等性意味着即使方法被意外地多次执行（例如，在某些重试机制下），只要输入相同，结果也总是一样的。这会使你的系统更加健壮。
了解其局限性：清楚地认识到 future method 的局限性——不支持链式调用、不保证执行顺序、无法获取 job ID、参数类型受限。当你的需求超出这些限制时，应果断选择更高级的异步工具。
选择正确的工具：
- 需要链式调用、传递复杂对象或获取任务状态？使用 Queueable Apex。
- 需要处理海量数据（数万到数百万条记录）？使用 Batch Apex。
- 需要按固定时间表运行任务？使用 Schedulable Apex。
- 只需要一个简单的“即发即忘”的后台任务，特别是用于 callout？Future Method 是一个绝佳的起点。

总而言之，作为一名 Salesforce 开发人员，熟练掌握 future method 是构建可扩展、高性能应用程序的基础。理解其工作原理、适用场景和局限性，将帮助你做出更明智的架构决策，并编写出更优雅、更高效的 Apex 代码。

精通 Salesforce Email Studio：咨询顾问指南之 AMPscript 与数据扩展实现动态个性化邮件

十月 07, 2025

阅读全文

Salesforce中文网