應用場景

異步調用適用的場景示例如下：

• 音視頻處理

  用戶使用函數計算處理音視頻業務時，涉及處理編碼、解碼或轉碼等耗時較長的任務，異步調用這些任務使其在后臺運行，前端無需等待，提升用戶體驗。另外，如果音視頻項目較大，需要將其分割成多個任務并行處理或者需要將一個視頻轉換為多種格式，異步調用多個函數可以輕松實現以上并行處理需求，縮短任務處理時間。

• 數據ETL處理

  ETL流程中，從源頭提取數據、轉換處理和加載到目標系統這三個步驟可能涉及多個獨立的操作，例如數據庫查詢、文件讀寫或數據清洗等，采用異步調用可以讓這些操作并行執行，減少處理時間，提升系統性能。而針對耗時較長的任務，例如處理大規模數據集或復雜的數據轉換，異步調用允許這些任務在后臺運行，前端無需等待，提升用戶體驗。

• 開發Web應用

  函數計算可以搭配其他云產品快速構建Web應用。用戶在表單提交、搜索查詢或加載內容較多的情況下，采用異步調用可以避免頁面因長時間等待后端響應而出現的卡頓現象，此時用戶可以繼續與頁面的其他部分交互，而不會感受到延遲。高并發場景下，例如大量用戶同時訪問，異步調用函數又可以分散請求壓力，防止服務過載。

延遲調用

針對某些場景，您提交一次異步調用后，需要函數計算對其進行延遲觸發。您可以通過調用API（SDK）實現延遲調用函數。

在代碼中添加HTTP請求頭x-fc-async-delay，取值范圍為(0,3600)，單位為秒。函數計算將從您觸發執行開始計算，延遲x-fc-async-delay設置的時間后觸發函數調用。

重試策略

異步調用機制提供錯誤處理和重試機制，如果某個步驟失敗，可以重新調度該任務而不影響整個流程。當函數異步調用執行失敗后，函數計算會自動進行錯誤重試。

重試機制

對于常見錯誤，系統默認的重試策略如下表所示。

配置重試策略

函數計算支持自定義重試次數和消息最大存活時長。

1. 登錄函數計算控制臺，在左側導航欄，單擊函數。

2. 在頂部菜單欄，選擇地域，然后在函數頁面，單擊目標函數。

3. 在函數詳情頁面，選擇配置頁簽，然后在左側導航欄，選擇異步配置，在異步配置區域，單擊編輯。

4. 在異步配置面板，設置以下配置項，然后單擊部署。

   配置項	解釋說明
   任務模式	是否開啟異步任務模式，請參見異步任務。
   最大重試次數	用于配置異步調用流程中的消息最大重試次數，取值范圍為[0,8]。 函數計算在默認情況下，對異步觸發失敗的消息進行3次重試，您可以根據業務需求減少或增加對異步調用的重試。
   消息最大存活時長	用于配置異步調用流程中的消息最大存活時長，取值范圍[1,604800]，默認為86400，單位為秒。 該時長從觸發異步調用時開始計算，如果超過配置的消息最大存活時長，該條消息將被丟棄。未被消費的消息將計入云監控異步調用觸發事件（次）指標。關于指標詳情，請參見監控指標。

結果回調

函數計算接收異步調用請求后，將請求持久化后會立即返回響應，無需等待請求執行完成。如您需要保留執行失敗且超過最大重試次數被丟棄的請求，或通知下游異步調用結果，可以通過配置結果回調功能實現。配置異步目標服務后，異步調用請求執行完成，函數計算根據執行結果自動回調對應的服務。

功能原理

結果回調流程如下圖所示。

適用場景

• 保存丟棄的事件供后續使用

  當異步請求執行失敗，并且按照指定的策略重試后仍然失敗，函數計算將丟棄該請求。如果您配置了失敗目標，函數計算將自動把失敗請求的上下文信息推送到消息隊列 RocketMQ 版等消息服務中，以便后續處理。您也可以將目標服務設置為另一個函數，函數計算將自動把失敗請求的上下文信息推送到該函數，執行您自定義的錯誤處理邏輯。

