Azure Python函数应用远程部署失败但本地运行正常的问题排查求助

API 探路者

2026-4-14

大家好，这个问题我已经折腾两天半了，实在没头绪来求助！我用的是消费计划的Azure Function App，之前远程部署一直正常，后来突然因为识别不了某个模块导致部署失败。我试着把代码精简到最基础的版本，结果反而更糟——现在就连最简单的函数应用都没法远程部署了。

先说说本地的情况：我写了个超基础的HTTP触发函数，运行func start完全正常，能正常返回结果。代码如下：

import azure.functions as func

app = func.FunctionApp()

#test function
@app.route(route="test", methods=["GET"])
def test(req: func.HttpRequest) -> func.HttpResponse:
    return func.HttpResponse(f"Hello, world!")

我的requirements.txt配置很简单：

azure-core==1.32.0
azure-cosmos==4.9.0
azure-identity==1.19.0
azure-functions==1.21.3
python-dotenv==1.0.1
requests==2.32.3

host.json配置：

{
  "version": "2.0",
  "logging": {
    "logLevel":{
      "default": "Trace"
    },
    "applicationInsights": {
      "samplingSettings": {
        "isEnabled": true,
        "excludedTypes": "Request"
      }
    }
  },
  "extensionBundle": {
    "id": "Microsoft.Azure.Functions.ExtensionBundle",
    "version": "[4.*, 5.0.0)"
  }
}

local.settings.json配置：

{
  "IsEncrypted": false,
  "Values": {
    "FUNCTIONS_WORKER_RUNTIME": "python",
    "PYTHON_VERSION": "3.11",
    "AzureWebJobsFeatureFlags": "EnableWorkerIndexing",
    "AzureWebJobsStorage": ""
  }
}

这里有个关键细节：我之前本地虚拟环境用的是Python 3.13，后来改成了3.11，就是从这时候开始，就连精简后的基础函数也部署失败了。

现在的错误信息特别有限，VS Code的输出窗口只显示：

10:39:55 python-app: Zip package size: 157 MB
10:40:13: Error: Failed to get status of deployment.

我去Azure门户看日志流，啥有用的信息都没。但奇怪的是，用GitHub Actions部署的时候居然能成功完成，这就让我更懵了。

现在我最想解决两个问题：

怎么配置更完善的日志，能让我看到部署失败的具体原因？
到底是什么导致了VS Code远程部署失败，怎么才能修复？

备注：内容来源于stack exchange，提问作者anewvision