排查Linux Docker中.NET Core Web应用启动时的SDK缺失错误

核心原因 #

你使用的mcr.microsoft.com/dotnet/aspnet:8.0-jammy是**.NET运行时镜像**，仅包含运行.NET应用所需的Runtime环境，没有SDK，所以执行dotnet --version报错属于正常现象。但启动应用时触发相同错误，大概率是以下问题：

1. ENTRYPOINT中指定的dll文件名错误：你写的是webapp.dll，但实际发布后的dll名称会和项目名称一致（比如你的项目是webapp_NET8_Linux，则dll名为webapp_NET8_Linux.dll）。
2. 发布路径或文件复制逻辑存在偏差（但你已确认容器内存在dll，该可能性较低）。

解决步骤 #

步骤1：确认发布后的dll文件名 #

在Dockerfile的构建阶段添加查看命令，明确实际生成的dll名称：

RUN dotnet publish "webapp_NET8_Linux.sln" --no-restore -c Release -o /app/publish -p:TargetFramework=net8.0
# 添加该行查看发布目录内容
RUN ls -la /app/publish

重新构建镜像，查看构建日志里的发布目录文件列表，找到正确的dll文件名。

步骤2：修正ENTRYPOINT中的dll名称 #

将Dockerfile最后一行的webapp.dll替换为实际的dll文件名，例如项目名称为webapp_NET8_Linux时修改为：

ENTRYPOINT ["dotnet", "webapp_NET8_Linux.dll"]

额外验证（可选） #

如果修正后仍有问题，可在容器内手动运行应用排查：

docker run --rm -it --entrypoint /bin/bash <镜像ID>
# 在容器内执行
dotnet <实际dll文件名>

根据输出的具体错误信息进一步定位问题。

补充说明 #

• .NET运行时镜像（aspnet/runtime系列）仅能运行已发布的应用，无法执行SDK相关命令（如dotnet restore、dotnet publish、dotnet --version），这是设计预期。
• 你的Dockerfile多阶段构建结构是合理的：用SDK镜像完成构建，用Runtime镜像运行应用，能有效缩小最终镜像体积。

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