### 问题分析 当使用 `docker run` 启动 MySQL 容器后，如果在执行 `docker ps` 时未显示该容器，通常是因为容器启动后立即退出（状态为 `Exited`）。这种情况可能由以下原因引起： 1. **配置文件错误**：如果在挂载的自定义配置文件（如 `my.cnf`）中存在语法或逻辑错误，可能导致 MySQL 服务无法正常启动[^1]。 2. **权限问题**：容器内的数据目录或日志目录可能没有正确的权限设置，导致 MySQL 无法写入数据或日志文件[^4]。 3. **端口冲突**：如果主机上已有服务占用了 MySQL 默认的 3306 端口，容器中的 MySQL 服务将无法绑定到该端口并退出[^3]。 4. **环境变量缺失或错误**：启动容器时未正确设置必要的环境变量（如 `MYSQL_ROOT_PASSWORD`），可能导致初始化失败[^2]。 5. **MySQL 配置参数问题**：某些特定的 MySQL 配置参数（如 `skip-name-resolve` 或 `bind-address`）可能限制了外部连接[^5]。 --- ### 解决方案 以下是排查和解决问题的具体方法： #### 1. 检查容器状态 使用 `docker ps -a` 查看所有容器的状态。如果 MySQL 容器的状态为 `Exited (1)`，说明容器启动失败[^4]。 ```bash docker ps -a ``` #### 2. 查看容器启动日志 通过 `docker logs <container_id>` 查看容器的启动日志，定位具体的错误信息[^1]。 ```bash docker logs <container_id> ``` #### 3. 验证配置文件 如果挂载了自定义的 `my.cnf` 文件，请确保其内容无误。常见的错误包括： - 配置项拼写错误。 - 使用了不支持的参数。 - 文件路径错误或权限不足。 示例 `my.cnf` 文件内容： ```ini [mysqld] character-set-server=utf8mb4 collation-server=utf8mb4_unicode_ci skip-host-cache skip-name-resolve performance_schema_max_table_instances=400 table_definition_cache=400 table_open_cache=256 performance_schema=off ``` 确保文件路径正确，并赋予适当的权限： ```bash chmod 644 /path/to/my.cnf ``` #### 4. 检查端口占用 确认主机上是否已有服务占用了 3306 端口。如果端口被占用，可以选择更改映射端口。 检查端口占用情况： ```bash netstat -tuln | grep 3306 ``` 修改 Docker 命令以使用其他端口： ```bash docker run -d --name mysql -e MYSQL_ROOT_PASSWORD=root -p 3307:3306 mysql:latest ``` #### 5. 设置正确的环境变量 确保在启动容器时设置了必要的环境变量，例如 `MYSQL_ROOT_PASSWORD` 和 `MYSQL_DATABASE`[^2]。 示例命令： ```bash docker run -d --name mysql -e MYSQL_ROOT_PASSWORD=root -v /home/docker/mysql/data:/var/lib/mysql -p 3306:3306 mysql:latest ``` #### 6. 检查 MySQL 配置参数 如果需要限制外部访问，可以检查 `bind-address` 参数是否正确设置为 `0.0.0.0` 或主机 IP 地址。 示例配置： ```ini [mysqld] bind-address = 0.0.0.0 ``` #### 7. 删除并重新创建容器 如果以上方法无效，可以删除现有容器和镜像，重新拉取镜像并启动容器[^4]。 删除容器： ```bash docker rm -f <container_id> ``` 删除镜像： ```bash docker rmi mysql:latest ``` 重新拉取并启动： ```bash docker pull mysql:latest docker run -d --name mysql -e MYSQL_ROOT_PASSWORD=root -p 3306:3306 mysql:latest ``` --- ### 总结 通过上述步骤，可以有效排查和解决 `docker ps` 不显示 MySQL 容器的问题。关键在于检查容器的日志输出、验证配置文件和环境变量的正确性，并确保主机端口未被占用。 ---