从VS2022部署Azure Function至Azure门户时Kudu运行包初始化失败求助

一、解决初始化失败错误 #

以下是针对性的排查和修复步骤：

• 检查应用程序设置WEBSITE_RUN_FROM_PACKAGE
  进入Azure门户的目标Function App，导航至「配置」>「应用程序设置」：

  • 确认该设置已存在，若通过Visual Studio发布并勾选「Run from Package」，正常情况下值应为1（表示使用本地Zip包部署）或有效的存储账户SAS URL（指向存储中的包文件）。
  • 若值为空或无效，手动设置为1后点击「保存」，再重新发布一次项目。

• 验证部署包的完整性

  • 本地查看项目发布生成的Zip包：打开bin\Release\net6.0\publish目录，解压Zip包确认是否包含host.json、函数对应的DLL文件及其他必要依赖，若包损坏则重新生成发布包。
  • 在Kudu站点的「Debug console」>「PowerShell」中，进入D:\home\data\SitePackages目录，检查最新的包文件是否存在、大小是否符合预期。若包缺失或异常，手动上传正确的Zip包到该目录，然后修改packagename.txt文件，写入对应包的文件名（例如my-function-app.zip）。

• 确认运行栈与.NET版本匹配
  在Azure门户的Function App「配置」>「常规设置」中，确保运行栈设置为.NET 6 (LTS)，运行时版本选择对应的值，避免版本不兼容导致初始化失败。

• 重启Function App
  完成上述配置调整后，在Function App概述页点击「重启」按钮，等待服务重启后再查看Kudu站点的状态。

二、消除黄色背景警告 #

黄色警告通常因Run from Package模式下文件系统只读引发，按以下方式处理：

• 移除代码中本地文件系统读写操作
  检查函数代码是否存在写入D:\home\site\wwwroot目录（运行时只读）的逻辑，比如本地日志写入、文件缓存等。将这类操作替换为Azure Blob存储、Azure Table存储等云服务。

• 配置日志输出至Azure Monitor
  修改host.json文件，禁用本地文件日志，将日志输出到Azure Monitor：

  {
    "logging": {
      "applicationInsights": {
        "samplingSettings": {
          "isEnabled": true,
          "excludedTypes": "Request"
        }
      },
      "fileLoggingMode": "Never"
    }
  }
  

• 使用可写的临时目录
  若代码中必须进行临时文件操作，使用D:\local\Temp目录（该目录支持读写），可通过Path.GetTempPath()在代码中获取此路径：

  var tempFilePath = Path.Combine(Path.GetTempPath(), "temp-file.txt");
  

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