FastAPI Python Azure Function部署成功但触发器未显示求助

1. 核对function.json配置 #

Azure Function完全依赖function.json定义触发器规则，针对FastAPI的HTTP触发器场景，务必确保配置正确：

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

重点检查：scriptFile指向的入口文件路径是否正确，type必须设为httpTrigger，methods要包含你业务需要的请求方法。

2. 匹配本地与Azure的Python运行时版本 #

本地开发用的Python版本必须和Azure上的配置完全一致：

• 登录Azure门户，进入你的Function App → 设置 → 配置 → 常规设置
• 确认Python版本（比如3.9、3.10）和本地开发环境完全匹配
• 运行时堆栈务必选择Python

3. 检查部署包的文件结构 #

Azure Function对文件结构有严格要求，部署后要保证：

• function.json必须放在对应函数的目录下（比如FastAPIFunc/function.json）
• 依赖包安装正确：本地执行pip install -r requirements.txt --target .python_packages/lib/site-packages后再部署；或者开启Azure远程构建（设置ENABLE_ORYX_BUILD为true）
• 入口文件（如__init__.py）里的FastAPI实例要正确挂载到Azure触发器，示例代码：

from fastapi import FastAPI
from azure.functions import HttpRequest, HttpResponse
from fastapi.middleware.wsgi import WSGIMiddleware

app = FastAPI()

@app.get("/")
async def root():
    return {"message": "Hello World"}

def main(req: HttpRequest) -> HttpResponse:
    return WSGIMiddleware(app).handle(req)

4. 查看Azure Function的运行日志 #

直接从日志找报错线索：

• 进入Azure门户的Function App → 监测 → 日志
• 搜索部署后的启动日志，排查是否有依赖缺失、配置语法错误等问题
• 也可以用Azure CLI本地查看实时日志：

az functionapp log tail --name <你的函数应用名称> --resource-group <你的资源组名称>

5. 确认部署操作的正确性 #

如果用VS Code部署：

• 确保选择了正确的目标Function App
• 部署时没有忽略function.json、requirements.txt等核心文件
  如果用Azure CLI部署，建议加上远程构建参数避免环境差异：

func azure functionapp publish <你的函数应用名称> --build remote

6. 检查Function App的扩展与应用设置 #

• 进入Function App → 平台功能 → 扩展，确认已安装Python相关运行时扩展
• 进入设置 → 配置 → 应用程序设置，确认FUNCTIONS_WORKER_RUNTIME的值为python

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