47个Docker常见故障的原因和解决方式

2023-09-22 11:23:35

本文针对Docker容器部署、维护过程中，产生的问题和故障，做出有针对性的说明和解决方案，希望可以帮助到大家去快速定位和解决类似问题故障。

Docker是一种相对使用较简单的容器，我们可以通过以下几种方式获取信息：

1、通过docker run执行命令，或许返回信息

2、通过docker logs 去获取日志，做有针对性的筛选

3、通过systemctl status docker查看docker服务状态

4、通过journalctl -u docker.service 查看日志

以下是整理的docker容器类问题故障，分为9个类

一、启动类故障

1、docker: Cannot connect to the Docker daemon at unix:///var/run/docker.sock. Is the docker daemon running?

原因：Docker未正常启动

解决方式：systemctl start docker

2、can't create unix socket /var/run/docker.sock: is a directory

原因：docker.sock不能创建

解决方式：rm -rf /var/run/docker.sock

然后重新启动docker

3、Job for docker.service failed. Failed to start Docker Application

原因：Selinux引起

解决方式：/etc/sysconfig/selinux , 把 selinux 值改为disabled

重启docker解决

4、docker: Error response from daemon:

/var/lib/docker/overlay/XXXXXXXXXXXXXXXXXXXXXXX: no such file or directory.

原因：docker没有指定目录或文件

解决方式：

systemctl stop docker

