求助：将AWS Lambda+API Gateway迁移至Azure Functions+API Management遇阻

一、HTTP 触发器函数代码与配置排查 #

1. 确认 Python 函数格式合规 #

Azure Functions Python HTTP 触发器有固定入口格式，需确保你的代码符合要求，示例如下：

import azure.functions as func
import json

def main(req: func.HttpRequest) -> func.HttpResponse:
    try:
        # 替换为原 AWS Lambda 的业务逻辑
        result = {"status": "success", "data": "迁移后的返回内容"}
        return func.HttpResponse(
            json.dumps(result),
            mimetype="application/json",
            status_code=200
        )
    except Exception as e:
        return func.HttpResponse(
            json.dumps({"error": str(e)}),
            mimetype="application/json",
            status_code=500
        )

2. 检查 function.json 配置 #

确保触发器的权限级别和请求方法匹配你的需求，若需公开访问，将 authLevel 设为 anonymous：

{
  "scriptFile": "__init__.py",
  "bindings": [
    {
      "authLevel": "anonymous",
      "type": "httpTrigger",
      "direction": "in",
      "name": "req",
      "methods": ["get"]
    },
    {
      "type": "http",
      "direction": "out",
      "name": "$return"
    }
  ]
}

二、Azure CLI 部署失败排查 #

1. 匹配 Python 版本 #

确保本地 Python 版本与函数应用的运行时版本一致，执行以下命令查看函数应用版本：

az functionapp show --name <你的函数应用名> --resource-group <你的资源组> --query 'siteConfig.pythonVersion'

2. 使用正确的部署命令 #

推荐使用 Azure Functions Core Tools 进行部署（需提前安装），进入函数项目根目录（包含 host.json 的文件夹）执行：

func azure functionapp publish <你的函数应用名>

该命令会自动打包依赖并上传，比纯 CLI 的 zip 部署更适配 Python 项目。

若坚持用 Azure CLI，需先将项目打包为 zip 文件，再执行：

az functionapp deployment source config-zip --resource-group <你的资源组> --name <你的函数应用名> --src <本地zip文件路径>

3. 依赖包配置 #

确保项目根目录存在 requirements.txt，列出所有依赖（包括 azure-functions 及原 Lambda 使用的第三方包），示例：

azure-functions>=1.17.0
requests>=2.31.0

三、关联 Azure API Management 步骤 #

1. 进入你的 APIM 实例，选择「API」→「添加 API」→「Azure Function」
2. 选择目标函数应用及对应的 HTTP 触发器函数，配置 API 名称、路径前缀
3. 在 APIM 的 API 编辑页，确认「后端」指向函数的触发 URL，「操作」的 HTTP 方法与函数一致
4. 测试：通过 APIM 提供的测试控制台或 Postman 调用 APIM 端点，验证返回结果

四、关键排查手段 #

• 查看函数应用日志：进入 Azure 门户的函数应用→「监控」→「日志」，搜索具体错误信息（如导入失败、逻辑异常）
• 本地测试：使用 func start 启动本地函数，通过 http://localhost:7071/api/<触发器名称> 测试，确认代码逻辑正常

内容的提问来源于stack exchange，提问作者Remijius Briska