Function Compute：HTTP觸發器概述

注意事項

• 如果您的HTTP觸發器為匿名觸發器，即觸發器配置中認證方式選擇為無需認證，則無需驗證身份，任何人都可以發送HTTP請求調用您的函數，存在URL泄露的風險。此時，您可以設定檢查請求訊息頭部欄位Authorization是否合法來進行鑒權驗證，避免URL泄露。更多資訊，請參見簽名認證。

• 根據國家網路安全監管要求，自2024年06月10日起，新建立的HTTP觸發器將禁止通過公網訪問地址下載APK檔案（MIMETYPE為application/vnd.android.package-archive），APK檔案下載訪問將直接返回400錯誤碼。更多資訊，請參見如何確保HTTP觸發器公網訪問地址正常返回.apk檔案。

• VIP（虛擬IP地址）輪換機制。

  Function Compute服務為了增加系統韌性和服務穩定性，一直以來均實施VIP（虛擬IP地址）輪換機制。這意味著，作為我們基礎設施健壯性的一部分，HTTP觸發器所提供的公網／內網訪問地址所對應的VIP地址將會不定期地進行輪換。

  特別提醒您，直接寫入程式碼VIP地址可能會引發服務中斷，強烈建議通過自訂網域名方式訪問，確保業務的健壯性。注意，因不當使用VIP引發的故障不在Function Compute產品賠付範疇內，請您檢查並調整為正確使用方式。

  您可以使用自訂網域名配合CNAME來正確訪問Function Compute。更多資訊，請參見配置自訂網域名。

使用限制

在配置和使用HTTP觸發器前，您需要瞭解HTTP觸發器的使用限制和支援的HTTP/HTTPS、WebSocket以及gRPC協議的使用限制。

觸發器限制

• 非Web Server模式的Custom Container函數不支援建立HTTP觸發器。

• 函數設定HTTP觸發器後不能再設定其他類型的觸發器。

• 針對一個版本或一個別名，最多隻能建立一個HTTP觸發器。詳細資料，請參見管理版本和管理別名。

• HTTP觸發器預設提供的內建網域名稱只用來提供測試服務，請不要用於對外的線上服務，避免因內建網域名稱提供服務的穩定性影響您的線上服務。

  說明

  對外提供網站類型服務只能通過已備案網域名稱來實現。即通過配置自訂網域名，將網域名稱與函數進行綁定，使用自己的網域名稱對外提供服務。更多資訊，請參見配置自訂網域名。

HTTP/HTTPS協議使用限制

• HTTP Request限制

  • Request Headers不支援以x-fc-開頭的自訂欄位和connection、keep-alive自訂欄位。

  • 如果Request超過以下限制，會返回400狀態代碼和InvalidArgument錯誤碼。

    • Headers大小：Headers中的所有Key和Value的總大小不得超過8 KB。

    • Path大小：包括所有的Query Params，Path的總大小不得超過8 KB。

    • Body大小：同步調用請求的Body的總大小不得超過32 MB，非同步呼叫請求的Body的總大小不得超過128 KB。

• HTTP Response限制

  • Response Headers不支援以x-fc-開頭的自訂欄位和connection、content-length、date、keep-alive、server、upgrade、content-disposition:attachment自訂欄位。

  說明

  從安全形度考慮，使用Function Compute預設的aliyuncs.com網域名稱，服務端會在Response Headers中強制添加content-disposition: attachment欄位，此欄位會使得返回結果在瀏覽器中以附件的方式下載。如果要解除該限制，需設定自訂網域名。更多資訊，請參見配置自訂網域名。

  • 如果Response超過以下限制，會返回502狀態代碼和BadResponse錯誤碼。

    • Headers大小：Headers中的所有Key和Value的總大小不得超過8 KB。

WebSocket協議使用限制

• Runtime支援：僅Custom Runtime和Custom Container支援WebSocket協議。

• 逾時時間限制：WebSocket請求受函數配置的逾時時間限制。

• WebSocket握手的Request限制：

  • Request Headers不支援以x-fc-開頭的自訂欄位。

  • Headers大小：Headers中的所有Key和Value的總大小不得超過8 KB。

  • Path大小：包括所有的Query Params，Path的總大小不得超過8 KB。

  • Body：WebSocket握手請求中不支援發送Body，即使發送，也會被Function Compute系統忽略。

• WebSocket握手的Response限制：

  Response Headers中所有Key和Value的總大小不得超過8 KB，否則會返回502狀態代碼和BadResponse錯誤碼。

• WebSocket資料轉送限制：

  WebSocket連結建立之後，一次發送或接收的資料包（message）最大體積為6 MB。

gRPC協議使用限制

• Runtime支援：僅Custom Runtime和Custom Container支援gRPC協議。

• 使用時的限制：

  • 使用gRPC觸發函數執行前，請確保HTTP觸發器的要求方法中包含POST。

  • 請使用子網域名稱fcapp.run或者自訂網域名發起gRPC調用。

• 逾時時間限制：gRPC請求受函數配置的逾時時間限制，即流式gRPC的連結最長保持時間不得超過函數配置的執行逾時時間。

• gRPC資料轉送限制：gRPC流式連結建立之後，一次發送或接收的資料包（message）最大體積為6 MB。

優勢

HTTP觸發器與API Gateway觸發器均可應用於Web應用的建立。使用方式如下：

• HTTP觸發器：您可以通過綁定自訂網域名，為HTTP函數映射不同的HTTP訪問路徑。詳細資料，請參見配置自訂網域名。