• 自動通知下游服務執行結果

  請求執行成功后，如果您配置了成功目標，函數計算系統會自動將成功請求的上下文信息推送到下游目標服務。例如，您配置了使用函數計算實現自動解壓上傳到OSS的ZIP文件，解壓完成后想要接收消息通知，可采用為目標函數配置異步調用結果回調目標服務。

支持的異步調用目標服務

異步調用目標服務的配置說明如下：

• 異步調用目標的事件內容

  輕量消息隊列（原 MNS）、函數計算或消息隊列 RocketMQ 版作為函數異步調用目標時，事件內容示例如下。

  {
    "timestamp": 1660120276975,
    "requestContext": {
      "requestId": "xxx",
      "functionArn": "acs:fc:{regionid}:{accountid}:functions/xxxx",
         "condition": "FunctionResourceExhausted", 
          "approximateInvokeCount": 3
    },
    "requestPayload": "",
    "responseContext": {
      "statusCode": 200,
      "functionError": ""
    },
    "responsePayload": ""
  }

  表 1. 參數說明

  參數	說明
  timestamp	調用時間戳。
  requestContext	請求上下文。
  requestContext.requestId	異步調用的請求ID。
  requestContext.functionArn	異步執行的函數ARN。
  requestContext.condition	調用錯誤碼。
  requestContext.approximateInvokeCount	異步調用的執行次數。當該值大于1時，說明函數計算對您的函數進行了重試。
  requestPayload	請求函數的原始負載。
  responseContext	返回上下文。
  responseContext.statusCode	調用函數的返回碼（系統）。當該返回碼不為200時，說明出現了系統錯誤。
  responseContext.functionError	調用錯誤信息。
  responsePayload	執行函數返回的原始負載。

  事件總線 EventBridge作為函數異步調用目標時，事件示例如下。具體信息，請參見事件概述。

  {
      "datacontenttype": "application/json",
      "aliyunaccountid": "143xxxx",
      "data": {
          "requestContext": {
              "condition": "",
              "approximateInvokeCount": 1,
              "requestId": "0fcb7f0c-xxxx",
              "functionArn": "acs:fc:{regionid}:{accountid}:functions/xxxx"
          },
          "requestPayload": "",
          "responsePayload": "",
          "responseContext": {
              "functionError": "",
              "statusCode": 200
          },
          "timestamp": 1660120276975
      },
      "subject": "acs:fc:{regionid}:{accountid}:functions/xxxx",
      "source": "acs:fc",
      "type": "fc:AsyncInvoke:succeeded",
      "aliyunpublishtime": "2021-01-03T09:44:31.233Asia/Shanghai",
      "specversion": "1.0",
      "aliyuneventbusname": "xxxxxxx",
      "id": "ecc4865xxxxxx",
      "time": "2021-01-03T01:44:31Z",
      "aliyunregionid": "cn-shanghai-vpc",
      "aliyunpublishaddr": "199.99.xxx.xxx"
  }

• 負載限制

  支持的異步調用目標服務負載的最大限制如下：

  • 輕量消息隊列（原 MNS）：64 KB

  • 函數計算：128 KB

  • 事件總線 EventBridge：64 KB

  • 消息隊列 RocketMQ 版：4 MB

• 避免循環調用

  當您在配置異步執行目標時，請確保不要出現循環調用的情況。例如，您為函數A配置了成功調用時的異步目標為函數B，為函數B配置了成功調用時的異步目標為函數A。當您異步觸發函數A并且執行成功后，則可能出現A到B，再到A的循環調用的情況。

常見問題

如何觸發函數的異步調用？

您可以通過以下方式對函數計算的函數發起一次異步調用。

• 登錄函數計算控制臺，找到目標函數，然后在測試頁簽，勾選我想通過異步的方式進行調用。

  

• 調用InvokeFunction - 調用函數接口，設置參數x-fc-invocation-type的值為Async。

• 使用Serverless Devs工具配置異步調用，設置參數invocation-type的值為Async，詳情請參見調用函數。

• 創建支持異步調用的觸發器異步觸發函數，詳情請參見事件觸發。

后續操作

如果您希望獲得函數異步請求各個階段的狀態，可通過開啟任務模式來實現，具體信息，請參見異步任務。