使用Docker部署java项目时遇到的几个错误
0.简介
本文主要是在学习黑马程序员Docker快速入门到项目部署过程中,
对遇到的问题进行了相关的总结梳理
1.本地已存在mysql服务占用3306端口
问题
当我使用docker run -d --name mysql -p 3306:3306 -e TZ=Asia/Shanghai -e MYSQL_ROOT_PASSWORD=123 mysql
准备创建mysql容器时
报错:docker: Error response from daemon: driver failed programming external connectivity on endpoint mysql (733e95fcda57dde10a6cd938e83a1eb8f7441d3bbb5edcd98a53b2eb9c734cbb): Error starting userland proxy: listen tcp4 0.0.0.0:3306: bind: address already in use.
这个错误消息表示端口 3306 已经被占用,因此 Docker 无法将容器的 MySQL 服务端口映射到该端口。通常,这可能是因为本地主机上已经运行了另一个 MySQL 实例或其他进程正在监听相同的端口。
由于我之前跟着黑马程序员学习过前置Linux课程,在其上已安装过Mysql数据库,所以这里会发生端口冲突
解决
1.更改 Docker 容器端口映射:
如果端口 3306 在本地主机上被其他应用程序占用,你可以尝试将容器的 MySQL 服务端口映射到主机上的另一个端口,例如 3307
docker run -d --name mysql -p 3307:3306 -e TZ=Asia/Shanghai -e MYSQL_ROOT_PASSWORD=123 mysql
2.卸载本机的Mysql数据库
1.停止MySQL服务
sudo systemctl stop mysql
2.卸载Mysql
参考链接:Centos7 完全卸载mysql
1、查看mysql安装了哪些东西
rpm -qa |grep -i mysql
2.将安装的项目均进行卸载
yum remove mysql-community-common-5.7.20-1.el7.x86_64
yum remove mysql-community-client-5.7.20-1.el7.x86_64
yum remove mysql57-community-release-el7-11.noarch
yum remove mysql-community-libs-5.7.20-1.el7.x86_64
yum remove mysql-community-server-5.7.20-1.el7.x86_64
3.查看是否卸载完成
rpm -qa |grep -i mysql
若显示为空即可
4.查找mysql相关目录
find / -name mysql
5.删除相关目录
rm -rf ...
2.Mysql版本过低导致在导入其sql脚本时报错
问题
这个我是先去数据库导入sql脚本的,这里用的还是之前学习Linux中的老版Mysql(5.7.43),并没有用Docker进行部署(用了的话应该会自动帮你升级成最新的)
例子
例一:
错误
CREATE DATABASE IF NOT EXISTS hmall /!40100 DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci / /!80016 DEFAULT ENCRYPTION='N'/;
报错:应为 CHAR, CHARACTER, CHARSET 或 COLLATE,得到 'ENCRYPTION'
原因
这个错误是因为在创建数据库时使用了一个不支持的选项 DEFAULT ENCRYPTION。
在 MySQL 中,DEFAULT ENCRYPTION 选项用于指定数据库的默认加密级别,但在早期的 MySQL 版本中(40100),它可能不被支持。
例二:
错误
[2023-11-02 22:58:19] [HY000][1273] Unknown collation: 'utf8mb4_0900_ai_ci'
[2023-11-02 22:58:19] [HY000][1273] Unknown collation: 'utf8mb4_0900_ai_ci'
原因
未知的排序规则(collation)'utf8mb4_0900_ai_ci'。
这个错误通常出现在 MySQL 版本中,不支持或不识别特定的排序规则。在 MySQL 8.0 之前的版本中,通常使用的 utf8mb4 字符集的默认排序规则是 'utf8mb4_general_ci',而不是 'utf8mb4_0900_ai_ci'。
解决方法
同上条,删除了本机的Mysql数据库,然后使用Docker部署了新版本的Mysql数据库就解决了问题。
3.在部署Nginx时需要使用80端口,和Apache HTTP 服务器发生端口冲突
问题
在使用docker run -d --name nginx -p 80:80 nginx
准备进行Nginx容器创建时,发生报错:
[root@localhost docker]# docker run -d --name nginx -p 80:80 nginx
2b0240a1672b8299d03a256fd9c241a3c9fe8bc993cfb2bfef618a47fe0a7283
docker: Error response from daemon: driver failed programming external connectivity on endpoint nginx (a9ddf8564f84136fcc96d40aeb9fe64e2cbfff5c11d6f70bcf4cbd5fd65857bc): Error starting userland proxy: listen tcp4 0.0.0.0:80: bind: address already in use.
解决方法
通过lsof -i命令得知目前占用80端口的是Apache HTTP 服务器,我们这里并不使用,所以接下来选择直接杀死进程。
[root@localhost docker]# lsof -i :80
COMMAND PID USER FD TYPE DEVICE SIZE/OFF NODE NAME
httpd 6869 root 4u IPv6 56084 0t0 TCP *:http (LISTEN)
httpd 8591 apache 4u IPv6 56084 0t0 TCP *:http (LISTEN)
httpd 8592 apache 4u IPv6 56084 0t0 TCP *:http (LISTEN)
httpd 8593 apache 4u IPv6 56084 0t0 TCP *:http (LISTEN)
httpd 8594 apache 4u IPv6 56084 0t0 TCP *:http (LISTEN)
httpd 8595 apache 4u IPv6 56084 0t0 TCP *:http (LISTEN)
使用fuser -k 80/tcp
杀死进程,再进行容器创建即可。
4.未将Mysql,Nginx,hmall(Java项目即应用程序)连接到同一桥接网络(bridge)导致错误
问题
在访问 (虚拟机IP地址):80/search/list?pageNo=1&pageSize=5时,
返回的并不是数据而是{"code":500,"msg":"服务器内部异常","data":null}
解决方式
1.首先查看java项目运行日志
使用docker logs -f hmall进行追踪,发现关键错误如下:
Caused by: java.net.UnknownHostException: mysql
at java.base/java.net.InetAddress$CachedAddresses.get(Unknown Source) ~[na:na]
at java.base/java.net.InetAddress.getAllByName0(Unknown Source) ~[na:na]
at java.base/java.net.InetAddress.getAllByName(Unknown Source) ~[na:na]
at java.base/java.net.InetAddress.getAllByName(Unknown Source) ~[na:na]
at com.mysql.cj.protocol.StandardSocketFactory.connect(StandardSocketFactory.java:132) ~[mysql-connector-java-8.0.23.jar!/:8.0.23]
at com.mysql.cj.protocol.a.NativeSocketConnection.connect(NativeSocketConnection.java:63) ~[mysql-connector-java-8.0.23.jar!/:8.0.23]
... 95 common frames omitted
解析:
这个错误是 MySQL 客户端无法解析主机名 "mysql",因此无法连接到 MySQL 服务器。
联想到我们在java项目中的配置。
这里并不是使用实际ip地址,而是灵活使用我们定义的host名,具体的定义根据dev寻找到application-dev.yaml文件。
application-dev.yaml文件内容如下:
这里使用的host名为容器名,即mysql,所以java项目在连接数据库时,定是应该先将容器名转化为实际的ip地址,然后进行连接。
2.定位错误原因
这里注意到只有在同一个自定义网络中的容器,才可以通过别名互相访问,我这里并没有设置别名,用的就是默认的容器名。
具体错误的原因是什么呢?我是同时看黑马视频和文档进行学习的,中间学习mysql部署和java项目部署隔了一段时间,mysql部署时跟的是文档来的,接入了hmall桥接网络中。而在后面部署hmall(java项目)时,跟的是视频来的,接入了heima桥接网络中,二者并不在同一桥接网络中,导致无法互相通过容器名访问。
3.解决方法
将hmall从heima桥接网络中断开连接,连接至hmall桥接网络即可。
docker network disconnect heima hmall
docker network disconnect hmall hmall
5.重新启动虚拟机后,虽启动docker内所有容器,但是mysql服务实际上未启动
问题
重新启动虚拟机后,进行测试,发现无法正常打开网页?
追踪java日志得知关键错误所在: Connection refused(数据库拒绝连接)
at java.base/java.net.PlainSocketImpl.socketConnect(Native Method) ~[na:na]
at java.base/java.net.AbstractPlainSocketImpl.doConnect(Unknown Source) ~[na:na]
at java.base/java.net.AbstractPlainSocketImpl.connectToAddress(Unknown Source) ~[na:na]
at java.base/java.net.AbstractPlainSocketImpl.connect(Unknown Source) ~[na:na]
at java.base/java.net.SocksSocketImpl.connect(Unknown Source) ~[na:na]
at java.base/java.net.Socket.connect(Unknown Source) ~[na:na]
at com.mysql.cj.protocol.StandardSocketFactory.connect(StandardSocketFactory.java:155) ~[mysql-connector-java-8.0.23.jar!/:8.0.23]
... 95 common frames omitted
解决
这里数据库拒绝连接有多种可能:
-
MySQL 服务器未运行:请确保 MySQL 服务器已正确启动。您可以使用 docker ps 命令检查是否存在运行中的 MySQL 容器。
-
MySQL 服务器端口不正确:如果 MySQL 服务器在容器内运行,确保您的应用程序的数据库连接配置中的端口与 MySQL 服务器的端口匹配。默认情况下,MySQL 使用 3306 端口。
-
防火墙问题:如果 MySQL 服务器运行在不同的主机上,确保防火墙允许应用程序服务器连接到 MySQL 服务器的端口。
-
网络配置错误:确保应用程序容器与 MySQL 容器连接到相同的 Docker 网络。在您的 docker run 命令中,您可以使用 --network 选项指定网络,以确保容器可以互相通信。
-
MySQL 凭证问题:检查应用程序的数据库连接配置,包括主机名、端口、用户名和密码,确保它们正确。
但由于之前测试成功,所以可以排除后面几种可能,应当就是未开启mysql
那么便进入容器中启动即可
(进入容器)docker exec -it mysql bash
(开启数据库)mysqld
这里有一个小问题,就是 MySQL 8.0 版本引入了更严格的安全性控制,不再允许将 MySQL 服务器以 root 用户身份运行。(经实际测试,数据库还是成功启动的)。但是有需要的话,即可以以其他身份用户运行数据库即可。
2023-11-03T10:37:09.997056Z 0 [ERROR] [MY-010123] [Server] Fatal error: Please read "Security" section of the manual to find out how to run mysqld as root!
2023-11-03T10:37:09.997153Z 0 [ERROR] [MY-010119] [Server] Aborting
2023-11-03T10:37:10.555109Z 0 [System] [MY-010910] [Server] /usr/sbin/mysqld: Shutdown complete (mysqld 8.0.27) MySQL Community Server - GPL.