HTTP触发器调用函数

请求结构体格式

请求结构体格式如下：

{ "version": "v1", "rawPath": "/example", "body": "Hello FC!", "isBase64Encoded": false, "headers": { "header1": "value1", "header2": "value1,value2" }, "queryParameters": { "parameter1": "value1", "parameter2": "value1,value2" }, "requestContext": { "accountId": "123456*********", "domainName": "<http-trigger-id>.<region-id>.fcapp.run", "domainPrefix": "<http-trigger-id>", "http": { "method": "GET", "path": "/example", "protocol": "HTTP/1.1", "sourceIp": "11.11.11.**", "userAgent": "PostmanRuntime/7.32.3" }, "requestId": "1-64f6cd87-*************", "time": "2023-09-05T06:41:11Z", "timeEpoch": "1693896071895" } }

请求结构体参数说明如下：

函数计算HTTP请求映射逻辑

函数计算会将HTTP请求映射成Event事件对象传给请求处理程序（Handler），映射逻辑如下：

• HTTP请求头映射为event结构中的headers。

• HTTP请求参数映射为queryParameters。

• HTTP请求的上下文信息映射为requestContext。

• POST请求的请求体映射为body。

请求映射示例

响应结构体格式

函数的响应结构体格式如下。当您的请求处理程序返回响应结构体时，函数计算会解析响应并将其转换为HTTP响应。

{ "statusCode": 200, "headers": { "Content-Type": "application/json", "Custom-Header-1": "Custom Value" }, "isBase64Encoded": false, "body": "{\"message\":\"Hello FC!\"}" }

函数计算响应解析逻辑

函数计算会解析响应并构造HTTP Response返回给客户端。

• 如果您的函数返回有效的JSON并且包含statusCode字段，函数计算解析逻辑如下：

  • statusCode：函数返回JSON中的statusCode值。

  • Content-Type：函数返回JSON中的Content-Type值。如果JSON中没有Content-Type，Content-Type默认为application/json。

  • body：函数响应，函数返回JSON中的body值。

  • isBase64Encoded：函数返回JSON中的isBase64Encoded值，如果JSON中没有isBase64Encoded，则默认为false。

• 如果您的函数返回有效的JSON但是没有包含statusCode字段，或者返回的不是有效的JSON，函数计算会做出以下假设，构造响应结构体。

  • statusCode：默认为200。

  • Content-Type：默认为application/json。

  • body：函数响应，即代码中return的数据。

  • isBase64Encoded：默认为false。

函数计算会将函数响应结构体映射成HTTP响应返回给客户端，映射逻辑如下：

• statusCode映射为HTTP响应的状态码。

• headers映射为HTTP响应头。

• body映射为HTTP响应体，如果存在isBase64Encoded且为true，则先将body进行Base64解码，再映射到HTTP响应体。

响应映射示例

以下示例介绍了函数的输出如何映射到函数响应结构体，以及函数响应结构体如何映射到最终的HTTP响应。当客户端调用函数HTTP触发器时，就可以看到HTTP响应。

Base64解码机制

当函数输出为有效的JSON格式，且JSON中的isBase64Encoded字段为true时，函数计算会将JSON中的body字段进行Base64解码，再将解码后的数据通过HTTP响应体返回给客户端。

如果对body字段解码失败，函数计算不会报错，而是直接将原始的body字段的值返回给客户端。

响应头（HTTP Response Header）

使用HTTP触发器调用函数时，响应头中会包含函数计算默认添加的响应头X-Fc-Request-Id，这是此次请求的唯一标识。除了X-Fc-Request-Id，函数计算不会默认添加其他响应头。

您可以在代码中返回自定义的响应头，但不支持X-Fc-开头的响应头和以下函数计算保留的响应头：

• connection

• content-length

• date

• keep-alive

• server

• content-disposition

如果您在响应头中设置了这些保留字，函数计算会直接忽略您设置的响应头。

错误处理

当遇到函数错误时，通过API调用会返回具体的错误信息，HTTP返回码为200。比如Python的ModuleNotFound错误的响应如下：

{ "errorMessage": "Unable to import module 'index'", "errorType": "ImportModuleError", "stackTrace": [ "ModuleNotFoundError: No module named 'not_exist_module'" ] }

但使用HTTP 触发器调用时，函数计算会隐藏这些错误信息，直接返回Internal Server Error，HTTP返回码为502。HTTP响应示例如下：

HTTP/1.1 502 Bad Gateway Content-Disposition: attachment Content-Type: application/json X-Fc-Request-Id: 1-64f6df91-fe144d52e4fd27afe3d8dd6f Date: Tue, 05 Sep 2023 07:58:09 GMT Content-Length: 21 Internal Server Error

此时，您可以通过请求返回的X-Fc-Request-Id在日志中查找具体的报错信息。