VS2022中使用Alpine镜像调试独立Docker化ASP.NET应用失败

可正常工作的Dockerfile（基于aspnet:6.0镜像） #

FROM mcr.microsoft.com/dotnet/aspnet:6.0 AS base
WORKDIR /app
EXPOSE 80

FROM mcr.microsoft.com/dotnet/sdk:6.0 AS publish
RUN dotnet publish "./MyAPI.csproj" -c Release -o /app/publish --runtime linux-musl-x64 --self-contained /p:PublishTrimmed=true /p:PublishSingleFile=true

FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .
ENTRYPOINT ["dotnet", "MyAPI.dll"]

无法正常工作的Dockerfile（基于runtime-deps:6.0-alpine镜像） #

FROM mcr.microsoft.com/dotnet/runtime-deps:6.0-alpine AS base
WORKDIR /app
EXPOSE 80

FROM mcr.microsoft.com/dotnet/sdk:6.0 AS publish
RUN dotnet publish "./MyAPI.csproj" -c Release -o /app/publish --runtime linux-musl-x64 --self-contained /p:PublishTrimmed=true /p:PublishSingleFile=true

FROM base AS final
WORKDIR /app
RUN apk add --no-cache icu-libs krb5-libs libgcc libintl libssl1.1 libstdc++ zlib
COPY --from=publish /app/publish .
ENTRYPOINT  ["./MyAPI"]

错误信息 #

One or more errors occurred.
Failed to launch debug adapter. Additional information may be available in the output window.
launch: program "" does not exist.

用户疑问：原本以为只需更换基础镜像并补充Alpine缺失的包即可，想让开发环境贴近生产环境，请问遗漏了什么？

核心遗漏点 #

VS2022的Docker调试机制依赖非自包含部署的调试逻辑，你的配置同时触发了两个冲突点：

1. runtime-deps镜像仅包含运行时依赖库，没有dotnet命令和VS调试必需的工具链组件，调试器无法完成初始化
2. 自包含单文件发布的程序，VS调试器无法识别直接执行的入口格式（默认期望dotnet [dll]的调用模式）
3. Alpine镜像缺少调试所需的额外依赖（如lldb调试工具、符号支持库等）

修正方案 #

方案1：分阶段构建，区分调试与生产镜像 #

通过多阶段构建，调试阶段使用带完整运行时和调试组件的Alpine镜像，生产阶段保持轻量的runtime-deps镜像：

# 调试阶段基础镜像（包含运行时和调试组件）
FROM mcr.microsoft.com/dotnet/aspnet:6.0-alpine AS base
WORKDIR /app
EXPOSE 80
# 安装调试所需额外依赖
RUN apk add --no-cache icu-libs krb5-libs libgcc libintl libssl1.1 libstdc++ zlib lldb

# 发布阶段：调试时关闭单文件和裁剪，方便调试器识别
FROM mcr.microsoft.com/dotnet/sdk:6.0 AS publish
RUN dotnet publish "./MyAPI.csproj" -c Debug -o /app/publish --runtime linux-musl-x64 --self-contained false

# 调试镜像（VS中选择此阶段调试）
FROM base AS debug
WORKDIR /app
COPY --from=publish /app/publish .
ENTRYPOINT ["dotnet", "MyAPI.dll"]

# 生产镜像（保持原有的轻量配置）
FROM mcr.microsoft.com/dotnet/runtime-deps:6.0-alpine AS final
WORKDIR /app
RUN apk add --no-cache icu-libs krb5-libs libgcc libintl libssl1.1 libstdc++ zlib
COPY --from=publish /app/publish .
ENTRYPOINT ["./MyAPI"]

方案2：临时调整发布配置以支持调试 #

如果不需要在调试阶段严格模拟生产的单文件配置，可修改发布命令关闭单文件和裁剪，同时使用带运行时的Alpine镜像：

FROM mcr.microsoft.com/dotnet/aspnet:6.0-alpine AS base
WORKDIR /app
EXPOSE 80
RUN apk add --no-cache icu-libs krb5-libs libgcc libintl libssl1.1 libstdc++ zlib

FROM mcr.microsoft.com/dotnet/sdk:6.0 AS publish
RUN dotnet publish "./MyAPI.csproj" -c Debug -o /app/publish --runtime linux-musl-x64 --self-contained false

FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .
ENTRYPOINT ["dotnet", "MyAPI.dll"]

调试完成后，再切换回生产配置的Dockerfile进行发布。

关键说明 #

VS的Docker调试对自包含单文件应用的支持有限，尤其是Alpine这类轻量镜像。若要完全贴近生产环境调试，建议采用远程调试模式：先构建生产镜像并启动容器，再手动将VS调试器附加到容器进程，而非依赖VS的自动调试流程。

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