Azure Function在Docker Compose中运行但调试功能异常求助

VS 2022 「不支持在Linux运行」错误 #

原因 #

VS 2022 默认的 Azure Functions 调试配置未适配 Linux 容器环境，可能是项目未启用 Linux Docker 支持、目标运行时配置错误，或缺少容器开发工具组件。

解决办法 #

• 启用 Linux Docker 支持：右键项目 → 「添加」→ 「Docker 支持」，选择「Linux」作为目标操作系统。
• 检查项目属性配置：右键项目 → 「属性」→ 「调试」，确认启动配置为「Docker」，且目标 OS 设置为 Linux；同时确保 FUNCTIONS_WORKER_RUNTIME 环境变量值为 dotnet。
• 安装容器开发工具：打开 VS 2022 「工具」→ 「获取工具和功能」，在「工作负载」中勾选「容器开发工具」并安装。
• 手动修正 launchSettings.json：确保 Docker 配置块的 osType 为 Linux，且包含调试相关环境变量：

  "Docker": {
    "commandName": "Docker",
    "launchBrowser": true,
    "launchUrl": "{Scheme}://{ServiceHost}:{ServicePort}/api/HttpTrigger",
    "environmentVariables": {
      "ASPNETCORE_ENVIRONMENT": "Development",
      "FUNCTIONS_WORKER_RUNTIME": "dotnet"
    },
    "publishAllPorts": true,
    "useSSL": true,
    "osType": "Linux"
  }
  

VS Code 调试异常（断点无代码定位、Step Over 失败、stackTrace 错误） #

原因 #

核心问题是镜像构建未包含完整调试符号（pdb 文件），或调试配置（docker-compose.yml/launch.json）未正确映射调试端口、代码路径，导致调试器无法关联本地代码与容器内运行程序。

解决办法 #

1. 确保镜像构建包含调试符号

修改 Dockerfile，使用 Debug 模式构建并保留调试符号，示例如下：

# 构建阶段
FROM mcr.microsoft.com/dotnet/sdk:6.0 AS build
WORKDIR /src
COPY ["YourFunctionProject.csproj", "."]
RUN dotnet restore "./YourFunctionProject.csproj"
COPY . .
WORKDIR "/src/."
# Debug 模式构建，生成完整调试符号
RUN dotnet build "YourFunctionProject.csproj" -c Debug -o /app/build /p:DebugType=Full

# 发布阶段保留调试符号
FROM build AS publish
RUN dotnet publish "YourFunctionProject.csproj" -c Debug -o /app/publish /p:DebugType=Full

# 最终镜像
FROM mcr.microsoft.com/azure-functions/dotnet:4 AS base
WORKDIR /home/site/wwwroot
COPY --from=publish /app/publish .
ENV AzureWebJobsScriptRoot=/home/site/wwwroot \
    AzureFunctionsJobHost__Logging__Console__IsEnabled=true \
    DOTNET_MODIFIABLE_ASSEMBLIES=debug # 允许调试器修改程序集

2. 调整 docker-compose.yml 端口与环境配置

确保调试端口（默认 5005）映射到主机，同时配置调试相关环境变量：

services:
  function-app:
    build: .
    ports:
      - "7071:7071" # Functions HTTP 端口
      - "5005:5005" # .NET 远程调试端口
    environment:
      - FUNCTIONS_WORKER_RUNTIME=dotnet
      - ASPNETCORE_ENVIRONMENT=Development
      - DOTNET_MODIFIABLE_ASSEMBLIES=debug
    command: ["dotnet", "YourFunctionProject.dll", "--debug", "--server-urls", "http://0.0.0.0:5005"]
  dapr-sidecar:
    image: "daprio/daprd:latest"
    command: ["./daprd", "-app-id", "function-app", "-app-port", "7071"]
    network_mode: "service:function-app"

3. 修正 VS Code launch.json 调试配置

使用 .NET Core Attach 配置，确保代码路径映射正确，示例：

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Attach to Docker Function",
      "type": "coreclr",
      "request": "attach",
      "processId": "${command:pickRemoteProcess}",
      "pipeTransport": {
        "pipeProgram": "docker",
        "pipeArgs": ["exec", "-i", "function-app", "sh", "-c"],
        "debuggerPath": "/vsdbg/vsdbg",
        "pipeCwd": "${workspaceFolder}",
        "quoteArgs": false
      },
      "sourceFileMap": {
        "/home/site/wwwroot": "${workspaceFolder}/bin/Debug/net6.0/publish"
      }
    }
  ]
}

• sourceFileMap 需将容器内代码路径（/home/site/wwwroot）映射到本地项目的 Debug 发布目录，确保调试器能关联源代码。
• 若容器名称不同，需替换 pipeArgs 中的 function-app 为实际容器名称。

4. 其他检查

• 确保 VS Code 已安装最新版「C#」和「Docker」扩展。
• 启动容器时使用 docker compose up --build，确保基于最新 Debug 镜像启动。
• 确认 Dapr sidecar 未占用调试端口（5005），若有冲突可修改调试端口。

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