Azure Dotnet Isolated函数部署后404：未找到作业函数

一、本地正常但Azure部署失败的原因及修复 #

1. 部署包结构错误 #

dotnet-isolated模式的Azure Function需要部署发布后的编译产物，而非原始源码。如果Terraform打包的是项目源码文件夹，Azure无法识别并加载函数。

• 修复：先在本地执行dotnet publish -c Release，将bin/Release/net8.0/publish目录下的所有文件打包成zip，再通过Terraform部署该zip包。

2. 应用配置缺失或错误 #

• 确认FUNCTIONS_WORKER_RUNTIME值为dotnet-isolated（而非dotnet，后者对应进程内模式）。
• 检查AzureWebJobsStorage是否配置了有效的存储账户连接字符串，dotnet-isolated模式即使是HTTP触发器也需要存储账户处理内部状态。
• 添加WEBSITE_RUN_FROM_PACKAGE设置为1，强制Function App从部署包运行，避免文件锁定或部署不完整问题。

3. 运行时版本不匹配 #

• 在Azure门户的Function App「配置>常规设置」中，确认.NET Version选择的是.NET 8 Isolated，而非进程内的.NET 8。
• 检查项目.csproj文件：确保<TargetFramework>net8.0</TargetFramework>、<AzureFunctionsVersion>v4</AzureFunctionsVersion>，且包含<OutputType>Exe</OutputType>（isolated模式是控制台应用）。

4. 触发器路径不匹配 #

• 对比本地运行的端点路径（如http://localhost:7071/api/HttpTrigger1）与Azure上的路径（https://<app-name>.azurewebsites.net/api/HttpTrigger1），确认无拼写错误。
• 检查Function类的Route属性，若自定义了路由，需确保Azure上的请求路径与之匹配。

二、获取更多日志信息的方法 #

1. 启用并查看Application Insights日志 #

在Function App配置中关联Application Insights资源，之后在AI的「日志」中查询traces表，可获取工作进程启动、函数加载的详细错误信息（如依赖缺失、配置异常）。

2. 查看Kudu站点的主机日志 #

访问https://<app-name>.scm.azurewebsites.net，进入「Debug console > CMD」，打开LogFiles/Application/Functions/Host目录，查看其中的日志文件，会记录函数加载失败的具体原因（如找不到程序集、配置文件错误）。

3. 调整日志级别为Debug #

添加以下应用设置：

• AzureFunctionsJobHost__logging__logLevel__Default = Debug
• AzureFunctionsJobHost__logging__console__isEnabled = true
  重启Function App后，再查看Kudu或AI日志，可获得更详细的启动加载过程信息。

4. 使用Azure CLI查看实时日志 #

执行命令：

az functionapp log tail --name <function-app-name> --resource-group <resource-group-name>

实时查看Host和工作进程的输出日志，便于排查启动阶段的错误。

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