在Azure容器应用中托管.NET Azure Function的监听端口配置问题

核心原因 #

.NET隔离模式的Azure Function不使用常规的ASPNETCORE_URLS或WEBSITES_PORT配置端口，而是依赖专属环境变量AzureFunctionsJobHost__Http__Port指定监听端口。你之前的环境变量配置不匹配，导致容器仍随机生成监听端口。

正确配置步骤 #

1. 修正Dockerfile配置 #

将端口相关的环境变量和EXPOSE指令移至runtime镜像阶段（即最终使用的azure-functions/dotnet-isolated镜像层），确保端口配置生效：

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

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

FROM mcr.microsoft.com/azure-functions/dotnet-isolated:4-dotnet-isolated8.0
ENV AzureWebJobsScriptRoot=/home/site/wwwroot \
    AzureFunctionsJobHost__Logging__Console__IsEnabled=true \
    # 指定Host监听端口
    AzureFunctionsJobHost__Http__Port=8080 \
    # 隔离模式下，Worker需与Host端口保持一致
    DOTNET_ISOLATED_WORKER_PORT=8080

# 暴露与配置一致的端口
EXPOSE 8080

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

2. 配置Azure容器应用端口映射 #

部署时在容器应用的容器配置中：

• 将目标端口设置为8080（与Dockerfile中指定的端口一致）
• 确保Ingress配置的端口指向该目标端口

3. 本地验证（可选） #

本地运行时可通过环境变量指定端口测试：

# Windows
set AzureFunctionsJobHost__Http__Port=8080
dotnet run

# Linux/macOS
export AzureFunctionsJobHost__Http__Port=8080
dotnet run

或使用Docker命令运行镜像：

docker run -p 8080:8080 -e AzureFunctionsJobHost__Http__Port=8080 your-image-name

无效配置说明 #

• WEBSITES_PORT是Azure App Service专属变量，容器应用不识别
• ASPNETCORE_URLS对隔离模式Function无效，因为隔离模式下Host与Worker进程分离，需用专属变量配置
• 之前的EXPOSE指令放在build阶段，最终runtime镜像未继承该设置，因此需移至runtime层

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