如何在Azure Function中调用外部API？Google Chat webhook调用异常

数据老陈

2026-9-1

问题核心原因

手写JSON payload格式非法：你构造的payload使用单引号包裹键值、携带多余\r\n转义字符，不符合JSON要求双引号的标准规范。Postman这类工具会自动修正非法JSON格式所以能跑通，但Python原生http.client不会做格式兼容，发送的非法请求会被Google Chat API直接拒绝。
日志采集失效：你用print()输出API返回结果，Azure Function Python运行时默认不会采集print输出到应用日志，导致你看不到API返回的真实错误信息，盲调时无法定位问题。
缺少异常捕获与超时配置：外部HTTP请求没有设置超时、没有做异常捕获，一旦出现网络波动、域名解析失败、连接拒绝等问题，代码会直接抛出未处理异常返回500错误，没有任何有效报错提示。

排查&修复步骤

第一步修正日志方式：把所有print()替换为logging.info()/logging.error()，将API返回的状态码、响应体、异常信息全量打日志，部署后到Azure门户的「日志流」页面查看真实报错，不要靠猜测定位问题。
第二步彻底替换手写JSON的写法：永远用json.dumps()方法构造JSON payload，从根源避免引号、转义字符、多余换行的低级格式错误。
第三步补全请求配置：给外部HTTPS请求设置合理超时时间（建议10s），请求结束后主动关闭连接，用try-except包裹整个外部调用逻辑，捕获所有可能的请求异常并打日志。
第四步网络连通性校验：如果你的函数开启了VNet集成、部署在应用服务环境（ASE）中，确认出站策略没有拦截到chat.googleapis.com的443端口请求；普通公网消费计划的Azure Function默认可以直接访问公网，一般不会有网络拦截问题。

修正后可直接运行的代码

import logging
import json
import azure.functions as func
import http.client

def main(req: func.HttpRequest) -> func.HttpResponse:
    logging.info('Python HTTP trigger function processed a request.')

    try:
        # 用标准方法构造JSON payload，禁止手写JSON字符串
        payload = json.dumps({
            "text": "hello world, from my azure function."
        })
        headers = {'Content-Type': 'application/json'}
        # 增加10s超时配置，避免请求挂起耗尽函数执行时长
        conn = http.client.HTTPSConnection("chat.googleapis.com", timeout=10)
        conn.request(
            "POST",
            "/v1/spaces/Ajdf9u4jf4/messages?key=f03j4fij43",
            payload,
            headers
        )
        res = conn.getresponse()
        response_body = res.read().decode("utf-8")
        # 用官方logging模块打日志，确保日志能被Azure采集
        logging.info(f"Google Chat API call finished, status: {res.status}, response: {response_body}")
        conn.close()
    except Exception as e:
        # 捕获所有请求异常，打印完整错误栈
        logging.error(f"Call Google Chat API failed: {str(e)}", exc_info=True)

    # 原有请求处理逻辑
    name = req.params.get('name')
    if not name:
        try:
            req_body = req.get_json()
        except ValueError:
            pass
        else:
            name = req_body.get('name')
    if name:
        return func.HttpResponse(f"Hello, {name}. This HTTP triggered function executed successfully.")
    else:
        return func.HttpResponse(
            "This HTTP triggered function executed successfully. Pass a name in the query string or in the request body for a personalized response.",
            status_code=200
        )

额外注意事项

部署后触发一次函数，在日志流中如果看到Google API返回400状态码，优先检查请求参数、payload格式是否正确；返回403则检查webhook key、空间权限是否配置正确；返回超时错误再排查网络连通性。
不建议在生产代码里手写JSON字符串，哪怕格式看起来完全正确，也容易因为转义、特殊字符出现隐蔽的格式问题。
所有外部依赖调用都必须配置超时、捕获异常，避免单个外部服务故障导致整个函数返回500错误。

内容的提问来源于stack exchange，提问作者Kevin D