如何在Azure门户快速查看Python 3.11 Azure Function部署错误？

一、即时获取部署/函数加载错误的方法 #

• 通过Azure CLI或VS Code查看实时部署日志
  使用az functionapp deployment source config-zip --resource-group <资源组名> --name <函数应用名> --src <本地zip包路径> --verbose命令部署时，--verbose参数会在本地控制台实时输出部署全流程日志，包括依赖安装失败、模块缺失的具体报错。如果用VS Code部署，打开输出面板（Ctrl+Shift+U），选择「Azure Functions」频道，可实时查看部署及函数启动的详细日志，模块加载失败信息会即时呈现。
• 使用Kudu控制台查看实时运行日志
  访问https://<你的函数应用名>.scm.azurewebsites.net/DebugConsole，进入LogFiles/runtime目录，查看application.log和functions.log文件，这里会实时记录函数启动阶段的加载错误，无需等待日志延迟。
• 调整日志级别开启详细输出
  在Azure门户的函数应用「配置」→「应用程序设置」中，添加或修改FUNCTIONS_WORKER_RUNTIME_LOG_LEVEL为Debug，之后日志流（Log Stream）会输出更详尽的启动日志，模块缺失类错误会即时显示在日志流内。

二、函数加载失败但部署流程不报错的原因 #

Azure Function App的部署流程仅负责完成代码上传、解压、依赖安装触发这几个环节，部署成功的判定标准是代码上传完成、依赖安装进程正常退出（即使存在隐性安装失败，比如部分包在Linux环境编译失败但进程返回码正常），并不会验证函数是否能成功加载运行。

函数的模块加载属于部署后的运行时阶段，只有当函数实例启动并尝试导入模块时，才会暴露缺失问题，因此部署流程不会将这类运行时错误判定为部署失败，自然不会抛出错误。此外，Python依赖安装的部分异常场景（如包不存在但pip返回非错误码、缓存导致的假成功），部署阶段的检查无法覆盖，只能在运行时触发加载时才会显现。

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