Ubuntu系统运行docker镜像出现Invalid argument错误求助

Docker 启动失败排查方案 #

• 校验镜像启动指令配置
  镜像加载成功仅代表镜像文件完整，不代表内部启动逻辑正常，执行以下命令检查镜像的启动入口配置：
  docker inspect backend-api-local | grep -A 10 -B 2 "Cmd\|Entrypoint"
  确认配置中指定的启动脚本/程序路径真实存在，且具备可执行权限。
• 前台运行容器输出实时日志
  去掉后台运行参数-d直接启动容器，即可打印完整启动报错：
  sudo docker run --publish 5001:80 backend-api-local
  可直接定位是依赖缺失、配置文件不存在、内部端口占用类问题。
• 调取已退出容器的历史日志
  先执行sudo docker ps -a找到对应启动失败的容器ID，再执行命令查看日志：
  docker logs <替换为实际容器ID>
• 进入容器内部手动验证启动逻辑
  临时覆盖镜像默认入口点进入容器交互环境，手动执行启动命令排查问题：
  sudo docker run -it --entrypoint /bin/bash backend-api-local
• 排查架构兼容问题
  若镜像为ARM架构设备构建，在x86架构Ubuntu上运行也会出现无明确提示的启动失败，执行命令查看镜像架构：
  docker inspect backend-api-local | grep Architecture
  确认镜像架构和当前运行设备架构一致。

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