基于ubuntu:22.10构建MariaDB Docker镜像报2002套接字错误咨询

Ubuntu 22.10 环境下基于apt安装mariadb-server后出现socket连接错误，是Docker环境特性与mariadb默认安装逻辑不匹配导致，核心原因有三点：

• Docker构建阶段无systemd等init系统，apt安装mariadb-server过程中不会自动执行服务初始化、拉起mysqld进程，没有运行中的服务自然不会生成/run/mysqld/mysqld.sock文件
• /run是Docker默认挂载的tmpfs临时文件系统，镜像构建阶段在该路径下生成的所有内容，都会在容器启动时被清空，即便构建阶段手动启动过mariadb生成socket，容器启动后也会消失
• mariadb运行时需要/run/mysqld目录的所有者为mysql用户，若目录不存在或权限不匹配，mysqld启动时会因无法写入socket文件直接退出。

不要使用临时修改配置、构建阶段启动服务的方案，按以下逻辑配置可实现容器启动即可用：

1. 安装阶段预配置基础环境 #

在Dockerfile中添加以下安装逻辑，跳过安装交互、提前固定目录权限：

ENV DEBIAN_FRONTEND=noninteractive
RUN apt update && \
    apt install -y --no-install-recommends mariadb-server && \
    # 预创建socket目录并固定权限，避免tmpfs清空后启动报错
    mkdir -p /run/mysqld && \
    chown mysql:mysql /run/mysqld && \
    chmod 755 /run/mysqld && \
    # 清理apt缓存减小镜像体积
    rm -rf /var/lib/apt/lists/*

2. 编写运行时入口脚本 #

数据库初始化、服务启动逻辑必须放在容器运行阶段执行，不能固化在镜像构建层。创建entrypoint.sh脚本，内容如下：

#!/bin/bash
# 首次启动时初始化数据目录（仅数据目录为空时执行）
if [ ! -d "/var/lib/mysql/mysql" ]; then
    mysql_install_db --user=mysql --datadir=/var/lib/mysql
fi
# 后台启动mysqld进程
mysqld --user=mysql --datadir=/var/lib/mysql &
# 等待服务就绪，最长等待30秒
for i in {1..30}; do
    if mysqladmin ping >/dev/null 2>&1; then
        break
    fi
    sleep 1
done
# 可在此处追加自定义初始化逻辑：设置root默认密码、创建业务库、导入业务数据等
# 示例：设置root本地登录密码
# mysql -u root -e "ALTER USER 'root'@'localhost' IDENTIFIED BY 'your_default_passwd';"

# 等待mysqld进程前台运行，保持容器不退出
wait %1

3. 配置镜像入口点 #

在Dockerfile中添加以下配置，将入口脚本设为容器启动入口，不要使用service/systemctl类命令启动服务（Docker环境无systemd上下文，这类命令无法正常工作）：

COPY entrypoint.sh /usr/local/bin/entrypoint.sh
RUN chmod +x /usr/local/bin/entrypoint.sh
EXPOSE 3306
ENTRYPOINT ["/usr/local/bin/entrypoint.sh"]

以下方案无法解决根本问题，不建议使用：

• 构建阶段执行service mariadb start：仅在构建过程中临时拉起进程，构建结束后进程自动退出，容器启动时不会自动恢复，且/run目录清空后socket文件会丢失
• 手动修改my.cnf调整socket路径：未解决mysqld进程未启动、目录权限不匹配的核心问题，修改路径后依然会报连接错误
• 手动创建socket文件或软链接：socket是服务运行时动态生成的通信文件，手动创建的文件无对应进程监听，无法正常通信

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