rm -rf /var/lib/docker/*

systemctl start docker

重启run镜像启动容器

5、docker: Error response from daemon: Conflict. The container name "XXX" is already in use by container "XXX". You have to remove (or rename) that container to be able to reuse that name.

原因：docker name重名

解决方式：改名容器或者删除重建容器

6、Error: Connection activation failed: No suitable device found for this connection

原因：网卡配置问题

解决方式：重启网卡

7、系统重启后docker无法启动

报错为：docker0: iptables: No chain/target/match by that name

原因：docker服务iptables问题

解决方式：重启docker服务system restart docker

8、Error starting daemon: error initializing graphdriver: driver not supported

使用overlay2存储驱动启动docker daemon报错

原因：daemon缺少配置

解决方式：

添加配置：

/etc/docker/daemon.json

{"storage-driver": "overlay2",

"storage-opts": ["overlay2.override_kernel_check=true"]}

9、Failed to start docker.service: Unit docker.service is masked.

未知原因：docker 被mask

解决方式：

systemctl unmask docker.service

systemctl unmask docker.socket

systemctl start docker.service

10、Failed to start docker.service: Unit is not loaded properly: Invalid argument.

未知原因：docker服务无法正常load

解决方式：卸载docker， 删除docker.service

重新安装docker

11、docker-compose启动容器时报错：

/usr/lib/python2.7/site-packages/requests/init.py:80: RequestsDependencyWarning: urllib3 (1.22) or chardet (2.2.1) doesn't match a supported version! RequestsDependencyWarning)

未知原因：pip相应组件版本不支持

解决方式：

pip uninstall urllib3

pip uninstall chardet

pip install requests

12、docker容器重启故障

强杀docker进程后，重启docker。docker中的容器无法启动并报错

docker restart XXXXXXX Error response from daemon: Cannot restart container XXXXXXX: container "XXXXXXXXXXXXXXXX": already exists

原因：旧容器未安全退出

解决方式：docker-containerd-ctr --address /run/docker/containerd/docker-containerd.sock --namespace c rm <容器hash_id>

docker start 容器

13、docker重启错误-重启命令一直卡住

systemctl restart docker 卡住

未知原因：可能是启动的容器数量过多，或者磁盘IO问题

解决方式：

systemctl start docker-cleanup.service

systemctl start docker

二、权限问题报错

14、Got permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock

解决方式：

查看 /var/run/docker.sock所在用户组

将用户重新加入docker组中，usermod -aG docker ${USER}

15、chown socket at step GROUP: No such process

原因：docker无法找到Group组信息，docker组有可能被误删除，

解决方式：groupadd docker

16、Post http:///var/run/docker.sock/v1.XXX /auth: dial unix /var/run/docker.sock: permission denied. Are you trying to connect to a TLS-enabled daemon without TLS?

原因：非Root用户管理Docker时，权限不足

解决方式：

groupadd docker

usermod -a -G docker user

17、docker commit镜像时报错

Error processing tar file(exit status 1): unexpected EOF

原因：可能是权限问题引起

解决方式：chmod +x 加一个执行权限

三、镜像和仓库问题报错

18、Get https://registry-1.docker.io/v2/: dial tcp: lookup registry-1.docker.io

原因：Docker仓库无法访问

解决方式：

修改Docker仓库源为国内或者自建的仓库源

修改/etc/docker/daemon.json

19、推送本地镜像报错

The push refers to a repository [XXXX] Get https://xxx/v1/_ping: http: server gave HTTP response to HTTPS client

原因：docker registry未采用https服务所致

解决方式：

/etc/docker/daemon.json 文件写入：

{ "insecure-registries":[""] }

20、/usr/bin/docker-current: Error response from daemon: oci runtime error: container_linux.go: starting container process caused "exec: \"/bin/bash\": executable file not found in $PATH".

原因：Docker镜像自身问题或者Docker引擎版本比较低导致

解决方式：可以升级Docker版本服务

21、构建镜像，执行chown -R非常慢

原因：Docker使用写时复制策略，所以chown命令执行时，会将上层镜像文件全部复制到当前层，然后再修改权限，再写入文件系统。

解决方式：不应该使用chown -R 这类大批量修改文件的命令

22、docker build构建镜像的时候报错：

Message from syslogd kernel:unregister_netdevice: waiting for lo to become free. Usage count = 1

原因：docker engine版本过高

解决方式：docker engine版本需要和docker内部镜像的内核版本匹配

23、docker: Error response from daemon: containerd: container did not start before the specified time-out.ERRO[0133] error getting events from daemon: context canceled

原因：修改完docker root dir，重启后，下载镜像报错

解决方式：重启docker服务或者重启服务器

四、资源问题报错

24、Docker no space left on device

原因：空间不足

解决方式：清理空间,删除未被使用的容器，镜像等资源

docker system prune -a

25、/var/lib/docker/containers 占用过大

原因：日志文件占用过大

解决方式：

cat /dev/null > *-json.log

或者

增加dockerd启动参数，/etc/docker/daemon.json

{"log-driver":"json-file",

"log-opts": {"max-size":"2G", "max-file":"10"}

26、max virtual memory areas vm.max_map_count [65530] is too low, increase to at least [262144]

原因：系统参数默认配置过小

解决方式：修改/etc/sysctl.conf里面的vm.max_map_count 调大

27、Got starting container process caused "process_linux.go:301:

running exec setns process for init caused \"exit status 40\"": unknown.

from time to time

原因：可能是cache问题引起

解决方式：echo 1 > /proc/sys/vm/drop_caches

28、docker本机启动多台容器导致出现后续容器启动失败

原因：查看硬盘空间是否满，如果不是硬盘空间问题引起

解决方式：

vim /etc/sysctl.conf

添加参数 fs.aio-max-nr = 1048576

sysctl -p

29、Docker启动异常，状态反复restarting

Docker logs 容器名，查看异常日志

查看/var/log/messages

原因：内存跑满，引起OOM

解决方式：释放内存后，再启动容器

五、版本不兼容报错

30、overlayfs: Can't delete file moved from base layer to newly created dir even on ext4

原因：Centos 提供的文件系统 XFS 和 Overlay 兼容问题导致,

解决方式：这个问题的修复在内核 4.4.6以上

31、docker: Error response from daemon: OCI runtime create failed: container_linux.go:344: starting container process caused "process_linux.go:297: getting the final child's pid from pipe caused \"read init-p: connection reset by peer\"": unknown.

原因：Docker版本和操作系统版本不匹配

解决方式：重新安装和操作系统内核支持的docker 版本

六、网络或端口问题报错

32、WARNING: IPv4 forwarding is disabled. Networking will not work.

原因：ipv4网络无法转发

解决方式:

/usr/lib/sysctl.d/00-system.conf

在最后一行添加net.ipv4.ip_forward=1

重启network服务。删除错误的容器，再次创建新容器

33、Creating network "xxxxxxx" with the default driver

原因：docker网关冲突

启动容器、docker-compose启动容器后，断网问题

解决方式：配置 docker-compose.yml内给启动的容器配置参数network_mode: "bridge"

34、Unable to find a node that satisfies the following conditions [port xxxx]

原因：当容器使用端口映射(docker run -p xxxx:xxxx或 compose模板中的

ports)之后 系统会在宿主机上创建一个port，通过NAT来访问容器的指定port。如果宿主机上的端口被容器或者系统进程占用，就会导致端口分配失败。

解决方式：清除占用端口的容器或者进程，或调整容器端口映射的宿主机端口避免冲突

35、Error response from daemon: service endpoint with name xxx already

原因：端口已经被占用

解决方式：重启docker容器

36、docker: Error response from daemon: driver failed programming external connectivity on endpoint XXXXX: Bind for 0.0.0.0:80 failed: port is already allocated

原因：容器端口冲突

解决方式：更换宿主机绑定端口

七、Docker安装报错

37、安装docker报Requires: container-selinux >= 2.9

原因：container-selinux版本低或者是没安装的原因

解决方式：

wget -O /etc/yum.repos.d/CentOS-Base.repo

http://mirrors.aliyun.com/repo/Centos-7.repo

yum install epel-release

yum makecache

yum install container-selinux

38、安装docker-compose时报错

“ImportError: 'module' object has no attribute 'check_specifier'”

原因：setuptools版本问题

解决方式：

升级setuptools到30.1.0版本以上版本

pip install --upgrade setuptools

39、安装docker-compose时报错

DEPRECATION: Python 2.7 will reach the end of its life on January 1st, 2020. Please upgrade your Python as Python 2.7 won't be maintained after that date. A future version of pip will drop support for Python 2.7.

原因：python2.7提示升级

解决方式：pip install -i https://pypi.douban.com/simple docker-compose

八、Docker删除报错

40、docker删除容器报错

Error response from daemon:Driver overlay failed to remove root filesystem xxxxx: remove/var/lib/docker/overlay2/xxxxx/merged: device or resource busy

原因：容器挂载数据卷，无法直接删除

解决方式：

grep docker /proc/*/mountinfo | grep xxxxx

