如何调试启动失败且无法进入终端的Docker镜像运行错误问题

通用排查步骤 #

• 覆盖启动命令直接进入终端
  镜像默认启动命令执行失败导致无法进入终端时，可在运行时覆盖默认入口，直接启动shell：

  docker run -it --entrypoint /bin/sh thoughts-backend
  

  该命令会跳过默认的启动脚本执行，直接进入容器终端，方便后续排查内部文件问题。
• 查看退出容器的完整日志
  即使容器启动后立刻退出，也可通过以下命令查看完整报错信息：
  1. 先执行docker ps -a找到对应退出容器的ID
  2. 执行docker logs <容器ID>输出完整运行日志，定位报错点
• 检查容器内关键文件属性
  进入容器终端后，优先检查启动相关文件的配置：
  1. 检查执行权限：执行ls -l /opt/uwsgi/start_server.sh确认脚本有可执行权限
  2. 检查文件格式：执行cat -A /opt/uwsgi/start_server.sh，如果行尾显示^M$说明是Windows格式的CRLF换行，Linux系统的shell无法正常解析。

本次报错的具体解决方案 #

你给出的报错信息明确指向start_server.sh脚本的换行格式错误，是Windows环境下克隆/编辑脚本时自动转换为CRLF换行导致的，Alpine镜像自带的/bin/sh仅支持LF格式换行，解析时把行尾的\r识别为命令的一部分，才会出现line X: : not found这类报错。
修复方法二选一即可：

1. 本地修改脚本格式：用VS Code等编辑器打开docker/app/start_server.sh，将右下角的换行格式从CRLF改为LF后保存，重新构建镜像即可
2. 在Dockerfile中添加自动转换逻辑，避免本地环境影响，在ADD脚本的步骤后增加以下命令：

RUN apk add --no-cache dos2unix && dos2unix /opt/uwsgi/start_server.sh && chmod +x /opt/uwsgi/start_server.sh

该步骤会自动转换脚本换行格式，同时给脚本添加执行权限，之后重新构建镜像即可正常启动。

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