如何在Docker容器中部署.NET 7 Azure Functions？从.NET Core3.1升级指南

一、是否支持.NET 7 Linux Docker部署？ #

Azure Functions v4运行时完全支持.NET 7的Linux容器部署，官方已提供对应基础镜像和SDK镜像。你遇到的错误是升级过程中项目配置与Dockerfile不匹配导致，并非平台不支持。

二、从.NET Core 3.1到.NET 7的完整升级步骤 #

1. 升级项目配置 #

修改项目文件（.csproj）：

• 将TargetFramework从netcoreapp3.1改为net7.0
• 设置AzureFunctionsVersion为v4
• 更新Microsoft.NET.Sdk.Functions NuGet包至4.1.1及以上（此版本开始支持.NET 7）

示例关键配置：

<PropertyGroup>
  <TargetFramework>net7.0</TargetFramework>
  <AzureFunctionsVersion>v4</AzureFunctionsVersion>
</PropertyGroup>
<ItemGroup>
  <PackageReference Include="Microsoft.NET.Sdk.Functions" Version="4.1.1" />
</ItemGroup>

2. 修正Dockerfile #

你之前的Dockerfile仅替换了基础镜像，但缺少完整的构建发布流程，导致运行时容器中无正确的应用文件。以下是正确的Dockerfile配置：

# 基础运行时镜像：Azure Functions v4 兼容.NET 7
FROM mcr.microsoft.com/azure-functions/dotnet:4 AS base
WORKDIR /home/site/wwwroot
EXPOSE 80
ENV AzureWebJobsScriptRoot=/home/site/wwwroot \
    AzureFunctionsJobHost__Logging__Console__IsEnabled=true

# 构建阶段：使用.NET 7 SDK编译项目
FROM mcr.microsoft.com/dotnet/sdk:7.0 AS build
WORKDIR /src
COPY ["YourFunctionProject.csproj", "."]
RUN dotnet restore "./YourFunctionProject.csproj"
COPY . .
WORKDIR "/src/."
RUN dotnet build "YourFunctionProject.csproj" -c Release -o /app/build

# 发布阶段：生成部署产物
FROM build AS publish
RUN dotnet publish "YourFunctionProject.csproj" -c Release -o /app/publish /p:UseAppHost=false

# 最终镜像：将发布产物复制到运行时镜像
FROM base AS final
WORKDIR /home/site/wwwroot
COPY --from=publish /app/publish .

注意：将YourFunctionProject.csproj替换为你的实际项目文件名。

3. 解决你遇到的具体错误 #

• 错误MSB3971: The reference assemblies for ".NETFramework,Version=v7.0" were not found.
  原因：原Dockerfile使用的.NET Core 3.1 SDK无法识别.NET 7目标框架。解决：将构建阶段的SDK镜像替换为mcr.microsoft.com/dotnet/sdk:7.0。

• 错误You must install or update .NET to run this application.
  原因：未完成构建->发布->复制产物到运行时镜像的完整流程，运行时容器中无编译好的.NET 7应用。解决：使用上述完整的Dockerfile，确保发布产物正确复制到基础镜像。

4. 额外验证项 #

• 本地安装.NET 7 SDK，确保本地调试正常
• 升级Azure Functions Core Tools至v4版本，支持.NET 7开发调试
• 部署到Azure时，确认函数应用的运行时版本设置为~4（Azure门户-函数应用-配置-常规设置）

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