kill进程后

再重新删除容器

41、状态dead的容器删除报错

Error response from daemon: Driver aufs failed to remove root filesystem XXXXXXXXXXXXXXXX: aufs: unmount error after retries: /var/lib/docker/aufs/mnt/xxxxxxxx: device or resource busy

原因：dead状态容器无法删除，还在占用资源

解决方式：docker rm -fv 容器id 过几分钟后会自动删除

42、docker删除镜像报错

Error response from daemon: conflict: unable to remove repository reference "XXXX" (must force) - container XXXX is using its referenced image YYYY

原因：镜像正在被某容器使用

解决方式：需要删除相关ID容器后，才能删除镜像

43、docker删除镜像报错

Error response from daemon: conflict: unable to delete XXXXXXXXXX (must be forced) - image is referenced in multiple repositories

原因：镜像login push 了远端其他仓库

解决方式：如果不需要此镜像， docker rmi -f 强删

44、docker删除镜像报错

Error response from daemon: conflict: unable to delete XXX (cannot be forced) - image has dependent child images

原因：存在依赖于父镜像的子镜像

解决方式：强制删除镜像或者批量删除容器，再删除镜像

九、其他报错

45、docker: Error response from daemon: driver failed programming external connectivity on end-point XXXXXXX: (iptables failed: iptables --wait -t filter -A DOCKER ! -i docker0 -o docker0 -p tcp -d 172.17.0.2 --dport 8080 -j ACCEPT: iptables: No chain/target/match by that name.

原因：防火墙问题引起

解决方式：关闭防火墙，重启docker

46、执行docker info出现如下警告

WARNING: bridge-nf-call-iptables is disabled

WARNING: bridge-nf-call-ip6tables is disabled

原因：配置问题引起，需要启用bridge-nf-call-iptables

解决方式：

vi /etc/sysctl.conf

添加以下内容

net.bridge.bridge-nf-call-ip6tables = 1

net.bridge.bridge-nf-call-iptables = 1

net.bridge.bridge-nf-call-arptables = 1

47、docker数据库相关报错

使用Docker创建mysql容器闪退

Database is uninitialized and password option is not specified

解决方式：docker run -d -e MYSQL_ROOT_PASSWORD=[密码] -p 3306:3306 mysql镜像

为避免出现各种奇怪且偶发的问题，运维和开发人员应该有规范的去使用docker容器，最大程度的去避免因为使用不当而引起的故障，参考以下：

Docker使用规范建议

1.尽量使用最近1-2年的新的稳定的docker版本

不要去安装今年前很老的版本，大量的bug已经被新版本更新解决掉了

2.尽量不要去创建非常大的镜像，比如5G10G以上的

镜像要尽量轻量化，去除不必要的软件，数据等

3.容器内挂载宿主机配置，使用只读

容器需要-v 宿主机的配置文件，尽量使用ro只读

4.数据要挂载宿主机物理硬盘或存储节点上

不要直接在容器里run，避免容器宕机引起数据丢失

5.应用日志一定要挂到宿主机上

不要直接打印到容器内，避免只能docker logs方式查看，避免去vulume目录里查看日志

6.不要只使用latest标签

Tag要有个管理标准，可以根据tag查找对应版本

7.不要使用容器ip，配置里更不能写死（默认172.17.0.x）

容器重启后，ip很可能会变

8.尽量不要在单容器内跑多进程

容器不是虚拟机，尽量做到1个容器，1个进程

9.跨环境镜像保持一致

不论是测试，UAT，生产环境，尽量保持同一个镜像，不要变更，环境变更只需要变更环境变量参数做区分

10.一定监控docker容器，即使发现问题

建议使用prometheus监控容器

11.一定要限制docker容器的资源

尤其是CPU，内存，硬盘空间，甚至是网络等，避免侵占宿主机的硬件资源

更多推荐

基于springboot广场舞团系统springboot16

大家好✌！我是CZ淡陌。一名专注以理论为基础实战为主的技术博主，将再这里为大家分享优质的实战项目，本人在Java毕业设计领域有多年的经验，陆续会更新更多优质的Java实战项目，希望你能有所收获，少走一些弯路，向着优秀程序员前行！🍅更多优质项目👇🏻👇🏻可点击下方获取🍅文章底部或评论区获取🍅Java项目精品实

Linux安装mysql数据库并实现主从搭建

一.环境说明【环境说明】：192.168.110.161mysql-master##网络配置到位，防火墙关闭，selinux关闭192.168.110.162mysql-slave##网络配置到位，防火墙关闭，selinux关闭两台主机，操作系统是centos7，提前网络配置好，关闭防火墙，selinux，修改主机名二

esbuild中文文档-路径解析配置项（Path resolution - External、Main fields）

文章目录路径解析配置项Pathresolution外部模块External主字段Mainfields对于包的开发者结语哈喽，大家好！我是「励志前端小黑哥」，我带着最新发布的文章又来了！老规矩，小手动起来~点赞关注不迷路！esbuild简单介绍esbuild为了突破了JavaScript语言的瓶颈，采用了Go语言编写，构

Vue 如何监听 localstorage的变化

一.说明在日常开发中，我们经常使用localStorage来存储一些变量。这些变量会存储在浏览中。对于localStorage来说，即使关闭浏览器，这些变量依然存储着，方便我们开发的时候在别的地方使用。二.localStorage的使用存储值：window.localStorage.setItem(‘键名’,值)读取值

紫禁之巅-Unity游戏开发教程：勇者斗恶龙之魔法石

说明开设了一个unity游戏开发课程，可以帮助对游戏开发有兴趣的小伙伴学习Unity游戏开发的知识和技术，课程地址第一节课的课件是游戏工程，第二节的课件是大纲，和文章内相同，其它章节的课件和第一节课的相同，不需要重复下载课程大纲课程简介开设课程是为了帮助对游戏开发感兴趣的小伙伴掌握游戏开发的思路、方法、技术。为了帮助学

ps打开找不到MSVCP140.dll重新安装方法，安装ps出现msvcp140.dll缺失解决方法

在计算机中，我们可能会遇到许多问题，其中之一就是找不到msvcp140.dll文件。msvcp140.dll是一个动态链接库文件，它是MicrosoftVisualC++2015Redistributable的一部分。当计算机找不到这个文件时，可能会导致程序无法正常运行。本文将为您提供多个解决方法，以及msvcp140

每日一练 | 华为认证真题练习Day114

1、如图所示，交换机GE0/0/1和GE0/0/2两个端口都进行不同的此Hybrid配置，下面说法正确是（）。（多选）A.财务部门发出的数据帧在交换机中携带的Tag为VLAN20B.行政部门和财务部门不能互访，因为两部门所属的VLAN不相同C.如果交换机的GE0/0/1和GE0/0/2两个端口都修改为Trunk端口，则

头歌平台 | 逻辑函数及其描述工具logisim使用

文章目录1、根据布尔表达式绘制电路2、根据真值表绘制电路3、根据简化真值表绘制电路4、根据波形图绘制电路5、根据卡诺图绘制电路1、根据布尔表达式绘制电路任务描述本关任务：在Logisim中根据给定的布尔代数表达式（F=AB+BC+CA）绘制逻辑电路。案例场景举例举重比赛裁判电路。在举重比赛中，通常有三位裁判（A、B、C

【SQL数据分析 | 手把手教你做淘宝用户分析！】

SQL也能做分析？当然！常见的数据清洗，预处理，数据分类，数据筛选，分类汇总，以及数据透视等操作，用SQL一样可以实现（除了可视化，需要放到Excel里呈现）。SQL不仅可以从数据库中读取数据，还能通过不同的SQL函数语句直接返回所需要的结果，从而大大提高了自己在客户端应用程序中计算的效率。但是，这个过程需要很熟练掌握

TypeScript入门

目录一：语言特性二：TypeScript安装NPM安装TypeScript三：TypeScript基础语法第一个TypeScript程序四：TypeScript保留关键字空白和换行TypeScript区分大小写TypeScript注释TypeScript支持两种类型的注释五：TypeScript与面向对象六：TypeS

如何使用ChatGPT，而不是生成默认风格的八股文

现在我每天都使用ChatGPT来执行多项任务，包括但不限于内容创建。无论是编写文本还是与我讨论我的业务目标，ChatGPT总是会时不时的用到。但与所有强大的工具一样，ChatGPT和类似的大型语言模型(LLM)也有其局限性。在我从事人工智能工作的过程中，我多次偶然发现它们。如果您在业务中依赖ChatGPT而不了解其局限

热文推荐
  1. 源码：TMS FlexCel Studio for .NET 7.19

    TMSFlexCelStudiofor.NET是100%托管代码Excel文件操作引擎以及Excel和PDF报告生成，适用于.NET、Xamarin.iOS、Xamarin.Android、Xamarin.Mac、WindowsPhone和WindowsStore功能概述使用FlexCelStudiofor.NET创建

  2. moea项目的问题解决方案

    moea项目的相关问题报错1：run_GAN-adjlvxm.py':[Errno2]Nosuchfileordirectory报错2：mkdir:cannotcreatedirectory‘./result’:Fileexists报错3：fromfunction.APG-SMOEA_frameworkimportop

  3. 【验证码逆向专栏】螺丝帽人机验证逆向分析

    声明本文章中所有内容仅供学习交流使用，不用于其他任何目的，不提供完整代码，抓包内容、敏感网址、数据接口等均已做脱敏处理，严禁用于商业用途和非法用途，否则由此产生的一切后果均与作者无关！本文章未经许可禁止转载，禁止任何修改后二次传播，擅自使用本文讲解的技术而导致的任何意外，作者均不负责，若有侵权，请在公众号【K哥爬虫】联

  4. python每日一题（模拟用户登录验证）

    1、题目预先设定正确用户名与密码，用来验证用户是否登录成功。第一次：①输入用户名与密码，如果用户名与密码正确，则提示登录成功；②如果用户名错误（不管密码是否正确），则需要重新输入用户名与密码验证，并提示用户名或密码错误；③如果用户名正确，密码错误，打印密码错误，且仅需要输入密码验证，且验证次数仅剩与2次，若在2次验证机

  5. 2023华为杯研究生数学建模E题思路代码分析

    完整的思路代码查看文末名片血肿扩张风险相关因素探索建模。请根据“表1”（字段：入院首次影像检查流水号，发病到首次影像检查时间间隔），“表2”（字段：各时间点流水号及对应的HM_volume），判断患者sub001至sub100发病后48小时内是否发生血肿扩张事件。结果填写规范：1是0否，填写位置：“表4”C字段（是否发

  6. netty报文解析之粘包半包问题

    粘包问题Netty的粘包问题是指在网络传输过程中，由于TCP协议本身的特点，导致发送方发送的若干个小数据包被接收方合并成了一个大数据包。这种情况称为粘包。TCP协议是面向流的协议，没有数据边界，发送方发送的数据可能会被分成多个数据包进行发送，接收方则需要将这些数据包重新组装为原始数据。当接收方处理不当时，就可能会发生粘

  7. 【JavaWeb】你这么厉害，知道RBAC权限模型和ABAC权限模型吗？

    文章目录一.RBAC权限模型1.RBAC的组成2.RBAC模型分类2.1.基本模型RBAC02.2.角色分层模型RBAC12.3.角色限制模型RBAC22.4.统一模型RBAC33.RBAC0模型核心表结构3.1.表结构设计3.2.模块划分4.基于RBAC的延展—用户组二.ABAC权限模型（基于Java讲解）1.ABA

  8. 人机中的事实与价值时空、排序

    人机结合智能与事实价值融合分析确实是未来解决复杂疑难问题的基本策略之一。该策略利用人类智慧和机器智能相结合，结合有效的事实和价值分析方法，以更全面、准确、高效地解决问题。通过人机结合，可以充分发挥人类的主观能动性、判断力和创造力，同时借助机器的强大计算和数据处理能力，提供更深入、广泛的信息搜索、筛选和分析。这种结合能够

  9. 7.2、如何理解Flink中的水位线(Watermark)

    目录0、版本说明1、什么是水位线？2、水位线使用场景？3、设计水位线主要为了解决什么问题？4、怎样在flink中生成水位线？4.1、自定义标记Watermark生成器4.2、自定义周期性Watermark生成器4.3、内置Watermark生成器-有序流水位线生成器4.4、内置Watermark生成器-乱序流水位线生成