func init --docker-only生成.NET 6镜像Dockerfile与.NET 8项目不匹配问题

问题现象 #

• 使用func init --worker-runtime dotnet-isolated创建.NET 8的Azure Functions项目后，执行func init --docker-only生成的Dockerfile默认使用**.NET 6镜像**
• 但直接执行func init --worker-runtime dotnet-isolated --docker创建项目时，生成的Dockerfile却正确使用**.NET 8镜像**
• 当前使用的Azure Functions Tools版本为4.0.5530，预期func init --docker-only应匹配项目的.NET 8版本生成对应Dockerfile

生成的错误Dockerfile内容 #

FROM mcr.microsoft.com/dotnet/sdk:6.0 AS installer-env

COPY . /src/dotnet-function-app
RUN cd /src/dotnet-function-app && \
mkdir -p /home/site/wwwroot && \
dotnet publish *.csproj --output /home/site/wwwroot

# To enable ssh & remote debugging on app service change the base image to the one below
# FROM mcr.microsoft.com/azure-functions/dotnet-isolated:4-dotnet-isolated6.0-appservice
FROM mcr.microsoft.com/azure-functions/dotnet-isolated:4-dotnet-isolated6.0
ENV AzureWebJobsScriptRoot=/home/site/wwwroot \
    AzureFunctionsJobHost__Logging__Console__IsEnabled=true

COPY --from=installer-env ["/home/site/wwwroot", "/home/site/wwwroot"]

原因分析 #

这是Azure Functions CLI的行为缺陷：--docker-only参数生成Dockerfile时，不会读取现有项目.csproj中的.NET版本配置，而是直接使用CLI内置的默认模板版本（当前4.0.5530版本默认模板为.NET 6）。而--docker参数是在创建项目时同步生成Dockerfile，会自动关联项目指定的.NET版本，因此能生成正确的镜像配置。

解决办法 #

1. 手动修改Dockerfile（最直接方案）：

   • 将构建阶段SDK镜像从mcr.microsoft.com/dotnet/sdk:6.0改为mcr.microsoft.com/dotnet/sdk:8.0
   • 将运行阶段Azure Functions镜像从mcr.microsoft.com/azure-functions/dotnet-isolated:4-dotnet-isolated6.0改为mcr.microsoft.com/azure-functions/dotnet-isolated:4-dotnet-isolated8.0

2. 升级Azure Functions CLI：
   检查并升级到最新版本的Azure Functions Tools，后续官方版本可能修复模板与项目版本不匹配的问题。

3. 重新生成Dockerfile：
   删除现有错误的Dockerfile，执行func init --docker命令重新生成（执行前注意备份项目自定义配置，避免意外覆盖）。

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