本地IIS部署.NET 6.0 Isolated LTS版Azure Functions报500错误求解

• 配置适配逻辑错误：你参考的部署方案仅适配早期*In-Process（进程内托管）模式的Azure Functions，这类模式下Functions依赖全局安装的Azure Functions Runtime作为宿主运行；但你创建的是.NET 6 Isolated（独立工作进程）*版本的Functions，运行逻辑和普通ASP.NET Core应用完全一致，旧配置逻辑完全不兼容。
• 托管模型配置错误：web.config中hostingModel被设置为InProcess，Isolated模式的Functions不支持IIS进程内托管，必须使用OutOfProcess（进程外托管）模型。
• 入口路径配置错误：processPath指向了全局安装的Azure Functions Core Tools内置的WebHost dll，Isolated模式项目发布时已经将所有运行时依赖打包在本地输出目录，不需要依赖全局安装的Core Tools路径，入口应该为你自己项目的编译产物。
• 前置依赖/配置缺失：若未安装.NET 6对应的ASP.NET Core IIS Hosting Bundle，或IIS应用程序池未设置为“无托管代码”，也会触发该类in-process托管失败错误。

1. 配置IIS基础环境
   • 安装.NET 6.0版本的ASP.NET Core IIS Hosting Bundle，安装完成后执行iisreset命令重启IIS服务生效。
   • 在IIS管理器中为该站点创建独立应用程序池，将**.NET CLR版本**设置为无托管代码，托管管道模式保持默认集成模式即可。
2. 重新发布项目
   • 回到Visual Studio 2022的Functions项目发布页，重新编辑发布配置：部署模式可根据需求选择「框架依赖」或「独立」，目标运行时选择和你服务器匹配的版本（如win-x64），重新将项目发布到本地部署文件夹。
   • 发布完成后不要手动覆盖输出目录自动生成的web.config文件，该文件已经适配Isolated模式的托管规则。
3. 手动修正web.config（若自动生成配置存在缺失）
   若自动生成的配置无法正常启动，可参考如下配置手动调整，将配置中的你的项目名替换为你实际的项目编译入口名称：

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <location path="." inheritInChildApplications="false">
    <system.webServer>
      <handlers>
        <remove name="aspNetCore" />
        <add name="aspNetCore" path="*" verb="*" modules="AspNetCoreModuleV2" resourceType="Unspecified" />
      </handlers>
      <!-- 框架依赖模式用如下配置 -->
      <aspNetCore processPath="dotnet"
                  arguments=".\你的项目名.dll"
                  stdoutLogEnabled="false"
                  stdoutLogFile=".\logs\stdout"
                  hostingModel="OutOfProcess">
        <environmentVariables>
          <environmentVariable name="ASPNETCORE_ENVIRONMENT" value="Production" />
          <environmentVariable name="FUNCTIONS_WORKER_RUNTIME" value="dotnet-isolated" />
          <environmentVariable name="AzureWebJobsStorage" value="UseDevelopmentStorage=true" />
        </environmentVariables>
      </aspNetCore>
      <!-- 独立部署模式请注释掉上面的aspNetCore节点，用如下节点替换
      <aspNetCore processPath=".\你的项目名.exe"
                  stdoutLogEnabled="false"
                  stdoutLogFile=".\logs\stdout"
                  hostingModel="OutOfProcess">
        <environmentVariables>
          <environmentVariable name="ASPNETCORE_ENVIRONMENT" value="Production" />
          <environmentVariable name="FUNCTIONS_WORKER_RUNTIME" value="dotnet-isolated" />
          <environmentVariable name="AzureWebJobsStorage" value="UseDevelopmentStorage=true" />
        </environmentVariables>
      </aspNetCore>
      -->
    </system.webServer>
  </location>
</configuration>

4. 权限与依赖检查
   • 为部署文件夹授予IIS_IUSRS用户组的读取、执行、列出目录内容权限。
   • 本地启动Azurite存储模拟器服务，否则AzureWebJobsStorage配置的本地存储连接会触发启动失败；如果不使用本地模拟器，将该配置值替换为实际可用的Azure Storage账户连接字符串。
5. 日志排查
   • 若重启站点后仍有错误，将上述配置中stdoutLogEnabled设为true，在站点根目录手动创建logs文件夹，重新访问站点后查看logs目录下生成的stdout日志文件，可定位具体的启动错误原因。

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