.NET 5控制台后台服务部署Docker Linux容器启动报错求助

你遇到的错误提示本质上是容器内执行dotnet FileProcessSvcPOC.dll时，dotnet工具找不到目标dll文件，并非真的缺少.NET SDK。你最终运行的镜像基于.NET 5 runtime镜像，仅包含运行时不包含SDK属于正常情况，执行.NET应用本身不需要SDK，仅构建阶段需要。

你可以按照以下步骤逐一排查：

1. 验证镜像内是否存在目标dll #

在本地执行以下命令，查看镜像内/app目录下的文件列表：

docker run --rm --entrypoint bash <替换为你的镜像名称> -c "ls /app"

• 如果输出中没有FileProcessSvcPOC.dll：说明构建阶段的文件拷贝或发布步骤出错。请检查：
  • 执行docker构建的上下文是否为解决方案根目录（也就是包含FileProcessSvcPOC文件夹的上层目录）
  • 项目的.csproj文件中是否自定义了参数，修改了生成的dll名称，导致和ENTRYPOINT中指定的名称不匹配
  • 发布配置是否为自包含部署，自包含部署不会生成dll，只会生成可执行文件，此时需要修改ENTRYPOINT直接执行可执行文件，不需要加dotnet前缀
• 如果输出中存在该dll：继续往下排查

2. 移除UseSystemd()配置 #

UseSystemd()是用于将服务托管到Linux主机的systemd进程时的配置，Docker容器默认不存在systemd运行环境，该配置会导致进程启动时尝试访问不存在的systemd接口，启动失败。你可以先注释掉Program.cs中的.UseSystemd()代码行，重新构建镜像测试。

3. 清理构建缓存重新构建 #

你提供的构建日志中所有步骤都标记为CACHED，可能存在旧的错误构建缓存被复用的情况，执行以下命令完全重新构建镜像：

docker-compose build --no-cache

重新构建完成后再部署测试。

4. 手动执行命令定位具体错误 #

如果上述步骤都无法解决，你可以启动容器并覆盖默认入口点，手动执行命令查看详细报错：

docker run -it --rm --entrypoint bash <替换为你的镜像名称>
# 进入容器后执行
dotnet /app/FileProcessSvcPOC.dll

根据输出的具体报错信息再针对性调整配置。

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