Takeout项目：MySQL容器数据库消失问题分析与解决

问题现象

在使用Takeout项目管理的MySQL/MariaDB容器时，突然发现数据库内容全部消失，连接后显示为全新安装状态。虽然Docker界面显示数据卷仍然存在且正确关联，但通过客户端工具连接时却看不到原有数据库。

根本原因

经过排查发现，这是由于本地环境中同时运行了两个MySQL服务实例导致的端口冲突：

1. Takeout项目通过Docker容器运行的MySQL服务（默认端口3306）
2. 通过Homebrew安装的MySQL服务（同样使用3306端口）

当brew服务自动启动后，优先占用了3306端口，导致客户端连接时实际访问的是本地新安装的MySQL实例而非容器中的数据库。

解决方案

停止本地MySQL服务即可恢复容器数据库访问：

brew services stop mysql@8.0

技术背景

1. 端口冲突原理：同一台机器上不能有两个服务同时监听同一个端口，后启动的服务会失败。但在这个案例中，容器网络使用桥接模式，使得本地服务和容器服务可以同时运行，但客户端默认连接的是本地服务。

2. Takeout项目特点：作为开发环境管理工具，Takeout使用Docker容器来隔离各种服务。MySQL容器通过数据卷持久化存储数据库文件，即使容器重启数据也不会丢失。

3. Homebrew服务管理：brew services可以管理后台服务，部分软件包安装后会设置为自动启动，这可能与容器化服务产生冲突。

预防措施

1. 检查服务运行状态：定期使用brew services list查看本地运行的服务
2. 端口占用检查：通过lsof -i :3306确认端口实际使用者
3. 服务依赖管理：对于必须同时使用的服务，可以配置不同端口
4. 容器网络配置：考虑使用host网络模式避免端口映射问题

经验总结

开发环境中同时使用容器化和本地安装的服务时，需要特别注意：

• 服务端口分配
• 启动顺序管理
• 网络访问路径 遇到数据库"消失"的情况时，首先应该检查实际连接的是哪个服务实例，而不是假定数据丢失。通过验证数据卷内容和检查服务运行状态，可以快速定位问题根源。