Docker 容器启动命令找不到文件怎么排查与修复

大浩小哥_7742

大浩小哥_7742

2026-10-07

667人浏览

原创

本质是运行时无法定位或执行文件,根源在路径、权限、编码、解释器、挂载五环节:先用docker run --rm -it ls -l /app/run.sh验证存在性;若不存在则检查dockerfile的copy路径与上下文;若存在但权限异常或显示^m,需修复crlf换行、确保shebang解释器已安装并赋执行权限;挂载时注意-v会覆盖镜像内文件。

容器启动时报“找不到文件”,比如 /bin/sh: 1: /app/run.sh: not found 或 no such file or directory,本质不是“文件真丢了”,而是容器运行时无法按预期定位或执行它。问题根源集中在路径、权限、编码、解释器和挂载这五个关键环节。

确认文件是否真的在镜像里

别猜,先验证。用以下命令检查镜像中是否存在目标文件:

  • docker run --rm -it <image-name> ls -l /app/run.sh</image-name>(替换为你的实际路径)
  • 如果报错“no such file”,说明构建阶段就没复制进去——检查 Dockerfile 中 COPY 或 ADD 指令的源路径是否正确、文件是否在构建上下文目录内
  • 若文件存在但显示为 ?????????? ? ? ? ? ? /app/run.sh,可能是挂载覆盖或权限异常,需进一步排查

检查脚本换行符与解释器兼容性

Windows 编辑的脚本带 CRLF(\r\n),Linux 容器只认 LF(\n)。shebang 行末的 \r 会让系统误认为解释器路径是 /bin/bash\r,从而报 “not found”。

Dolphindb Docker
Dolphindb Docker

自动化 DolphinDB Docker 部署,支持自动架构检测(ARM64/x86_64),智能内存分配(50% 规则)以及完整数据持久化。

下载
  • 进容器执行:cat -A /app/run.sh | head -n1,若看到 #!/bin/bash^M$ 就是 CRLF 问题
  • 修复方式:本地用 dos2unix run.sh 转换,或在 Dockerfile 中加一步:RUN apt-get update && apt-get install -y dos2unix && dos2unix /app/run.sh
  • 同时确认 shebang 指向的解释器存在,例如 Alpine 镜像没有 /bin/bash,应改用 #!/bin/sh 或安装 bash

验证执行权限与用户上下文

Linux 下脚本必须有 x 权限才能执行;且运行用户需对文件和父目录都有读+执行(r-x)权限。

  • 构建时显式赋权:RUN chmod +x /app/run.sh(推荐放在 COPY 后)
  • 检查容器内权限:docker run --rm -it <image> ls -l /app/</image>,确认输出类似 -rwxr-xr-x 1 root root ... run.sh
  • 若使用非 root 用户启动(如 USER appuser),确保该用户对 /app 目录有访问权,必要时 RUN chown -R appuser:appuser /app

排查挂载与路径覆盖行为

运行时通过 -v 挂载宿主机目录,会**完全覆盖**镜像中同路径内容。若挂载点是 /app,而宿主机该目录下没有 run.sh,容器就真的“找不到”。

  • 检查启动命令是否含 -v,例如 docker run -v $(pwd):/app ... —— 这会把当前目录覆盖进 /app,原镜像文件被隐藏
  • 避免整目录挂载,改用精确文件挂载:-v $(pwd)/run.sh:/app/run.sh:ro
  • 若必须挂载目录,确保宿主机对应路径下包含所有必需文件,或改用命名 volume 管理配置类文件

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

docker docker 容器

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
k8s和docker区别
k8s和docker区别

k8s和docker区别有抽象层次不同、管理范围不同、功能不同、应用程序生命周期管理不同、缩放能力不同、高可用性等等区别。本专题为大家提供k8s和docker区别相关的各种文章、以及下载和课程。

2023.07.24

685

4

docker进入容器的方法有哪些
docker进入容器的方法有哪些

docker进入容器的方法:1. Docker exec;2. Docker attach;3. Docker run --interactive --tty;4. Docker ps -a;5. 使用 Docker Compose。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.08

4959

6

docker容器无法访问外部网络怎么办
docker容器无法访问外部网络怎么办

docker 容器无法访问外部网络的原因和解决方法:配置 nat 端口映射以将容器端口映射到主机端口。根据主机兼容性选择正确的网络驱动(如 host 或 overlay)。允许容器端口通过主机的防火墙。配置容器的正确 dns 服务器。选择正确的容器网络模式。排除主机网络问题,如防火墙或连接问题。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.08

5917

6

docker镜像有什么用
docker镜像有什么用

docker 镜像是预构建的软件组件,用途广泛,包括:应用程序部署:简化部署,提高移植性。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.08

2233

7

Docker容器化部署与DevOps实践
Docker容器化部署与DevOps实践

本专题面向后端与运维开发者,系统讲解 Docker 容器化技术在实际项目中的应用。内容涵盖 Docker 镜像构建、容器运行机制、Docker Compose 多服务编排,以及在 DevOps 流程中的持续集成与持续部署实践。通过真实场景演示,帮助开发者实现应用的快速部署、环境一致性与运维自动化。

2026.02.11

239

16

Docker 容器部署
Docker 容器部署

本专题整合了Docker容器部署相关内容,阅读专题下面的文章了解更多详细操作教程。

2026.03.31

431

14

Java容器化部署与Docker实践教程合集
Java容器化部署与Docker实践教程合集

聚焦 Java 应用的容器化与云原生部署,讲解 Dockerfile 编写规范与 Java 应用镜像构建、多阶段构建(Multi-stage Build)减小镜像体积、Jib / Buildpacks 免 Dockerfile 镜像构建方案、JVM 容器感知参数(-XX:MaxRAMPercentage)配置、Docker Compose 编排多服务(应用 + MySQL + Redis)、容器健康检查与资源限制、Kubernetes

2026.05.11

380

26

Go Docker与容器化部署教程合集
Go Docker与容器化部署教程合集

聚焦 Go 应用的容器化部署优势与实践,讲解 Go 静态编译特性(CGO_ENABLED=0)与 scratch / distroless 极小基础镜像构建、多阶段 Dockerfile 编写规范、交叉编译生成目标平台二进制、镜像安全扫描(Trivy)与漏洞修复、Docker Compose 本地编排开发环境、Kubernetes Deployment / Service / ConfigMap 部署 Go 服务、健康检查(Livene

2026.05.15

285

24

Hyperf 项目部署运维与性能调优手册
Hyperf 项目部署运维与性能调优手册

聚焦 Hyperf 在生产环境的落地,包含 Docker 高效打包、Swoole 配置优化、常见的内存溢出(OOM)问题排查方法以及热更新方案。

2026.05.19

405

15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
phpMyAdmin 安装文档
phpMyAdmin 安装文档

共0课时 | 0人学习

Docker 官方文档
Docker 官方文档

共0课时 | 0人学习

宝塔 Docker 模块使用手册
宝塔 Docker 模块使用手册

共0课时 | 0人学习