Docker容器中ASP.NET Core应用调试路径配置问题修复

问题说明 #

在Docker容器中调试ASP.NET Core 6.0应用时，调试可正常启动，但触发断点时出现路径不匹配：本地代码路径为DevFreela.API\Controllers\UserController.cs，容器内识别的路径为DevFreela\DevFreela.API\Controllers\UserController.cs，导致断点无法命中。

修复方案 #

1. 调整Dockerfile目录结构与编译配置 #

修改Dockerfile，确保项目文件的复制路径与容器内工作目录结构一致，避免编译时生成混乱路径：

FROM mcr.microsoft.com/dotnet/sdk:6.0

RUN apt-get update && \
    apt-get install -qq -y --no-install-recommends && \
    apt-get install -y procps && \
    apt install unzip && \
    curl -sSL https://aka.ms/getvsdbgsh | /bin/sh /dev/stdin -v latest -l ~/vsdbg

ENV INSTALL_PATH /DevFreela

RUN mkdir -p $INSTALL_PATH/DevFreela.API

WORKDIR $INSTALL_PATH

# 按本地目录结构复制项目文件
COPY ./DevFreela.API/DevFreela.API.csproj ./DevFreela.API/

RUN dotnet restore ./DevFreela.API/DevFreela.API.csproj

RUN dotnet tool install --global dotnet-ef

ENV PATH="$PATH:/root/.dotnet/tools"

COPY . .

2. 修改启动脚本，强制生成容器内绝对路径 #

更新start-dev.sh，在dotnet run时添加编译参数，确保pdb文件生成Linux风格的容器内绝对路径，而非Windows格式路径：

dotnet ef database update -s ./DevFreela.API/DevFreela.API.csproj
dotnet run --project ./DevFreela.API/DevFreela.API.csproj \
    --property:GenerateFullPaths=true \
    --property:BaseIntermediateOutputPath=/tmp/obj/

3. 配置调试器路径映射（以VS Code为例） #

在.vscode/launch.json中添加路径映射，关联本地代码与容器内代码的对应关系：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Docker .NET Launch",
            "type": "docker",
            "request": "launch",
            "preLaunchTask": "docker-run: debug",
            "netCore": {
                "appProject": "${workspaceFolder}/DevFreela.API/DevFreela.API.csproj",
                "pathMappings": [
                    {
                        "localRoot": "${workspaceFolder}/DevFreela.API",
                        "remoteRoot": "/DevFreela/DevFreela.API"
                    }
                ]
            }
        }
    ]
}

4. 验证docker-compose配置 #

保持原docker-compose.yml的挂载配置不变，确保volumes: - .:/DevFreela与容器工作目录一致即可。

原理说明 #

• GenerateFullPaths=true：强制MSBuild生成绝对路径，避免相对路径导致的跨系统格式差异。
• BaseIntermediateOutputPath=/tmp/obj/：将编译中间文件放到容器临时目录，避免与本地挂载的obj目录冲突，同时确保路径为Linux风格。
• 路径映射：让调试器明确本地代码与容器内代码的对应关系，解决斜杠/反斜杠格式及根目录差异问题。

内容的提问来源于stack exchange，提问作者Jose Luiz Junior