Azure DevOps CI/CD成功后Azure FunctionApp无函数显示问题

核心问题总结 #

• 基于Y1应用服务计划的Linux版Azure Function App（C#/.NET6），Azure DevOps CI/CD流水线执行成功，但Azure Portal的Functions面板无任何函数显示
• 通过VS Code Azure扩展查看应用文件时，bin目录返回404，但CI流水线生成的工件包中bin目录内容完整
• 无部署槽配置，关联的App Insights能看到部署记录；VS Code直接部署在Y1计划下报错，切换到S1计划后VS Code部署成功，但DevOps流水线部署仍无函数显示，切回Y1计划后VS Code报错重现

分步排查与修复 #

1. 检查Y1计划的资源限制与部署模式 #

Y1作为免费层Linux应用服务计划，存在明确的存储和部署限制：

• 查看Function App配置中的WEBSITE_RUN_FROM_PACKAGE参数：如果设置为1，说明启用了从包运行模式，此时应用文件会被挂载为只读文件系统，VS Code的实时文件同步部署会冲突，且解压包时可能因Y1的临时存储（/tmp）空间不足导致bin目录未完整解压。可通过Kudu控制台（https://<你的函数名>.scm.azurewebsites.net/）执行df -h查看磁盘使用情况。
• 如果未启用RUN_FROM_PACKAGE，Y1计划的文件系统权限可能存在问题，部署后需通过Kudu执行chmod -R 755 /home/site/wwwroot/bin给bin目录赋予执行权限。

2. 验证CI/CD流水线的构建与部署逻辑 #

• CI阶段：确认构建任务生成的工件包包含完整的bin/Release/net6.0目录，以及每个函数对应的子目录（必须包含function.json）。如果函数是预编译的，function.json应该在bin目录对应的函数子路径下。
• CD阶段：若使用Azure Function Deploy任务，优先选择Run From Package部署模式，避免Linux文件系统的权限和同步问题。如果用Zip Deploy，确保任务配置中没有忽略bin目录，且添加权限修复步骤（比如在部署后执行Shell脚本chmod -R 755 /home/site/wwwroot/bin）。

3. 检查Function App的运行时配置与日志 #

• 确认配置项FUNCTIONS_WORKER_RUNTIME为dotnet，FUNCTIONS_EXTENSION_VERSION为~4（对应.NET6），Y1计划下版本不匹配会导致函数无法加载。
• 查看Portal中的日志流，过滤启动日志，检查是否存在bin目录下程序集加载失败的报错（比如文件缺失、权限不足），这些日志会直接说明函数不显示的原因。

4. 修复VS Code在Y1计划的部署报错 #

• VS Code直接部署时，切换为本地生成发布包再部署：先在本地执行dotnet publish -c Release -o ./publish生成发布包，然后在VS Code的Azure扩展中选择发布包（./publish目录或publish.zip）进行部署，避免实时同步的权限问题。
• 检查项目依赖，确保没有引用Windows专属的NuGet包，Y1 Linux环境不支持这类依赖。

5. 解决S1计划下流水线仍无函数的问题 #

• 对比VS Code和DevOps流水线的部署参数：VS Code部署可能自动调整了RUN_FROM_PACKAGE或其他配置，而流水线没有同步这些设置。比如VS Code部署时禁用了RUN_FROM_PACKAGE，但流水线启用了，导致函数检测失败，需统一两者的部署模式。
• 检查流水线部署后的文件结构：通过Kudu查看/home/site/wwwroot下的文件，确认函数目录和bin目录是否存在，若缺失则调整CI阶段的构建输出路径。

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