Azure Function V4部署后Startup.cs/Program.cs未生效排查求助

核心排查方向 #

1. 先核对.csproj关键配置 #

你提到附上了.csproj内容，重点确认以下几项：

• 确保AzureFunctionsVersion明确指定为v4：

  <AzureFunctionsVersion>v4</AzureFunctionsVersion>
  

• 确认TargetFramework是net6.0：

  <TargetFramework>net6.0</TargetFramework>
  

• 检查Functions SDK包版本是否适配（建议用4.x稳定版）：

  <PackageReference Include="Microsoft.NET.Sdk.Functions" Version="4.1.3" />
  

• 必须保证appsettings.json设置了复制输出属性，否则部署时不会同步到Azure：

  <None Update="appsettings.json">
    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
  </None>
  

2. 确认Program.cs的写法符合V4规范 #

完全移除旧的Startup.cs，避免冲突，.NET 6 V4的Program.cs要使用正确的主机构建逻辑：

var host = new HostBuilder()
    .ConfigureAppConfiguration(config =>
    {
        config.AddJsonFile("appsettings.json", optional: true, reloadOnChange: true);
        // 必须添加环境变量加载，覆盖本地配置适配云端环境
        config.AddEnvironmentVariables();
    })
    .ConfigureFunctionsWorkerDefaults()
    .Build();

host.Run();

注意：如果你的函数用的是进程内模式，Program.cs写法会有差异，要和Azure Portal中FUNCTIONS_WORKER_RUNTIME的设置（dotnet或dotnet-isolated）完全匹配。

3. 排查部署流程问题 #

• 放弃FTP部署，优先用Visual Studio发布、Azure DevOps或GitHub Actions，这类工具会自动处理依赖打包和配置文件同步，避免遗漏。
• 清理云端残留文件：登录Azure Portal，进入Function App的高级工具->Kudu，删除wwwroot下所有文件后重新部署，旧的编译文件可能导致启动逻辑冲突。
• 检查云端应用设置：进入Function App的配置->应用程序设置，确认FUNCTIONS_WORKER_RUNTIME和FUNCTIONS_EXTENSION_VERSION分别设置为dotnet/dotnet-isolated和~4。

4. 日志定位问题 #

在Azure Portal的Function App中，进入监控->日志，查看启动阶段的日志输出，重点找配置加载失败、程序集找不到之类的报错，这些日志能直接定位问题根源。

5. 确认应用服务计划运行时 #

如果用的是专用/弹性计划，进入Function App的配置->常规设置，确认.NET版本选择的是.NET 6，避免运行时不匹配导致启动代码被忽略。

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