Azure Function（Linux Docker）.NET 8.0运行时缺失问题求助

镜像中.NET运行时验证 #

• 检查Dockerfile里的.NET 8安装步骤：确保装的是ASP.NET Core运行时（不是仅SDK），Azure Functions依赖这个运行时而非开发SDK
• 本地镜像里执行dotnet --info确认运行时存在，再通过Azure高级工具（比如Kudu）在容器里跑同样命令，对比结果看是否一致
• 排查Dockerfile后续步骤：有没有清理包缓存时误删了运行时文件，比如apt-get clean或rm -rf之类的命令是否影响了运行时目录

Terraform部署配置检查 #

• 确认azurerm_function_app的site_config里linux_fx_version格式正确：必须是DOCKER|你的镜像仓库地址/镜像名:标签，别写错镜像路径
• 强制设置环境变量：添加FUNCTIONS_WORKER_RUNTIME=dotnet和FUNCTIONS_EXTENSION_VERSION=~4，这俩变量能让Azure识别正确的运行时版本，避免显示custom (~4)
• 看Terraform部署日志：确认镜像是否成功拉取到Azure，有没有拉取超时、权限不足（比如私有仓库没配置密钥）的情况

运行时标识修正 #

• runtime显示custom (_{4)是自定义镜像的默认标记，只要设置了上面提到的`FUNCTIONS_WORKER_RUNTIME`和`FUNCTIONS_EXTENSION_VERSION`，就能修正为正常的}4标识
• 检查应用设置里的WEBSITE_RUN_FROM_PACKAGE：如果这个变量设为1，会覆盖Docker配置，必须删掉或者设为0

Puppeteer-Sharp依赖排查 #

• 别忽略系统依赖：Puppeteer需要一堆Linux系统库，缺失这些可能导致服务启动失败，被误判为.NET运行时问题。Dockerfile里加以下安装命令：

  RUN apt-get update && apt-get install -y \
      libnss3 \
      libatk1.0-0 \
      libatk-bridge2.0-0 \
      libcups2 \
      libdrm2 \
      libxkbcommon0 \
      libxcomposite1 \
      libxdamage1 \
      libxrandr2 \
      libgbm1 \
      libasound2 \
      libpangocairo-1.0-0 \
      libgtk-3-0
  

• 测试用户权限：Azure Functions容器默认用非root用户运行，本地测试如果是root用户，可能掩盖权限问题。可以在Dockerfile里临时加USER root测试，确认后再调整正确的权限配置

日志调试 #

• 看Azure门户的日志流或监控->日志：获取启动失败的详细堆栈，很多时候提示.NET缺失只是表面现象，实际是其他依赖问题
• 用Azure CLI实时看日志：az functionapp log tail --name <你的函数名> --resource-group <资源组名>，能快速定位错误点
• 手动在Azure容器实例跑镜像：排除Terraform配置的干扰，直接启动镜像看是否能正常运行

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