• API Gateway觸發器：您還可以使用API Gateway，後端服務類型選擇Function Compute2.0，函數類型選擇HTTP函數，選擇後端服務地址，實作類別似功能。詳細資料，請參見使用Function Compute作為API後端服務。

相較於API Gateway觸發器，HTTP觸發器有以下優勢。

• 降低開發人員的學習成本和簡化開發人員的調試過程，協助開發人員快速使用Function Compute搭建Web應用和API。

• 減少請求處理環節，HTTP觸發器支援更高效的請求、響應格式，不需要編碼或解碼成JSON格式，效能更優。

• 支援選擇熟悉的HTTP測試載入器驗證Function Compute側的功能和效能。

• 方便對接其他支援Webhook回調的服務，例如CDN回源、MNS等。

• 支援WebSocket和gRPC協議。

調用方式

同步調用

同步調用指事件被函數處理後直接返回結果。HTTP觸發器預設的函數調用方式為同步調用。更多資訊，請參見同步調用。

非同步呼叫

非同步呼叫指Function Compute收到請求後，將請求持久化儲存，然後立即返迴響應，而不是等待請求執行完成後，再返回執行結果。

• 非同步呼叫：觸發HTTP函數時，您可以通過增加要求標頭"X-Fc-Invocation-Type":"Async"的方式實現請求層級的非同步呼叫。

• 非同步任務：HTTP函數配置了非同步任務後，可以通過增加要求標頭"X-Fc-Stateful-Async-Invocation-Id":"g6u*****iyvhd3jk8s6bhj0hh"完成非同步任務調用Invocation ID的配置。

關於要求標頭的更多資訊，請參見InvokeFunction - 調用函數。

非同步呼叫成功後，Function Compute會返回狀態代碼202，表示請求接收成功。同時會通過要求標頭返回Request ID和Stateful Invocation ID，格式如"X-Fc-Request-Id": "80bf7****281713e1", "X-Fc-Stateful-Async-Invocation-Id": "7522ba40****1c22e"。

針對某些情境，您提交一次非同步呼叫後，需要Function Compute對其進行延遲觸發。此時，您可以在代碼中添加HTTP要求標頭x-fc-async-delay，其取值範圍為（0,3600），單位為秒。Function Compute將從您觸發執行開始計算，延遲x-fc-async-delay設定的時間後觸發函數調用。更多資訊，請參見延遲調用。

認證鑒權

Function Compute支援對HTTP觸發器配置認證鑒權。外部使用者通過HTTP觸發器訪問函數時，必須經過Function Compute的認證鑒權之後，才能訪問到函數。HTTP觸發器目前支援簽名認證和JWT認證兩種鑒權方式。

使用簽名認證方式調用HTTP函數

用戶端在調用HTTP函數的時候，需要先根據事先分配好的AK和SK對請求內容進行計算簽名，在發起HTTP請求時，需要將AK和簽名資訊傳輸給Function Compute進行驗證。更多資訊，請參見簽名認證。

此認證方式安全強度較高，但是需要您自己在用戶端實現簽名演算法，實現成本較高。並且需要將AK和SK儲存在用戶端，AK和SK存在泄露的風險，雖然可以通過阿里雲臨時安全性權杖（STS） 來避免這個問題，但是會引入一定的架構複雜性。

使用JWT（JSON Web Tokens）認證方式調用HTTP函數

JWT是一套流行的API授權訪問機制，安全強度高，適用於JavaScript或Web前端等安全性較低的用戶端情境。更多資訊，請參見為HTTP觸發器配置JWT認證鑒權。

CORS請求處理

Function Compute系統預設允許HTTP函數的調用請求跨域訪問，同時也支援使用者在函數代碼中自訂函數對跨域（即CORS）請求的處理行為。

簡單請求

如果您沒有自訂Headers，Function Compute的Response Headers會預設設定為Request請求中相應的欄位：

• Access-Control-Allow-Origin：Request請求的Origin Header。

• Access-Control-Allow-Credentials: true

• Access-Control-Expose-Headers：Function Compute自訂的一些Headers。

非簡單請求

非簡單請求在發送正式請求前會發送預檢請求，即一次非簡單請求包含一次OPTIONS方法的函數調用請求和一次實際的函數調用請求。正式請求的規則與上文的簡單請求相同。如果您需要自訂預檢請求的返回，則需要：為HTTP觸發器添加OPTIONS方法，然後在函數代碼中處理OPTIONS請求，即設定Access-Control-Allow-*開頭的Header以控制函數的跨域行為。

對於預檢請求，Function Compute支援使用者自訂的Headers包括Access-Control-Allow-Origin、Access-Control-Allow-Headers、Access-Control-Request-Method和Access-Control-Max-Age。

exports.handler = (req, resp, context) => {
    console.log('hello world');

    if (req.method === 'OPTIONS') {
        // Send response to OPTIONS requests
        resp.setHeader('Access-Control-Allow-Origin', 'http://www.fc.com')
        resp.setHeader('Access-Control-Allow-Methods', 'POST');
        resp.setHeader('Access-Control-Allow-Headers', 'Content-Type');
        resp.setHeader('Access-Control-Max-Age', '3600');
        resp.setStatusCode(204)
        resp.send('');
     } else {
           resp.send("hello world");
     }
}

常見問題

相關文檔

設定HTTP觸發器的函數和事件函數的入口函數是有差異的，請確認您設定的函數入參是否正確。詳細資料可參考以下文檔。

• HTTP請求處理常式（Node.js）

• HTTP請求處理常式（Python）

• HTTP請求處理常式（PHP）

• HTTP請求處理常式（Java）

• HTTP請求處理常式（Custom Runtime）

• HTTP請求處理常式（Custom Container）