FastAPI项目部署Azure Functions及本地测试遇阻求助

一、本地func start/func host start启动异常排查 #

• 确认虚拟环境激活状态：激活后执行pip list，检查是否包含azure-functions、fastapi、uvicorn等依赖。未激活则重新执行激活命令：Windows用.venv\Scripts\activate，Linux/macOS用source .venv/bin/activate。
• 修复依赖版本冲突：核对requirements.txt版本与示例仓库匹配（如azure-functions>=1.17.0、fastapi>=0.95.0），执行pip install -r requirements.txt --force-reinstall重新安装依赖。
• 校验function.json配置：确保scriptFile指向正确入口文件（如main.py），bindings配置符合要求，示例配置如下：

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

• 检查FastAPI包装逻辑：确保main.py中存在正确的Azure Functions适配代码，示例结构：

import azure.functions as func
from fastapi import FastAPI

app = FastAPI(title="FastAPI on Azure Functions")

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

def main(req: func.HttpRequest, context: func.Context) -> func.HttpResponse:
    return func.AsgiMiddleware(app).handle(req, context)

• 清理主机缓存：删除项目根目录下的.azurefunctions文件夹，再重新执行func start。

二、部署时无WrapperFunction选项的解决 #

• 规范项目结构：确保function.json位于单独的函数文件夹中（Azure Functions要求每个函数对应一个子目录，内含function.json与代码文件），若结构混乱，可重新创建函数目录并迁移文件。
• 升级Azure Functions Core Tools：执行func --version检查版本，若版本较低，升级至最新版（Windows用npm install -g azure-functions-core-tools@4，其他系统参考对应安装方式）。
• 手动指定部署函数：执行部署命令时显式指定函数名：func azure functionapp publish <你的应用名称> --functions WrapperFunction。
• 校验运行时配置：确认local.settings.json中FUNCTIONS_WORKER_RUNTIME字段值为python。

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